Share via

  • Article

AddressHeader.CreateAddressHeader Method (String, String, Object)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Creates a new instance of the AddressHeader class with a specified value, name and namespace.

Namespace:  System.ServiceModel.Channels
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

Syntax

'Declaration
Public Shared Function CreateAddressHeader ( _
    name As String, _
    ns As String, _
    value As Object _
) As AddressHeader

public static AddressHeader CreateAddressHeader(
    string name,
    string ns,
    Object value
)

Parameters

  • value
    Type: System.Object
    The information item for the address header.

Return Value

Type: System.ServiceModel.Channels.AddressHeader
The AddressHeader with the specified name and ns that contains the information item specified by value.

Exceptions

Exception Condition
ArgumentNullException

The name is nulla null reference (Nothing in Visual Basic) or name.Length == 0.

Examples

The following example shows how to create an address header using this method.

            ' Create address headers for special services and add them to an array
            Dim addressHeader1 As AddressHeader = AddressHeader.CreateAddressHeader("specialservice1", "https://localhost:8000/service", 1)
            Dim addressHeader2 As AddressHeader = AddressHeader.CreateAddressHeader("specialservice2", "https://localhost:8000/service", 2)
            Dim addressHeaders() As AddressHeader = { addressHeader1, addressHeader2 }

            ' Endpoint address constructor with URI and address headers
            Dim endpointAddressWithHeaders As New EndpointAddress(New Uri("https://localhost/silverlightsamples/service1"), addressHeaders)

            ' Confirm adddressHeader1 is in endpointAddressWithHeaders - boolHeaders returns True.
            Dim addressHeaderCollection As AddressHeaderCollection = endpointAddressWithHeaders.Headers
            Dim boolHeaders As Boolean = addressHeaderCollection.Contains(addressHeader1)

// Create address headers for special services and add them to an array
AddressHeader addressHeader1 = AddressHeader.CreateAddressHeader("specialservice1", "https://localhost:8000/service", 1);
AddressHeader addressHeader2 = AddressHeader.CreateAddressHeader("specialservice2", "https://localhost:8000/service", 2);
AddressHeader[] addressHeaders = new AddressHeader[2] { addressHeader1, addressHeader2 };

// Endpoint address constructor with URI and address headers
EndpointAddress endpointAddressWithHeaders = new EndpointAddress(
    new Uri("https://localhost/silverlightsamples/service1"), addressHeaders
    );

// Confirm adddressHeader1 is in endpointAddressWithHeaders - boolHeaders returns True.
AddressHeaderCollection addressHeaderCollection = endpointAddressWithHeaders.Headers;
bool boolHeaders = addressHeaderCollection.Contains(addressHeader1);

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.