sp_OAGetProperty (Transact-sql)

Makale
10/29/2012

Özellik değeri bir ole nesnesi alır.

Konu bağlantısı simgesi Transact-SQL Sözdizim 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 özelliği adıdır.
propertyvalueÇIKIŞ
Döndürülen özelliği değeridir. Belirtilirse, yerel bir değişken uygun veri türü olmalıdır.

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

Özelliği tek bir değer döndürürse, ya da yerel bir değişken belirtmek propertyvalue, hangi yerel değişken; özellik değerini döndürür veya değil propertyvalue, istemciye tek sütun, tek satır sonuç kümesi olarak özellik değerini döndürür.

Ne zaman özellik bir dizi döndürür, eğer propertyvaluebelirtilirse, null olarak ayarlanmışsa.

Eğer propertyvaluebelirtilen halde özelliğin değeri, hata oluşur. Özellik fazla iki boyutlu bir dizi döndürür, hata oluşur.
index
Bir dizin parametresidir. Belirtilmişse, indexuygun veri türünde bir değer olmalı.

Bazı özelliklerinin parametrelere sahiptir. Bu özellikler dizinlenmiş özellikleri denir ve parametreleri dizin parametreleri olarak adlandırılır. Bir özelliği, 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 sıfır olmayan bir sayı (hata) ole Otomasyon nesne tarafından döndürülen hresult tamsayı değeridir.

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 istemciye sonuç olarak kümesi döndürülür:

Gibi birçok sütun olarak orada dizideki öğelerin ile bir tek satır sonuç kümesi olarak tek boyutlu bir dizi istemciye döndürülür. Diğer bir deyişle, dizi sütun olarak döndürülür.
İki boyutlu bir dizi ile çok sayıda sütun olarak orada elemanları ile orada öğeleri dizinin ikinci boyutu kadar satır ve dizinin ilk boyut olarak'ın sonuç olarak ayarlamak istemciye döndürülür. Diğer bir deyişle, dizi (sütun, satır) döndürülür.

Ne zaman dönüş değeri bir özelliği veya yöntemi dönüş değeri bir dizi ise sp_OAGetProperty veya sp_OAMethod bir sonuç kümesi istemciye döndürür. (Yöntem çıkış parametreleri dizi olamaz.) Bu yordamları uygun belirlemek için dizideki tüm veri değerleri tarama SQL Serversonuç kümesinde her sütun için veri türleri ve veri uzunlukları. Belirli bir sütun için veri türü ve uzunluğu bu sütundaki tüm veri değerleri temsil etmek için gerekli bu yordamları kullanın.

Tüm veri değerleri bir sütunda aynı veri türü paylaştığınızda, tüm sütun veri türü kullanılır. Zaman veri değerleri bir sütun farklı veri türleri, tüm 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ğerini almak için.

İzinler

Üyelik sysadmin sunucu rolü.

Örnekler

A.Değişken kullanma

Aşağıdaki örnek alır HostNameözelliği (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

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ümesi kullanma

Aşağıdaki örnek alır HostNameözelliği (daha önce oluşturulmuş, SQLServer nesnesi) ve koymak o-e doğru istemciye sonuç olarak döndürür.

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

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

Ayrıca bkz.

Başvuru

ole Otomasyon depolanan yordamlar (Transact-sql)

ole Otomasyon Örneği Komut dosyası

Share via