SoapHeaderAttribute(String) Konstruktor

Definisi

Ruang nama:

System.Web.Services.Protocols

Rakitan:

System.Web.Services.dll

Menginisialisasi instans SoapHeaderAttribute baru kelas, mengatur anggota kelas layanan Web XML yang mewakili konten header 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)

Parameter

memberName

String

Anggota kelas layanan Web XML yang mewakili konten header SOAP. Properti MemberName akan diatur ke nilai parameter ini.

Contoh

Layanan Web XML berikut MyWebService mendefinisikan salah satu SoapHeader jenis MyHeader. Metode Hello layanan Web XML menentukan myHeader anggota sebagai MemberName properti untuk menerima konten MyHeader header SOAP yang diteruskan ke metode layanan Web 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

Keterangan

Klien layanan Web XML atau layanan Web XML dapat menentukan header SOAP yang ingin diproses untuk metode layanan Web XML tertentu dengan menerapkan SoapHeaderAttribute ke metode layanan Web XML di kelas layanan Web XML atau metode yang sesuai di kelas proksi. Agar metode layanan Web XML menerima konten header SOAP, anggota ditambahkan ke kelas layanan Web XML dari yang Type berasal dari SoapHeader. Demikian juga, klien layanan Web XML menambahkan anggota ke kelas proksi yang berasal dari SoapHeader. Yang Type berasal dari SoapHeader mewakili konten header SOAP dan dibuat oleh pengembang layanan Web XML atau klien layanan Web XML yang ingin menerima header SOAP. Setelah kelas dibuat, SoapHeaderAttribute dapat diterapkan ke metode layanan Web XML atau metode yang sesuai di kelas proksi klien layanan Web XML yang menentukan anggota untuk menerima konten header SOAP dengan memberName parameter ke konstruktor ini atau MemberName properti.

Metode layanan Web XML dapat menerima beberapa header SOAP dengan menambahkan beberapa anggota ke kelas layanan Web XML atau kelas proksi layanan Web XML dan pada gilirannya menerapkan beberapa SoapHeaderAttribute atribut ke metode layanan Web XML.

Untuk menerima dan memproses header SOAP yang tidak diketahui pada saat layanan Web XML ditulis, tentukan Type anggota yang akan menjadi SoapUnknownHeader, SoapHeader atau array dari salah satu kelas.