Freigeben über


SoapHttpClientProtocol.SoapVersion Eigenschaft

Definition

Ruft die Version des SOAP-Protokolls ab, mit dem die SOAP-Anforderung an den XML-Webdienst ausgeführt wird, oder legt diese fest.

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

Eigenschaftswert

SoapProtocolVersion

Einer der SoapProtocolVersion-Werte. Der Standardwert ist Soap11.

Attribute

Beispiele

Im folgenden Codebeispiel wird die Version des Protokolls festgelegt, das zum Kommunizieren mit einem XML-Webdienst an SOAP 1.2 verwendet wird.

<%@ 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>

Hinweise

Die SoapVersion Eigenschaft wird in der Proxyklasse festgelegt, die vom Web Services Description Language-Tool (Wsdl.exe) Soap11 generiert wird, standardmäßig, wenn ein WSDL-Dokument für einen XML-Webdienst SOAP Version 1.1 unterstützt. Wenn ein XML-Webdienst jedoch nur SOAP 1.2 unterstützt, legt Wsdl.exe die SoapVersion Eigenschaft auf Soap12. Um die Version des SOAP-Protokolls beim Generieren der Proxyklasse mit Wsdl.exe auszuwählen, verwenden Sie den /protocol Schalter mit den SOAP Einstellungen, um die SoapVersion Eigenschaft auf Soap11 und SOAP12 entsprechend Soap12festzulegen.

Gilt für

Siehe auch