SoapHeader.EncodedMustUnderstand Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.Services.Protocols
Assembly:
System.Web.Services.dll

Ruft bei der Kommunikation mit dem SOAP-Protokoll, Version 1.1, den Wert des mustUnderstand-XML-Attributs für den SOAP-Header ab oder legt diesen fest.

public:
 property System::String ^ EncodedMustUnderstand { System::String ^ get(); void set(System::String ^ value); };
public string EncodedMustUnderstand { get; set; }
member this.EncodedMustUnderstand : string with get, set
Public Property EncodedMustUnderstand As String

Eigenschaftswert

String

Der Wert des mustUnderstand-Attributs. Der Standardwert ist "0".

Ausnahmen

ArgumentException

Die Eigenschaft wird auf einen anderen Wert als "0", "1", "true" oder "false" festgelegt.

Beispiele

// MyHeader class is derived from the SoapHeader class.
MyHeader ^ customHeader = gcnew MyHeader;
customHeader->MyValue = "Header value for MyValue";

// Set the EncodedMustUnderstand property to true.
customHeader->EncodedMustUnderstand = "1";
WebService_SoapHeader_EncodedMustUnderstand ^ myWebService = gcnew WebService_SoapHeader_EncodedMustUnderstand;
myWebService->myHeader1 = customHeader;
String^ results = myWebService->MyWebMethod1();
Console::WriteLine( results );
try
{
   results = myWebService->MyWebMethod2();
}
catch ( Exception^ myException ) 
{
   Console::WriteLine( "Exception raised in MyWebMethod2." );
   Console::WriteLine( "Message: {0}", myException->Message );
}

// MyHeader class is derived from the SoapHeader class.
MyHeader customHeader = new MyHeader();
customHeader.MyValue = "Header value for MyValue";

// Set the EncodedMustUnderstand property to true.
customHeader.EncodedMustUnderstand = "1";

WebService_SoapHeader_EncodedMustUnderstand myWebService =
    new WebService_SoapHeader_EncodedMustUnderstand();
myWebService.MyHeaderValue = customHeader;
string results = myWebService.MyWebMethod1();
Console.WriteLine(results);
try
{
    results = myWebService.MyWebMethod2();
}
catch(Exception myException)
{
    Console.WriteLine("Exception raised in MyWebMethod2.");
    Console.WriteLine("Message: " + myException.Message);
}

' MyHeader class inherits from the SoapHeader class.
Dim customHeader As New MyHeader()
customHeader.MyValue = "Header value for MyValue"

' Set the EncodedMustUnderstand property to true.
customHeader.EncodedMustUnderstand = "1"

Dim myWebService As New WebService_SoapHeader_EncodedMustUnderstand()
myWebService.MyHeaderValue = customHeader
Dim results As String = myWebService.MyWebMethod1()
Console.WriteLine(results)
Try
    results = myWebService.MyWebMethod2()
Catch myException As Exception
    Console.WriteLine("Exception raised in MyWebMethod2.")
    Console.WriteLine("Message: " & myException.Message)
End Try

Hinweise

Verwenden Sie diese Eigenschaft nicht. Verwenden Sie stattdessen die MustUnderstand -Eigenschaft.

Gilt für:

Weitere Informationen