SoapHttpClientProtocol.SoapVersion Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví verzi protokolu SOAP použitý k vytvoření požadavku SOAP do webové služby XML.
public:
property System::Web::Services::Protocols::SoapProtocolVersion SoapVersion { System::Web::Services::Protocols::SoapProtocolVersion get(); void set(System::Web::Services::Protocols::SoapProtocolVersion value); };
[System.Runtime.InteropServices.ComVisible(false)]
public System.Web.Services.Protocols.SoapProtocolVersion SoapVersion { get; set; }
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.SoapVersion : System.Web.Services.Protocols.SoapProtocolVersion with get, set
Public Property SoapVersion As SoapProtocolVersion
Hodnota vlastnosti
Jedna z SoapProtocolVersion hodnot. Výchozí formát je Soap11.
- Atributy
Příklady
Následující příklad kódu nastaví verzi protokolu používaného ke komunikaci s webovou službou XML na SOAP 1.2.
<%@ Page Language="C#" %>
<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="System.Net" %>
<%@ Import Namespace="System.Web.Services.Protocols" %>
<html>
<script runat="server">
void EnterBtn_Click(Object Src, EventArgs E)
{
// Create a new instance of a proxy class for your XML Web service.
ServerUsage su = new ServerUsage();
// Specifies that SOAP 1.2 is used communicate with the XML Web service.
su.SoapVersion = SoapProtocolVersion.Soap12;
// Invoke an XML Web service method that uses session state and thus cookies.
int count = su.PerSessionServiceUsage();
}
</script>
<body>
<form runat=server ID="Form1">
Click to bump up the Session Counter.
<p>
<asp:button text="Bump Up Counter" Onclick="EnterBtn_Click" runat=server ID="Button1" NAME="Button1"/>
<p>
<asp:label id="SessionCount" runat=server/>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="System.Net" %>
<%@ Import Namespace="System.Web.Services.Protocols" %>
<html>
<script runat=server>
Public Sub EnterBtn_Click(src As Object, E As EventArgs)
' Create a new instance of a proxy class for your XML Web service.
Dim su As ServerUsage = new ServerUsage()
' Specifies that SOAP 1.2 is used communicate with the XML Web service.
su.SoapVersion = SoapProtocolVersion.Soap12
' Invoke an XML Web service method that uses session state and thus cookies.
Dim count As Integer = su.PerSessionServiceUsage()
End Sub
</script>
<body>
<form runat=server ID="Form1">
Click to bump up the Session Counter.
<p>
<asp:button text="Bump Up Counter" Onclick="EnterBtn_Click" runat=server ID="Button1" NAME="Button1"/>
<p>
<asp:label id="SessionCount" runat=server/>
</form>
</body>
</html>
Poznámky
Vlastnost SoapVersion je nastavena ve třídě proxy generované nástrojem Web Services Description Language (Wsdl.exe) ve Soap11 výchozím nastavení, pokud dokument WSDL pro webovou službu XML podporuje SOAP verze 1.1. Pokud však webová služba XML podporuje pouze SOAP 1.2, Wsdl.exe nastaví SoapVersion vlastnost na Soap12. Chcete-li zvolit verzi protokolu SOAP při generování třídy proxy s Wsdl.exe, použijte /protocol
přepínač s SOAP12
SOAP
nastavením nastavit SoapVersion vlastnost na Soap11 a Soap12v uvedeném pořadí.