SoapHeaderAttribute.MemberName Свойство

Определение

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

System.Web.Services.Protocols

Сборка:

System.Web.Services.dll

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

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

Значение свойства

String

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

Примеры

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, которые он хочет обработать, применяя SoapHeaderAttribute метод веб-службы XML в классе веб-службы XML или соответствующий метод в прокси-классе. Чтобы метод веб-службы XML получал содержимое заголовка SOAP, элемент добавляется в класс веб-службы XML типа, производного от SoapHeader. Аналогичным образом клиент веб-службы XML добавляет элемент в класс прокси-сервера, производный от SoapHeader. Наследование Type от SoapHeader представляет содержимое заголовка SOAP и создается разработчиком веб-службы XML или клиента веб-службы XML, который хочет получить заголовок SOAP. После создания класса можно применить к методу веб-службы XML или соответствующему методу в классе прокси-сервера клиента веб-службы XML, SoapHeaderAttribute указывающего элемент для получения содержимого заголовка SOAP со свойством MemberName .

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

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