sp_OAGetProperty (Transact-SQL)

ole nesnesinin bir özellik değerini alır.

Transact-SQL sözdizimi kuralları

Sözdizimi

sp_OAGetProperty objecttoken , propertyname 
    [ , propertyvalue OUTPUT ]
    [ , index...] 

Bağımsız değişkenler

• objecttoken
  Kullanarak daha önce oluşturulan bir ole nesnesi nesne belirteci iş sp_OACreate.

• propertyname
  ole nesnesini döndürmek için özellik adıdır.

• propertyvalueÇIKIŞ
  Döndürülen özellik değerdir.Belirtilmişse, uygun veri türünde bir yerel değişken olmalıdır.

  özellik bir ole nesnesi döndürürse propertyvalue olması gereken veri türünde bir yerel değişken int.Bir nesne belirteci yerel değişkende saklanır ve bu nesne belirteci diğer saklanan Otomasyonu yordamları ile kullanılabilir.

  ' % S'özelliği özellik tek bir değer döndürürse, ya da yerel bir değişken için belirtmek propertyvalue, yerel bir değişken; özellik değeri döndürür veya belirtme propertyvalue, hangi özellik değerini verir istemci bir teksütun, tek satır sonuç kümesi.

  Ne zaman özellik döndürür bir dizi, propertyvalue belirtilen, onu küme için null.

  propertyvalue Belirtilir, ancak özellik değeri, bir hata oluşur döndürmez.özellik birden fazla iki boyutlu bir dizi döndürür, hata oluşur.

• index
  Bir dizin parametresidir.Belirtilmişse, indexolması gereken değeri, uygun veri türü.

  Bazı özellikler parametrelere sahiptir.Bu özellikler, dizinlenmiş özellikleri denir ve dizin parametreleri parametreleri denir.Bir özellik , birden çok dizin parametreleri olabilir.

  Not

  Bu saklı yordam parametreleri konuma göre değil adı belirtilmedi.

Dönüş Kodu Değerleri

0 (başarılı) veya ole Otomasyon nesne tarafından döndürülen hresult tamsayı değeri sıfır olmayan bir sayı (hata).

hresult yanıt kodları hakkında daha fazla bilgi için bkz: ole Otomasyon dönüş kodları ve hata bilgileri.

Sonuç Kümeleri

özellik bir veya iki boyutlu bir dizi döndürür, dizi bir sonuç kümesiolarak istemci döndürülür:

• Tek boyutlu bir dizi, istemci , bir tek satır sonuç kümesi dizideki öğeleri gibi çok sayıda sütun olarak döndürülür.Başka bir deyişle, dizi sütun olarak döndürülür.

• İlk boyut dizisinin ile ikinci boyut dizinin öğeleri gibi kadar satır öğeleri olarak orada birçok sütun gibi bir sonuç kümesi ile olarak istemci iki boyutlu bir dizi döndürülür.Başka bir deyişle, dizi (sütunlar, satırlar) döndürülür.

Ne zaman dönüş değeri bir özellik veya yöntem dönüş değeri bir dizi olması sp_OAGetProperty veya sp_OAMethod bir sonuç kümesi için istemciverir.(Yöntem çıkış parametreleri dizi olamaz.) Aşağıdaki yordamlardan uygun belirlemek için dizideki tüm veri değerleri tarama SQL Server sonuç kümesiher sütun için veri türleri ve veri uzunlukları.Belirli bir sütuniçin veri türü ve uzunluğu o sütuniçin tüm veri değerleri temsil etmek için gerekli bu yordamları kullanın.

Tüm veri değerleri sütun aynı veri türünde paylaştığınızda, tüm sütuniçin veri türü kullanılır.Veri değerleri bir sütun farklı veri türlerindeki olduğunda, tamamını sütun veri türüne göre aşağıdaki grafikte seçilir.

	Int	float	Money	datetime	varchar	nvarchar
int	int	float	money	varchar	varchar	nvarchar
float	float	float	money	varchar	varchar	nvarchar
money	money	money	money	varchar	varchar	nvarchar
datetime	varchar	varchar	varchar	datetime	varchar	nvarchar
varchar	varchar	varchar	varchar	varchar	varchar	nvarchar
nvarchar	nvarchar	nvarchar	nvarchar	nvarchar	nvarchar	nvarchar

Açıklamalar

Ayrıca sp_OAMethod özellik değeri alınamıyor.

İzinler

Üyelik gerektiren sysadmin sabit sunucu rolü.

Örnekler

A.Yerel bir değişken kullanarak

Aşağıdaki örnek alır HostName özellik (daha önce oluşturulmuş, SQLServer nesnesi) ve bir yerel değişkende depolar.

DECLARE @property varchar(255)
EXEC @hr = sp_OAGetProperty @object, 'HostName', @property OUT
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END
PRINT @property

B.Bir sonuç kümesikullanma

Aşağıdaki örnek alır HostName özellik (daha önce oluşturulmuş, SQLServer nesnesi) ve istemci bir sonuç kümesiolarak döndürür.

EXEC @hr = sp_OAGetProperty @object, 'HostName'
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END

Ayrıca bkz.

Başvuru

ole Otomasyon yordamlar (Transact-SQL) saklı

ole Otomasyon Örneği komut dosyası