SoapHttpClientProtocol.SoapVersion Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Version des SOAP-Protokolls ab, mit dem die SOAP-Anforderung an den XML-Webdienst gesendet 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, setPublic Property SoapVersion As SoapProtocolVersionEigenschaftswert
Einer der SoapProtocolVersion Werte. Der Standardwert lautet Soap11.
- Attribute
Beispiele
Im folgenden Codebeispiel wird die Version des Protokolls festgelegt, das für die Kommunikation mit einem XML-Webdienst mit 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 standardmäßig generiert wird, 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. Wenn Sie die Version des SOAP-Protokolls beim Generieren der Proxyklasse mit Wsdl.exeauswählen möchten, verwenden Sie den /protocol Schalter mit den SOAP Einstellungen, SOAP12 um die SoapVersion Eigenschaft Soap11 auf bzw Soap12. die Eigenschaft festzulegen.
