Obiekt hierarchii składni (Transact-SQL)

propertyname Parametr sp_OAGetProperty i sp_OASetProperty i methodname parametr sp_OAMethod obsługują składnię hierarchii obiektu, który jest podobny do Microsoft Visual Basic.W przypadku tej specjalnej składni tych parametrów mają następujące ogólne formularza.

Składnia

'TraversedObject.PropertyOrMethod'

Argumenty

  • TraversedObject
    Jest obiekt OLE w hierarchii pod objecttoken określone w procedura składowana.Użycie Visual Basic składni, aby określić serię kolekcje, właściwości obiektu i metod, które zwracają obiekty.Specyfikator każdego obiektu w serii muszą być oddzielone kropką (.).

    element w serii może być nazwa kolekcja.Aby określić kolekcja, należy użyć następującej składni:

    Kolekcja ("item")

    Podwójny cudzysłów (") są wymagane.Visual Basic Wykrzyknik (!) składnia dla kolekcji nie jest obsługiwana.

  • PropertyOrMethod
    Jest nazwą właściwość lub metoda TraversedObject.

    Aby określić wszystkie parametry indeksu lub metoda za pomocą sp_OAGetProperty, sp_OASetProperty, lub sp_OAMethod Parametry (włączając w to wsparcie dla sp_OAMethod Parametry wyjściowe), należy użyć następującej składni:

    PropertyOrMethod

    Aby określić wszystkie parametry indeksu lub metoda wewnątrz nawiasów (powodując wszystkie parametry indeksu lub metoda z sp_OAGetProperty, sp_OASetProperty, lub sp_OAMethod będzie pomijany) należy użyć następującej składni:

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

    Podwójny cudzysłów (") są wymagane.Wszystkie nazwane parametry muszą być określone po wszystkich parametrów pozycyjne są określone.

Uwagi

Jeśli TraversedObject nie jest określony, PropertyOrMethod jest wymagana.

Jeśli PropertyOrMethod nie jest określony, TraversedObject są zwracane jako parametr wyjściowy tokenu obiektu z automatyzacji OLE procedura składowana.Jeśli PropertyOrMethod jest określona właściwość lub metoda TraversedObject jest nazywany i wartość właściwość lub metoda zwrócona wartość jest zwracana jako parametr wyjściowy z automatyzacji OLE procedura składowana.

Jeśli dowolny element w TraversedObject listy nie zwraca obiekt OLE, spowodował błąd.

Aby uzyskać więcej informacji o Visual Basic składnię obiektów OLE, zobacz Visual Basic dokumentacji.

Aby uzyskać więcej informacji na temat kody powrotne HRESULT zobacz sp_OACreate (języka Transact-SQL).

Przykłady

Poniżej podano przykłady składnię hierarchii obiektów, które używają SQL- DMO SQLServer obiektu.

-- Get the AdventureWorks2008R2 Person.Address Table object.
EXEC @hr = sp_OAGetProperty @object,
   'Databases("AdventureWorks2008R2").Tables("Person.Address")',
   @table OUT

-- Get the Rows property of the AdventureWorks2008R2 Person.Address table.
EXEC @hr = sp_OAGetProperty @object,
   'Databases("AdventureWorks2008R2").Tables("Person.Address").Rows',
   @rows OUT

-- Call the CheckTable method to validate the 
-- AdventureWorks2008R2 Person.Address table.
EXEC @hr = sp_OAMethod @object,
   'Databases("AdventureWorks2008R2").Tables("Person.Address").CheckTable',
   @checkoutput OUT