Object Hierarchy Syntax (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. When this special syntax is used, these parameters have the following general form.

Syntax

'TraversedObject.PropertyOrMethod'

Arguments

  • TraversedObject
    Is an OLE object in the hierarchy under the objecttoken specified in the stored procedure. Use Visual Basic syntax to specify a series of collections, object properties, and methods that return objects. Each object specifier in the series must be separated by a period (.).

    An item in the series can be the name of a collection. Use this syntax to specify a collection:

    Collection("item")

    The double quotation marks (") are required. The Visual Basic exclamation point (!) syntax for collections is not supported.

  • PropertyOrMethod
    Is the name of a property or method of the TraversedObject.

    To specify all index or method parameters by using sp_OAGetProperty, sp_OASetProperty, or sp_OAMethod parameters (including support for sp_OAMethod output parameters), use the following syntax:

    PropertyOrMethod

    To specify all index or method parameters inside the parentheses (causing all index or method parameters of sp_OAGetProperty, sp_OASetProperty, or sp_OAMethod to be ignored) use the following syntax:

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

    The double quotation marks (") are required. All named parameters must be specified after all positional parameters are specified.

Remarks

If TraversedObject is not specified, PropertyOrMethod is required.

If PropertyOrMethod is not specified, the TraversedObject is returned as an object token output parameter from the OLE Automation stored procedure. If PropertyOrMethod is specified, the property or method of the TraversedObject is called, and the property value or method return value is returned as an output parameter from the OLE Automation stored procedure.

If any item in the TraversedObject list does not return an OLE object, an error is raised.

For more information about Visual Basic OLE object syntax, see the Visual Basic documentation.

For more information about HRESULT Return Codes, see sp_OACreate (Transact-SQL).

Examples

The following are examples of object hierarchy syntax that use a SQL-DMO SQLServer object.

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

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

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

See Also

Reference

OLE Automation Sample Script

OLE Automation Stored Procedures (Transact-SQL)