SoapHeader.MustUnderstand Özellik

Tanım

Ad Alanı:

System.Web.Services.Protocols

Bütünleştirilmiş Kod:

System.Web.Services.dll

değerinin anlaşılması gerekip gerekmediğini SoapHeader belirten bir değer alır veya ayarlar.

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

public bool MustUnderstand { get; set; }

member this.MustUnderstand : bool with get, set

Public Property MustUnderstand As Boolean

Özellik Değeri

Boolean

true XML Web hizmetinin öğesini doğru şekilde yorumlaması ve işlemesi SoapHeadergerekiyorsa; değilse, false. Varsayılan değer: false.

Örnekler

Aşağıdaki XML Web hizmeti istemcisi, türünde MyHeaderözel bir SOAP üst bilgisi tanımlar, özelliğini olarak trueayarlar MustUnderstand ve XML Web hizmeti yöntemini çağırırMyWebMethod. XML Web hizmeti yöntemi SOAP üst bilgisinin DidUnderstandMyHeader özelliğini olarak trueayarlamazsa, bir SoapHeaderException oluşturulur.

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 );
   }

}

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());
        }
    }
}

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

Açıklamalar

XML Web hizmeti istemcisi, özelliği olarak ayarlanmış bir XML Web hizmeti yöntemi çağrısına MustUnderstandtrueSOAP üst bilgisi eklediğinde, XML Web hizmeti yönteminin DidUnderstand özelliğini olarak trueayarlaması gerekir; aksi takdirde, ASP.NET tarafından XML Web hizmeti istemcisine geri bir SoapHeaderException oluşturulur.

SOAP üst bilgisindeki özniteliğin EncodedMustUnderstandmustUnderstand değerini ayarlamak için hem ve MustUnderstand özellikleri kullanılabilir, ancak özelliği özniteliğini boole değeri kullanarak ayarlamanıza MustUnderstand olanak tanır.

İstemcilere SOAP üst bilgileri ekleme hakkında ayrıntılı bilgi için bkz. SOAP Üst Bilgilerini Kullanma.

Ayrıca bkz.

• DidUnderstand
• SoapHeaderException