SoapHeader.MustUnderstand-Eigenschaft

Ruft einen Wert ab, der angibt, ob der SoapHeader verstanden werden muss, oder legt diesen fest.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in system.web.services.dll)

Syntax

'Declaration
Public Property MustUnderstand As Boolean
'Usage
Dim instance As SoapHeader
Dim value As Boolean

value = instance.MustUnderstand

instance.MustUnderstand = value

public bool MustUnderstand { get; set; }

public:
property bool MustUnderstand {
    bool get ();
    void set (bool value);
}

/** @property */
public boolean get_MustUnderstand ()

/** @property */
public void set_MustUnderstand (boolean value)

public function get MustUnderstand () : boolean

public function set MustUnderstand (value : boolean)

Eigenschaftenwert

true, wenn der XML-Webdienst den SoapHeader ordnungsgemäß interpretieren und verarbeiten muss. Andernfalls false. Der Standardwert ist false.

Hinweise

Wenn ein XML-Webdienstclient einen SOAP-Header zu einem XML-Webdienstmethodenaufruf hinzufügt, wobei die MustUnderstand-Eigenschaft auf true festgelegt ist, muss die XML-Webdienstmethode die DidUnderstand-Eigenschaft auf true festlegen. Andernfalls löst ASP.NET eine SoapHeaderException aus und gibt sie an den XML-Webdienstclient zurück.

Sowohl die EncodedMustUnderstand-Eigenschaft als auch die MustUnderstand-Eigenschaft kann zum Einrichten des Werts des mustUnderstand-Attributs innerhalb des SOAP-Headers verwendet werden, mithilfe der MustUnderstand-Eigenschaft können Sie jedoch das Attribut mit einem booleschen Wert einrichten.

Einzelheiten zum Hinzufügen von SOAP-Headern zu Clients finden Sie unter Verwenden von SOAP-Headern.

Beispiel

Der folgende XML-Webdienstclient definiert einen benutzerdefinierten SOAP-Header vom Typ MyHeader, legt die MustUnderstand-Eigenschaft auf true fest und ruft die MyWebMethod-XML-Webdienstmethode auf. Wenn die XML-Webdienstmethode die DidUnderstand-Eigenschaft des MyHeader-SOAP-Headers nicht auf true festlegt, wird eine SoapHeaderException ausgelöst.

Imports System

Public Class Sample
    
    Public Shared Sub Main()
        Dim ws As New MyWebService()

        Try
            Dim customHeader As New MyHeader1()

            customHeader.MyValue = "Header Value for MyValue"
            customHeader.MustUnderstand = True

            ws.myHeader = customHeader

        Dim results As Integer

            results = ws.MyWebMethod(3,5)
        Catch e As Exception
            Console.WriteLine("Exception: {0}", e.ToString())
        End Try
    End Sub
End Class

using System;

public class Sample {
    
    public static void Main() {
        MyWebService ws = new MyWebService();

        try {
            MyHeader customHeader = new MyHeader();
            customHeader.MyValue = "Header Value for MyValue";
            customHeader.MustUnderstand = true;
            ws.myHeader = customHeader;
            
        int results = ws.MyWebMethod(3,5);
        }
        catch (Exception e) {
            Console.WriteLine ("Exception: {0}", e.ToString());
        }
    }
}

int main()
{
   MyWebService^ ws = gcnew MyWebService;
   try
   {
      MyHeader^ customHeader = gcnew MyHeader;
      customHeader->MyValue = "Header Value for MyValue";
      customHeader->MustUnderstand = true;
      ws->myHeader = customHeader;
      int results = ws->MyWebMethod( 3, 5 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "Exception: {0}", e );
   }

}

import System.*;

public class Sample
{
    public static void main(String[] args)
    {
        MyWebService ws = new MyWebService();
        try {
            MyHeader customHeader = new MyHeader();
            customHeader.myValue = "Header Value for MyValue";
            customHeader.set_MustUnderstand(true);
            ws.myHeader = customHeader;
            int results = ws.MyWebMethod(3, 5);
        }
        catch (System.Exception e) {
            Console.WriteLine("Exception: {0}", e.ToString());
        }
    } //main
} //Sample

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SoapHeader-Klasse
SoapHeader-Member
System.Web.Services.Protocols-Namespace
SoapHeader.DidUnderstand-Eigenschaft
SoapHeaderException