SoapHeaderAttribute(String) Конструктор

Определение

Пространство имен:

System.Web.Services.Protocols

Сборка:

System.Web.Services.dll

Инициализирует новый экземпляр SoapHeaderAttribute класса, задав член класса веб-службы XML, представляющий содержимое заголовка SOAP.

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)

Параметры

memberName

String

Член класса веб-службы XML, представляющий содержимое заголовка SOAP. Для MemberName свойства будет задано значение этого параметра.

Примеры

Следующая MyWebService веб-служба XML определяет один из SoapHeader типов MyHeader. Метод Hello веб-службы XML указывает myHeader элемент в качестве MemberName свойства для получения содержимого заголовков SOAP, передаваемых MyHeader в метод веб-службы XML.

#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

Комментарии

Клиент веб-службы XML или веб-служба XML может указывать заголовки SOAP, которые требуется обрабатывать для определенных методов веб-службы XML, применяя SoapHeaderAttribute метод веб-службы XML в классе веб-службы XML или соответствующий метод в прокси-классе. Чтобы метод веб-службы XML получил содержимое заголовка SOAP, член добавляется в класс веб-службы XML, производный Type от SoapHeader. Аналогичным образом клиент веб-службы XML добавляет член в класс прокси-сервера, производный от SoapHeader. Это Type наследование SoapHeader представляет содержимое заголовка SOAP и создается разработчиком веб-службы XML или клиента веб-службы XML, который хочет получить заголовок SOAP. После создания класса можно применить к методу веб-службы XML или соответствующему методу в прокси-классе клиента веб-службы XML, SoapHeaderAttribute указывающего член для получения содержимого заголовка SOAP с memberName параметром для этого конструктора или MemberName свойства.

Метод веб-службы XML может получить несколько заголовков SOAP, добавив несколько членов в класс веб-службы XML или прокси-класс веб-службы XML, и, в свою очередь, применение нескольких SoapHeaderAttribute атрибутов к методу веб-службы XML.

Чтобы получить и обработать неизвестные заголовки SOAP во время записи веб-службы XML, укажите Type элемент, который должен быть либо SoapUnknownHeader, SoapHeader либо массив любого класса.