SoapHeaderAttribute(String) Oluşturucu

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 ayarlayarak sınıfının yeni bir örneğini SoapHeaderAttribute başlatır.

public:
 SoapHeaderAttribute(System::String ^ memberName);

public SoapHeaderAttribute (string memberName);

new System.Web.Services.Protocols.SoapHeaderAttribute : string -> System.Web.Services.Protocols.SoapHeaderAttribute

Public Sub New (memberName As String)

Parametreler

memberName

String

SOAP üst bilgi içeriğini temsil eden XML Web hizmeti sınıfının üyesi. MemberName özelliği bu parametrenin değerine ayarlanır.

Ö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 istemcisi veya XML Web hizmeti, XML Web hizmeti sınıfındaki XML Web hizmeti yöntemine veya ara sunucu sınıfındaki ilgili yönteme uygulayarak SoapHeaderAttribute belirli XML Web hizmeti yöntemleri için 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 xml web hizmeti sınıfına bir Type üye eklenir. Benzer şekilde, XML Web hizmeti istemcisi de öğesinden SoapHeadertüretilen ara sunucu sınıfına bir üye ekler. öğesinden TypeSoapHeader 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 bu oluşturucuya veya MemberName özelliğine parametresiyle memberName SOAP üst bilgisi içeriğini alacak üyeyi belirten ilgili yönteme 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çinSoapUnknownHeaderSoapHeader, üyenin öğesini veya herhangi bir sınıfın dizisini belirtinType.