sp_OAMethod (Transact-sql)

Makale
10/29/2012

Bir ole nesnesinin bir yöntemini çağırır.

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

sp_OAMethod objecttoken , methodname
    [ , returnvalue OUTPUT ] 
    [ , [ @parametername = ] parameter [ OUTPUT ] [ ...n ] ]

Bağımsız değişkenler

objecttoken
Kullanarak daha önce oluşturulan bir ole nesnesi nesne belirteci iş sp_OACreate.
methodname
Yöntemi çağırmak için ole nesnesinin adıdır.
returnvalue ÇIKIŞ
ole nesnesinin yöntemine dönüş değeridir. Belirtilirse, yerel bir değişken uygun veri türü olmalıdır.

Yöntem tek bir değer döndürürse, ya da yerel bir değişken belirtmek returnvalue, hangi yöntem döndürür ya da dönüş değeri yerel değişken değil belirtmek returnvalue, istemciye tek sütun, tek satır sonuç kümesi olarak yöntem dönüş değeri döndürür.

Yöntem dönüş değeri olan bir ole nesnesi, returnvaluebir yerel 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.

Ne zaman yöntem dönüş değeri bir dizi Eğer returnvaluebelirtilirse, null olarak ayarlanmışsa.

Aşağıdakilerden herhangi biri oluştuğunda bir hata ortaya çıkar:
- returnvalueBelirtilen, ancak yöntemi bir değer döndürmez.
- Yöntem birden fazla iki boyutlu bir dizi döndürür.
- Yöntem, bir çıkış parametresi olarak bir dizi döndürür.
@parametername**=** parameterOUTPUT
Yöntem parametredir. Belirtilmişse, parameteruygun veri türünde bir değer olmalı.

Output parametresi, dönüş değeri elde etmek için parameteruygun veri türünde bir yerel değişken olmalıdır ve Çıkış belirtilmelidir. Sürekli parametresi belirtilirse, ya da eğer Çıkış parametresi belirtilmezse, geri bir çıkış parametresi değeri göz ardı edilir.

Belirtilmişse, parameternameadı olmalıdır Microsoft Visual Basicparametre adlı. Not @parameternamedeğil bir Transact-SQLYerel değişken. At işareti (@) kaldırılır, ve parametername * * ole nesnesini parametre olarak geçirilir. Sonra tüm konumsal parametreler belirtilen tüm adlandırılmış parametreleri belirtilmelidir.
n
Yer tutucu birden çok parametre belirtilebilir gösteren.

[!NOT]

@parameternameBelirtilen yöntem bir parçası olduğundan ve nesne üzerinden geçirilir, adlandırılmış bir parametre olabilir. Diğer 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 ole Otomasyon dönüş kodları ve hata bilgileri.

Sonuç Kümeleri

Yöntem dönüş değeri bir veya iki boyutlu bir dizi olduğunu 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ütunlar) 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.Yöntem çağırma

Aşağıdaki örnek çağrıları Connectyöntemi, önceden oluşturulmuş SQLServer nesne.

EXEC @hr = sp_OAMethod @object, 'Connect', NULL, 'my_server',
    'my_login', 'my_password'
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END

EXEC @hr = sp_OAMethod @object, 'Connect', NULL, 'my_server',
    'my_login', 'my_password'
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END

B.Özellik alma

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_OAMethod @object, 'HostName', @property OUT
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END
PRINT @property

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

Ayrıca bkz.

Başvuru

ole Otomasyon depolanan yordamlar (Transact-sql)

ole Otomasyon Örneği Komut dosyası

Aracılığıyla paylaş