Bagikan melalui

Sintaks hierarki objek (Transact-SQL)

  • Artikel

Berlaku untuk: SQL Server

Parameter sp_OAGetProperty nama properti dan sp_OASetProperty dan parameter sp_OAMethod methodname mendukung sintaks hierarki objek yang mirip dengan Microsoft Visual Basic. Ketika sintaks khusus ini digunakan, parameter ini memiliki bentuk umum berikut.

Sintaks

TraversedObject.PropertyOrMethod

Argumen

TraversedObject

Objek OLE dalam hierarki di bawah objecttoken yang ditentukan dalam prosedur tersimpan. Gunakan sintaks Visual Basic untuk menentukan serangkaian koleksi, properti objek, dan metode yang mengembalikan objek. Setiap penentu objek dalam seri harus dipisahkan oleh titik (.).

Item dalam seri dapat menjadi nama koleksi. Gunakan sintaks ini untuk menentukan koleksi:

Collection("item")

Tanda kutip ganda (") diperlukan. Sintaks titik seru Visual Basic (!) untuk koleksi tidak didukung.

PropertyOrMethod

Nama properti atau metode TraversedObject.

Untuk menentukan semua parameter indeks atau metode di dalam tanda kurung (menyebabkan semua parameter sp_OAGetPropertyindeks atau metode , , sp_OASetPropertyatau sp_OAMethod diabaikan) gunakan sintaks berikut:

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

Tanda kutip ganda (") diperlukan. Semua parameter bernama harus ditentukan setelah semua parameter posisi ditentukan.

Keterangan

Jika TraversedObject tidak ditentukan, PropertyOrMethod diperlukan.

Jika PropertyOrMethod tidak ditentukan, TraversedObject dikembalikan sebagai parameter output token objek dari prosedur tersimpan OLE Automation.

Jika PropertyOrMethod ditentukan, properti atau metode TraversedObject dipanggil. Nilai properti atau nilai pengembalian metode dikembalikan sebagai parameter output dari prosedur tersimpan OLE Automation.

Jika ada item dalam daftar TraversedObject yang tidak mengembalikan objek OLE, kesalahan akan muncul.

Untuk informasi selengkapnya tentang sintaks objek Visual Basic OLE, lihat dokumentasi Visual Basic.

Untuk informasi selengkapnya tentang HRESULT kode pengembalian, lihat sp_OACreate.

Contoh

Berikut ini adalah contoh sintaks hierarki objek yang menggunakan objek SQL-DMO SQLServer.

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

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

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

Konten terkait