Udostępnij za pośrednictwem

  • Artykuł

Obiekt hierarchii składni języka Transact-SQL)

The propertyname parameter of sp_OAGetProperty and sp_OASetProperty and the methodname parameter of sp_OAMethod support an object hierarchy syntax that is similar to that of Microsoft Visual Basic.Użyto następującej specjalnej składni tych parametrów ma następującą postać ogólne.

'TraversedObject.PropertyOrMethod'

Argumenty

  • TraversedObject
    Jest to obiekt OLE w hierarchii pod objecttoken określony w procedura przechowywana. Użycie Visual Basic Składnia do określenia serii kolekcje, właściwości i metody zwracające obiektów. Specyfikator każdego obiektu w serii muszą być oddzielone (okresu**.** ).

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

    Kolekcja)"item")

    (Podwójny cudzysłów**") są wymagane.The Visual Basic exclamation point (!**) syntax for collections is not supported.

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

    Aby określić wszystkie parametry indeksu lub metoda przy użyciu sp_OAGetProperty, sp_OASetProperty, or sp_OAMethod parametry (w tym obsługę 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 (co powoduje, że wszystkie parametry indeksu lub metoda z sp_OAGetProperty, sp_OASetProperty, or sp_OAMethod jest pomijany) należy użyć następującej składni:

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

    (Podwójny cudzysłów**"**) są wymagane.Po określono wszystkich parametrów pozycyjne, należy określić wszystkie parametry nazwane.

Remarks

Jeśli TraversedObject nie określono, PropertyOrMethod jest wymagany.

Jeśli PropertyOrMethod nie jest określony, TraversedObject są zwracane jako parametru wyjściowego tokenu obiektu z automatyzacji OLE przechowywane procedury. Jeśli PropertyOrMethod jest określony, właściwość lub metoda TraversedObject nosi nazwę, a procedura przechowywana wartość właściwość lub metoda, zwrócona wartość jest zwracana jako parametru wyjściowego z automatyzacji OLE.

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

Aby uzyskać więcej informacji na temat Visual Basic Składnia obiekt OLE, zobacz temat Visual Basic dokumentację.

Aby uzyskać więcej informacji na temat Kody zwracanych wartości HRESULT zobacz sp_OACreate (języka Transact-SQL).

Przykłady

Poniżej przedstawiono przykłady składni obiektu w hierarchii za pomocą SQL-DMO SQLServer obiektu.

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

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

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