Header

Article
05/23/2014

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

The Header class defines a SIP header.

The Header class is derived from the System.Object class.

Public Constructors

The Header class has the following public constructors.

Constructor	Description
Header.Header ()()	Initializes a new instance of the Header class without a specified type or value.
Header.Header (String)	Initializes a new instance of the Header class of the specified SIP header type.
Header.Header (String, String)	Initializes a new instance of the Header class of the specified SIP header type, with the specified value.

Public Methods

The Header class has the following public methods.

Method	Description
External .NET Framework Class Reference	Inherited from System.Object. Determines whether the specified System.Object is equal to the current System.Object.
External .NET Framework Class Reference	Inherited from System.Object. Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table.
External .NET Framework Class Reference	Inherited from System.Object. Gets the System.Type of the current instance.
External .NET Framework Class Reference	Inherited from System.Object. Returns a System.String that represents the current System.Object.

Public Properties

The Header class has the following public properties.

Property	Description
Header.IsReadOnly	Data type: BooleanAccess type: Read-only Indicates whether the SIP header is read-only.
Header.Parameters	Data type: NameValueCollectionAccess type: Read/write Contains the parameters for the SIP header as a collection of name/value pairs.
Header.Type	Data type: StringAccess type: Read-only Contains the SIP header type as a string.
Header.Value	Data type: StringAccess type: Read/write Contains the SIP header value as a string.
Header.ValueNoParameters	Data type: StringAccess type: Read/write Contains the SIP header value as a string, minus any attached parameters.

Remarks

A SIP header field is represented as type: value *(;parameter-name=parameter-value). The header type is a specific name, such as "Via", "Subject", or "Route". The header value is a string value corresponding to the type. The optional parameter list occurs after the value, with each parameter name/value pair separated from the header value and the other parameters by a semicolon.

Example Code

The following code sample sends a redirection response with the new endpoint address in the "Contact" header. Requests are dispatched to this method from the MSPL script in the application manifest using the Dispatch MSPL function.

public void OnRequest(object sender, RequestReceivedEventArgs rreArgs)
{

// Send a generic response to the sender indicating redirection (302).

Response response = rreArgs.Request.CreateResponse(302);

response.ReasonPhrase = "Redirected by Communications Server";

// Add the "Contact" header indicating the new redirection address of the SIP user.
// In this example, the localhost is supplied; in a real application, the second
// parameter of the Header constructor would be the redirection address of the user.

Header h = new Header("Contact", "sip:127.0.0.1:5060;transport=tcp");
response.AllHeaders.Add(h);

// Send the response.
rreArgs.ServerTransaction.SendResponse(response);

}

Requirements

Redistributable: Requires Microsoft Office Communications Server 2007.

Namespace:Microsoft.Rtc.Sip Namespace

Assembly: ServerAgent (in ServerAgent.dll)

Concepts

HeaderCollection

Share via