soap isteği iletisi yapısı
Bu özellik Microsoft SQL Server'ın ilerideki bir sürümünde kaldırılacaktır. Yeni geliştirme işlerinde bu özelliği kullanmaktan kaçının ve bu özelliği kullanmakta olan uygulamalarda değişiklik yapmayı planlayın.
Sizin soap isterseniz istemci tarafından sağlanan proxy sınıfları kullanmak yerine, kendi soap istekleri oluşturmak için Visual Studio 2005, kullanmanız gerekir aşağıdaki ileti biçimleri.
Saklı yordamlar ve kullanıcı tanımlı türler için soap isteği ileti biçimi
Tipik bir örneği olarak gönderilen soap isteği aşağıdaki örnek gösterir SQL Server.soap iletisindeki GetCustomerInfo istenen operasyon.Not yalnızca http başlığının bir parçası gösterilmiştir.
POST /url HTTP/1.1
Host: HostServerName
Content-type: text/xml; charset=utf-8
Content-length: 350
SoapAction: http://tempUri.org/GetCustomerInfo
...
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope
xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<GetCustomerInfo xmlns="http://tempUri.org/">
<CustomerID>1</CustomerID>
<OutputParam />
</GetCustomerInfo>
</soap:Body>
</soap:Envelope>
http üstbilgisi
Önceki kodda, değeri SoapAction http üstbilgi alan adıdır yöntem öncesinde tarafından kendi ad alan.Bu değer aynı yöntem kullanılarak oluşturulan bitiş noktasına eklenen ad alanı ise Bitiş noktası oluşturmak.Bu isteğe bağlı bir alan olduğuna dikkat edin.The Host HTTP header field identifies the server to which the HTTP request is sent.
<SOAP Zarfı:> öğesi
soap isteği ayrıntılarını dahil <Body> öğesi soap Zarfı.Önceki örneği istekleri GetCustomerInfo yöntem.The xmlns attribute in <GetCustomerInfo> is the same namespace that is specified for this method you created the endpoint by using CREATE ENDPOINT.Saklı yordam ve ad alanı hakkında daha fazla bilgi için bkz: Yerel xml Web Hizmetleri istekleri göndermek için örnek uygulamalar.Aşağıdaki yöntem parametreleri alt öğelerini geçilen <GetCustomerInfo> öğesi:
The <CustomerID> element that has value 1 is the input parameter
The <OutputParam> element is the output parameter.
Giriş parametresi işleme
Giriş parametreleri aşağıdaki şekillerde yönetilir:
soap yöntem bir girdi parametresini gerektirir ve bu parametre soap isteği dahil, hiçbir değer geçirilen adlı için saklı yordam.Tanımlanan varsayılan eylem saklı yordam oluşur.
soap yöntem bir girdi parametresini gerektirir ve bu parametre isteğinde ancak herhangi bir değer atanır, parametre için geçirilen saklı yordam ile boş bir dize değeri olarak.BOŞ olmadığını göz önünde bulundurun.
soap işlem bir girdi parametresini gerektirir ve bu parametresi için null değerini göndermek istiyorsanız, yapmanız gerekenler küme bir xsi:nil öznitelik için "true" soap isteği.Örneğin:
<GetCustomerInfo xmlns="http://tempUri.org/" > <CustomerID xsi:nil="true" /> <OutputParam /> </GetCustomerInfo>De Visual Studio 2005, dize değişkenleri için null değerleri geçirdiğinizde bu oluşturur xsi: nil = "true" soap istek öznitelik.Ancak ne zaman geçirmek parametreleri türleri için null değerleri gibi integer ve float (değer türleri), Visual Studio 2005 üretmek xsi: nil = "true" öznitelik; Bunun yerine, bu parametreler için varsayılan değerleri sağlar; Örneğin, 0 tamsayý türleri için 0.0 float türleri, böyle devam eder.Bu tür parametreleri için null değerleri geçirmek istiyorsanız, bu nedenle, soap iletisi uygulamanızda kullanarak oluşturmalısınız xsi: nil = "true" öznitelik.Daha fazla bilgi için bkz. Yönergeleri ve yerel xml Web Hizmetleri'ndeki kısıtlamaları
Parametreler üzerinde çeşitli özellikleri sağlar.Bu konunun ilerleyen bölümlerinde gösterilen tablo ad hoc sql sorguları istediğinde, belirleyebileceğiniz çeşitli özellikleri listeler.Bu tablo, belirlediğiniz için tüm özellikleri bir <değeri> rpc yöntem parametre düğüm. düğüm belirtilebilir
Ad Hoc sql sorguları isterken, soap isteği ileti biçimi
Ad hoc sql sorgu yürütme için soap isteği gönderdiğinizde, çağırması gerekir sqlbatch yöntem ve sorgular ve hangi Parametreler gerekli olabilir.
Aşağıdaki örnek http soap isteği çağrıları sqlbatch yöntem.Not yalnızca http başlığının bir parçası gösterilmiştir.
POST /url HTTP/1.1
Host: HostServerName
Content-type: text/xml; charset=utf-8
Content-length: 656
SoapAction: https://schemas.microsoft.com/sqlserver/2004/SOAPsqlbatch
...
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Body>
<sqlbatch xmlns="https://schemas.microsoft.com/sqlserver/2004/SOAP">
<BatchCommands>
SELECT EmployeeID, FirstName, LastName
FROM Employee
WHERE EmployeeID=@x
FOR XML AUTO;
</BatchCommands>
<Parameters>
<SqlParameter Name="x" SqlDbType="Int" MaxLength="20"
xmlns="https://schemas.microsoft.com/SQLServer/
2001/12/SOAP/types/SqlParameter">
<Value xsi:type="xsd:string">1</Value>
</SqlParameter>
</Parameters>
</sqlbatch>
</soap:Body>
</soap:Envelope>
http üstbilgisi
http üstbilgisinde dikkat SoapAction http üstbilgi alan değerini yöntem adıdır (sqlbatch) istemci sql sorguları. belirtmek için kullandığıBu başlığı isteğe bağlı olduğunu unutmayın.
<SOAP Zarfı:> öğesi
soap isteği ayrıntıları görünür <Body> öğesi.soap <Body> öğesi yalnızca bir alt öğeye sahip (<sqlbatch>), istenen yöntem tanımlar ve.Öğesinde tanımlanan ad alanı nerede olduğunu sqlbatch işlem tanımlanmış.Bu öğe, alt öğe vardır:
The <BatchCommands> element specifies the query, or queries separated by semicolons (;), to execute.
The <Parameters> element provides an optional list of parameters.Önceki örnek istek zarfına Query'ye geçilen tek bir parametre yoktur.soap iletisi olarak eklenen her parametre bir <SqlParameter> alt öğesi<Parameters> öğesi.Parametreleri iletmek de, en azından parametre adı geçmesi gereken (Name öznitelik, <SqlParameter> öğesi) ve parametre değeri (<Value> alt öğesi <SqlParameter> öğe).
Beklenmeyen dönüşümleri önlemek için yapabilirsiniz kadar parametre bilgilerini sağlar.Aşağıdaki tablo için belirtebileceğiniz ek parametre özellikleri listeler <SqlParameter> öğesi.Bazıları için bu özellikleri de belirtebilirsiniz <Value> öğesi.
Hem belirtilen özellikleri için <SqlParameter> ve <Value> , belirttiğiniz zaman öğesi <Value> öğesi özellikleri olması gerekir https://schemas.microsoft.com/sqlserver/2004/sqltypes Aşağıdaki örnekte gösterildiği gibi ad:
<Value xsi:type="xsd:string" sqltypes:maxLength="100" xmlns:sqltypes="https://schemas.microsoft.com/sqlserver/2004/sqltypes">1</Value>
Parametre model |
Açıklama |
Düğüm üzerinde belirtilen |
|---|---|---|
Yön |
Parametrenin yönünü belirtir (Giriş, InputOutput).Giriş varsayılandır. |
<SqlParameter> |
LocaleID |
Windows yerel ayar harmanlama karakter türleri için tanımlar.COLLATIONPROPERTY tarafından döndürülen içsel LCID değeri eşdeğer. |
<SqlParameter> <Value> |
maxLength |
Öznitelik, <SqlParameter> öğesi sağlar en fazla uzunluğunu parametre değeri.Varsayılan değer 1'dir. |
<SqlParameter> <Değer> |
name |
Öznitelik, <SqlParameter> öğesi sağlar parametre adı. |
<SqlParameter> |
outputRequested |
Çıkış yayma olup olmadığını belirtmek için parametre öğeleri uygulanabilir.Varsayılan davranışını bağlıdır parameterMode kullanıldığında, onu açık olup varsayılan. Öznitelik ise küme için "true" bir girdi parametresi üzerinde oluşturmak bir hata. |
<Value> |
duyarlık |
Bu öznitelik, <SqlParameter> öğesi sağlar doğruluğunu parametre değeri.Varsayılan değer 18'dir. |
<SqlParameter> <Değer> |
ölçek |
Bu öznitelik, <SqlParameter> öğesi sağlar ölçek parametresi değeri.Varsayılan 0'dir. |
<SqlParameter> <Değer> |
sqlCompareOptions |
Karakter türleri için harmanlama kullanılacak karşılaştırma seçenekleri tanımlar.Bir enum ile eşleşen birleştirilebilir değerlerinden olan ComparisonStyle COLLATIONPROPERTY tarafından döndürülen gerçek değeri. |
<SqlParameter><değer> |
sqlDbType |
Parametre türü belirtir.Bir listesini görmek için SQL Server Sistem veri türlerini belirtebilirsiniz, bkz: Veri türü eşleştirmeleri yerel xml Web Hizmetleri'ndeki. |
<SqlParameter> |
clrTypeName |
Used to specify CLR user-defined type arguments.clrTypeName can contain the three-part name. |
<SqlParameter> <Değer> |
useDefaultValue |
Bir parametre için varsayılan bir değer kullanılması gerektiğini gösterir.Parametre öğesi ya da liste veya Boole Öznitelik, alternatif olarak, atlanabilir useDefaultValue değeri "true" belirtilebilir.Bu varsayılan değeri öznitelik olan "false" öğesi varsa ve "true" öğesi atlanırsa. |
<SqlParameter> <Değer> |
XmlNamespace |
İlişkili xml şema ad alanýný belirtir xml türü parametresi. |
<SqlParameter> <Değer> |
xsi: type |
Değer türünü belirtir.Nasıl hakkında daha fazla bilgi için xsi: type model eşler için SQL Server Bkz: sistem veri türleri, Veri türü eşleştirmeleri yerel xml Web Hizmetleri'ndeki. |
<Değer> |
TypeName |
Used to specify user-defined type arguments.typename can contain the three-part name. |
<SqlParameter> <Değer> |