Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:SQL Server
De parameter propertyname van sp_OAGetProperty en sp_OASetProperty de parameter methodname van ondersteuning voor sp_OAMethod een objecthiërarchiesyntaxis die vergelijkbaar is met die van Microsoft Visual Basic. Wanneer deze speciale syntaxis wordt gebruikt, hebben deze parameters de volgende algemene vorm.
Syntaxis
TraversedObject.PropertyOrMethod
Argumenten
TraversedObject
Een OLE-object in de hiërarchie onder het objecttoken dat is opgegeven in de opgeslagen procedure. Gebruik de syntaxis van Visual Basic om een reeks verzamelingen, objecteigenschappen en methoden op te geven die objecten retourneren. Elke objectaanduiding in de reeks moet worden gescheiden door een punt (.).
Een item in de reeks kan de naam van een verzameling zijn. Gebruik deze syntaxis om een verzameling op te geven:
Collection("item")
De dubbele aanhalingstekens (") zijn vereist. De syntaxis van het Visual Basic-uitroepteken (!) voor verzamelingen wordt niet ondersteund.
PropertyOrMethod
De naam van een eigenschap of methode van het TraversedObject.
Gebruik de volgende syntaxis om alle index- of methodeparameters tussen de haakjes op te geven (waardoor alle index- of methodeparameters van sp_OAGetProperty, sp_OASetPropertyof sp_OAMethod worden genegeerd):
PropertyOrMethod ( [ ParameterName := ] "parameter" [ , ... ] )
De dubbele aanhalingstekens (") zijn vereist. Alle benoemde parameters moeten worden opgegeven nadat alle positionele parameters zijn opgegeven.
Opmerkingen
Als TraversedObject niet is opgegeven, is PropertyOrMethod vereist.
Als PropertyOrMethod niet is opgegeven, wordt het TraversedObject geretourneerd als een objecttokenuitvoerparameter van de opgeslagen OLE Automation-procedure.
Als PropertyOrMethod is opgegeven, wordt de eigenschap of methode van het TraversedObject aangeroepen. De eigenschapswaarde of de retourwaarde van de methode wordt geretourneerd als een uitvoerparameter van de opgeslagen OLE Automation-procedure.
Als een item in de lijst TraversedObject geen OLE-object retourneert, wordt er een fout gegenereerd.
Zie de Visual Basic-documentatie voor meer informatie over de syntaxis van het OLE-object van Visual Basic.
Zie sp_OACreate voor meer informatie over HRESULT retourcodes.
Voorbeelden
Hier volgen voorbeelden van de syntaxis van de objecthiërarchie die gebruikmaakt van een SQL-DMO SQLServer-object.
-- Get the AdventureWorks2022 Person.Address Table object.
EXECUTE @hr = sp_OAGetProperty @object,
'Databases("AdventureWorks2022").Tables("Person.Address")',
@table OUTPUT;
-- Get the Rows property of the AdventureWorks2022 Person.Address table.
EXECUTE @hr = sp_OAGetProperty @object,
'Databases("AdventureWorks2022").Tables("Person.Address").Rows',
@rows OUTPUT;
-- Call the CheckTable method to validate the
-- AdventureWorks2022 Person.Address table.
EXECUTE @hr = sp_OAMethod @object,
'Databases("AdventureWorks2022").Tables("Person.Address").CheckTable',
@checkoutput OUTPUT;