Sdílet prostřednictvím

Syntaxe hierarchie objektů (Transact-SQL)

platí pro:SQL Server

Parametr propertyname parametru sp_OAGetProperty a sp_OASetProperty parametr methodname podporující sp_OAMethod syntaxi hierarchie objektů podobnou syntaxi jazyka Microsoft Visual Basic. Při použití této speciální syntaxe mají tyto parametry následující obecný formulář.

Syntaxe

TraversedObject.PropertyOrMethod

Argumenty

TraversedObject

Objekt OLE v hierarchii pod objektem zadaným v uložené proceduře. Pomocí syntaxe jazyka Visual Basic můžete určit řadu kolekcí, vlastností objektů a metod, které vracejí objekty. Každý specifikátor objektu v řadě musí být oddělen tečkou (.).

Položka v řadě může být název kolekce. Pomocí této syntaxe zadejte kolekci:

Collection("item")

Dvojité uvozovky (") jsou povinné. Syntaxe vykřičníku! () jazyka Visual Basic pro kolekce není podporovaná.

PropertyOrMethod

Název vlastnosti nebo metody TraversedObject.

Chcete-li zadat všechny parametry indexu nebo metody uvnitř závorek (způsobuje všechny parametry indexu sp_OAGetPropertynebo metody , sp_OASetPropertynebo sp_OAMethod být ignorovány) použijte následující syntaxi:

PropertyOrMethod ( [ ParameterName := ] "parameter" [ , ... ] )

Dvojité uvozovky (") jsou povinné. Všechny pojmenované parametry musí být zadány po zadání všech pozičních parametrů.

Poznámky

Pokud není zadán objekt TraversedObject , je vyžadován PropertyOrMethod .

Pokud parametr PropertyOrMethod není zadán, vrátí se traversedObject jako výstupní parametr tokenu objektu z uložené procedury OLE Automation.

Pokud je zadán PropertyOrMethod , vlastnost nebo metoda TraversedObject je volána. Hodnota vlastnosti nebo návratová hodnota metody je vrácena jako výstupní parametr z uložené procedury OLE Automation.

Pokud některá položka v seznamu TraversedObject nevrací objekt OLE, vyvolá se chyba.

Další informace o syntaxi objektu OLE jazyka Visual Basic naleznete v dokumentaci jazyka Visual Basic.

Další informace o HRESULT návratových kódech najdete v tématu sp_OACreate.

Příklady

Následují příklady syntaxe hierarchie objektů, které používají objekt SQL-DMO SQLServer.

-- 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;

Související obsah

  • Last updated on