sp_OAGetProperty (Transact-SQL)
Bir OLE nesnesinin bir özellik değeri alır.
.gif "Topic link icon")
sp_OAGetProperty objecttoken , propertyname
[ , propertyvalue OUTPUT ]
[ , index...]
Bağımsız değişkenler
objecttoken
Nesne simge kullanarak daha önce oluşturulan bir OLE nesnesinin 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, bu uygun veri türünü, yerel bir değişken olmalıdır.Bu özellik bir OLE nesnesi döndürür. propertyvalue bir yerel değişken veri türünde olmalıdır int. Bir nesne simge, yerel değişken olarak depolanır ve bu nesneyi bir simge ile diğer depolanan Otomasyonu yordamlar kullanılabilir.
Özelliği, tek bir değer döndürürse, ya da yerel bir değişken belirtin propertyvalue, özelliği değerini döndürür; yerel değişken değeri veya değil belirtme propertyvalue, hangi özelliğinin değeri istemciye geri tek sütunlu, tek satırlık bir sonucu olarak gönderir küme.
Ne zaman özellik bir dizi verir propertyvalue , NULL olarak küme belirtildi.
If propertyvalue belirtildi, ancak bu özelliğin değeri, hata oluşur döndürmüyor. özellik iki boyutlu bir dizi döndürür, hata oluşur.
index
Bir dizin parametresi olarak belirtilir.Belirtilmişse, indexuygun veri türünü, bir değer olmalıdır.Bazı özellikler parametrelere sahiptir.Bu özellikler, dizinlenmiş özelliklerin denir ve parametreleri, dizin Parametreler 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).
Yanıt HRESULT kodları hakkında daha fazla bilgi için bkz: OLE Otomasyonu dönüş kodları ve hata bilgileri.
Sonuç Kümeleri
özellik bir veya iki boyutlu bir dizi döndürür, dizinin istemciye sonuç olarak döndürülen küme:
Tek boyutlu BIR dizi tek satırlık bir sonucu olarak istemciye döndürülen küme dizideki öğelerin kadar çok sütun.Baþka bir deyiþle, dizi, sütun olarak döndürülür.
Iki boyutlu BIR dizi sonuç olarak istemciye döndürülen küme kadar öğeleri boyutun ikinci dizi öğelerini kadar satır ve dizinin ilk boyutunun çok sütunlu.Diğer bir deyişle, dizinin (sütun, satır) olarak döndürülür.
Bir özellik dönüş değeri veya yönteminin dönüş değeri, dizesi biçimindedir. sp_OAGetProperty or sp_OAMethod bir sonuç döndüreceği için küme istemcisine.(Yöntem çıkış parametreleri dizi olamaz.) Bu yordamlar, uygun olarak belirlemek için dizideki tüm veri değerleri TaraSQL Server veri türleri ve veri uzunluğu sonuç her sütun için ayarlayın. Bu yordamlar, belirli bir sütun için o sütundaki tüm verileri göstermek için gerekli uzunluk ve veri türünü kullanın.
Bu veri türü, bir sütundaki tüm veri değerleri, aynı veri türünde paylaştırdığınız zaman, tüm sütun için kullanılır.Bir sütundaki veri değerlerinin farklı veri türleri, tüm sütun veri türü temel alınarak 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 |
Remarks
Ayrıca sp_OAMethod bir özellik değeri alınamadı.
İzinler
Üyelik gerektirir sysadmin sabit sunucu rolü.
Örnekler
C.Bir yerel değişken kullanma.
Aşağıdaki örnek alır HostName özellik (daha önce oluşturulmuş SQL Server 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ç kullanarak küme
Aşağıdaki örnek alır HostName özellik (daha önce oluşturulmuş SQL Server nesnesi) ve sonuç olarak ayarlamak, istemciye döndürür.
EXEC @hr = sp_OAGetProperty @object, 'HostName'
IF @hr <> 0
BEGIN
EXEC sp_OAGetErrorInfo @object
RETURN
END
See Also