SoapHttpClientProtocol.SoapVersion Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wersję protokołu SOAP używaną do żądania PROTOKOŁU SOAP do usługi sieci Web 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
Wartość właściwości
Jedna z SoapProtocolVersion wartości. Wartość domyślna to Soap11.
- Atrybuty
Przykłady
Poniższy przykład kodu ustawia wersję protokołu używanego do komunikowania się z usługą sieci Web XML do protokołu 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>
Uwagi
Właściwość SoapVersion jest ustawiana w klasie serwera proxy wygenerowanej przez narzędzie języka opisu usług sieci Web (Wsdl.exe) domyślnie Soap11 , gdy dokument WSDL dla usługi sieci Web XML obsługuje protokół SOAP w wersji 1.1. Jednak gdy usługa sieci Web XML obsługuje tylko protokół SOAP 1.2, Wsdl.exe ustawia SoapVersion właściwość na Soap12. Aby wybrać wersję protokołu SOAP podczas generowania klasy serwera proxy z Wsdl.exe, użyj /protocol
przełącznika z ustawieniami SOAP
lub SOAP12
, aby odpowiednio ustawić SoapVersion właściwość na Soap11 i Soap12.