SoapHeaderAttribute.MemberName Özellik

Tanım

Ad Alanı:

System.Web.Services.Protocols

Bütünleştirilmiş Kod:

System.Web.Services.dll

SOAP üst bilgisi içeriğini temsil eden XML Web hizmeti sınıfının üyesini alır veya ayarlar.

public:
 property System::String ^ MemberName { System::String ^ get(); void set(System::String ^ value); };

public string MemberName { get; set; }

member this.MemberName : string with get, set

Public Property MemberName As String

Özellik Değeri

String

SOAP üst bilgi içeriğini temsil eden XML Web hizmeti sınıfının üyesi. Varsayılan değer yoktur.

Örnekler

Aşağıdaki MyWebService XML Web hizmeti türünden MyHeaderbirini SoapHeader tanımlar. Hello XML Web hizmeti yöntemi, XML Web hizmeti yöntemine geçirilen SOAP üst bilgilerinin içeriğini MyHeader alacak özellik olarak MemberName üyeyi belirtirmyHeader.

#using <System.EnterpriseServices.dll>
#using <System.Web.Services.dll>

using namespace System;
using namespace System::Web::Services;
using namespace System::Web::Services::Protocols;

// Define a SOAP header by deriving from the SoapHeader base class.
// The header contains just one string value.
public ref class MyHeader: public SoapHeader
{
public:
   String^ MyValue;
};

public ref class MyWebService
{
public:

   // Member variable to receive the contents of the MyHeader SOAP header.
   MyHeader^ myHeader;

   [WebMethod]
   [SoapHeader("myHeader",Direction=SoapHeaderDirection::InOut)]
   void Hello(){}

};

using System;
using System.Web.Services;
using System.Web.Services.Protocols;

// Define a SOAP header by deriving from the SoapHeader base class.
// The header contains just one string value.
public class MyHeader : SoapHeader {
    public string MyValue;
}

public class MyWebService {
    // Member variable to receive the contents of the MyHeader SOAP header.
    public MyHeader myHeader;

    [WebMethod]
    [SoapHeader("myHeader", Direction=SoapHeaderDirection.InOut)]
    public void Hello() {
    }
}

Imports System.Web.Services
Imports System.Web.Services.Protocols

' Define a SOAP header by deriving from the SoapHeader base class.
' The header contains just one string value.
Public Class MyHeader
   Inherits SoapHeader
   Public MyValue As String
End Class


Public Class MyWebService
   ' Member variable to receive the contents of the MyHeader SOAP header.
   Public myHeader As MyHeader

   
   <WebMethod, _ 
    SoapHeader("myHeader", Direction := SoapHeaderDirection.InOut)> _
   Public Sub Hello()

   End Sub
End Class

Açıklamalar

XML Web hizmeti veya XML Web hizmeti istemcisi, XML Web hizmeti sınıfındaki XML Web hizmeti yöntemine veya ara sunucu sınıfındaki ilgili yönteme uygulayarak SoapHeaderAttribute işlemek istediği SOAP üst bilgilerini belirtebilir. XML Web hizmeti yönteminin SOAP üst bilgisinin içeriğini alması için, öğesinden SoapHeadertüretilen bir türün XML Web hizmeti sınıfına bir üye eklenir. Benzer şekilde, XML Web hizmeti istemcisi de öğesinden SoapHeadertüretilen ara sunucu sınıfına bir üye ekler. Type öğesinden SoapHeader türetilen, SOAP üst bilgisinin içeriğini temsil eder ve SOAP üst bilgisini almak isteyen XML Web hizmeti veya XML Web hizmeti istemcisinin geliştiricisi tarafından oluşturulur. Sınıf oluşturulduktan sonra, SoapHeaderAttribute XML Web hizmeti yöntemine veya XML Web hizmeti istemci proxy sınıfında soap üst bilgisi içeriğini özelliğiyle alacak üyeyi belirten ilgili yönteme MemberName uygulanabilir.

XML Web hizmeti yöntemi, XML Web hizmeti sınıfına veya XML Web hizmeti ara sunucusu sınıfına birden çok üye ekleyerek ve buna karşılık XML Web hizmeti yöntemine birden çok öznitelik uygulayarak birden çok SoapHeaderAttribute SOAP üst bilgisi alabilir.

XML Web hizmeti yazılırken bilinmeyen SOAP üst bilgilerini almak ve işlemek için, üyenin türünü veya iki sınıftan birinin dizisini SoapUnknownHeaderSoapHeader belirtin.