An XML Web service or XML Web service client can specify the SOAP headers it wants to process by applying a System.Web.Services.Protocols.SoapHeaderAttribute to the XML Web service method in the XML Web service class or the corresponding method in the proxy class. In order for the XML Web service method to receive the contents of the SOAP header, a member is added to the XML Web service class of a type derived from System.Web.Services.Protocols.SoapHeader. Likewise, an XML Web service client adds a member to the proxy class deriving from System.Web.Services.Protocols.SoapHeader. The Type deriving from System.Web.Services.Protocols.SoapHeader represents the contents of the SOAP header and is created by the developer of the XML Web service or XML Web service client that wants to receive the SOAP header. Once the class is created, a System.Web.Services.Protocols.SoapHeaderAttribute can be applied to the XML Web service method or corresponding method in the XML Web service client proxy class specifying the member to receive the SOAP header contents with the SoapHeaderAttribute.MemberName property.

An XML Web service method can receive multiple SOAP headers by adding multiple members to the XML Web service class or the XML Web service proxy class and in turn applying multiple System.Web.Services.Protocols.SoapHeaderAttribute attributes to the XML Web service method.

To receive and process unknown SOAP headers at the time the XML Web service is written, specify the type of the member to be either System.Web.Services.Protocols.SoapUnknownHeader, System.Web.Services.Protocols.SoapHeader or an array of either class.

Namespace: System.Web.Services.Protocols
Assembly: System.Web.Services (in System.Web.Services.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0