sp_OAMethod (Transact-SQL)

ole nesnesinin bir yöntem çağırır.

Transact-SQL sözdizimi 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öntem çağırmak için ole nesnesinin adıdır.

• returnvalue ÇIKIŞ
  ole nesnesinin yöntem dönüş değeridir.Belirtilmişse, uygun veri türünde bir yerel değişken olmalıdır.

  yöntem tek bir değer döndürürse, ya da yerel bir değişken için belirtmek returnvalue, yerel değişken değeri döndürebilir veya belirtme yöntem döndürür returnvalue, hangi verir yöntem dönüş değeri istemci bir teksütun, tek satır sonuç kümesi.

  yöntem değerdir bir ole nesnesi dönerseniz returnvalue 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.

  Ne zaman yöntem dönüş değeri olan bir dizi, returnvalue belirtilen, onu küme için null.

  Aşağıdakilerden herhangi biri oluştuğunda bir hata ortaya çıkar:

  • returnvalueBelirtilen, ancak yöntem bir değer döndürmez.

  • yöntem birden fazla iki boyutlu bir dizi döndürür.

  • yöntem bir çıkış parametresi bir dizi döndürür.

• [ @parametername**=** parameterOUTPUT
  yöntem parametredir.Belirtilmişse, parameterolması gereken değeri, uygun veri türü.

  Bir çıktı parametresini mi, dönüş değerini elde etmek için parameter uygun veri türünde bir yerel değişken olmalıdır ve Çıkış belirtilmelidir.sabit bir parametre belirtilmemişse veya Çıkış belirtilmezse, tüm dönmek bir çıkış parametresi değeri göz ardı edilir.

  Belirtilmişse, parametername adı olmalıdır Microsoft Visual Basic adlı parametre.Unutmayın @*parametername *değil bir Transact-SQL yerel değişken.At işareti (@**) kaldırılır ve parametername* *ole nesnesini parametre olarak geçirilir.Belirtilen tüm konumsal Parametreler sonra tüm adlandırılmış parametreleri belirtilmelidir.

• n
  Yer tutucu birden çok parametre belirtilebilir gösteren.

  Not

  @parameternameadlandırılmış bir parametre, belirtilen yöntem bir parçası olduğundan ve aracılığıyla nesneye iletilir olabilir.Bu saklı yordam için diğer 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 ole Otomasyon dönüş kodları ve hata bilgileri.

Sonuç Kümeleri

yöntem değeri bir veya iki boyutlu bir dizi dönüş, 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ütunlar) 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.Bir yöntemçağırmak

Aşağıdaki örnek çağrıları Connect yöntem , ö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

B.özellikalma

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

Ayrıca bkz.

Başvuru

ole Otomasyon yordamlar (Transact-SQL) saklı

ole Otomasyon Örneği komut dosyası