SoapHeaderCollection.Insert(Int32, SoapHeader) Method

Reference

Definition

Namespace:: System.Web.Services.Protocols

Assembly:: System.Web.Services.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Inserts a SoapHeader into the SoapHeaderCollection at the specified index.

public:
 void Insert(int index, System::Web::Services::Protocols::SoapHeader ^ header);

public void Insert (int index, System.Web.Services.Protocols.SoapHeader header);

member this.Insert : int * System.Web.Services.Protocols.SoapHeader -> unit

Public Sub Insert (index As Integer, header As SoapHeader)

Parameters

index: Int32

The zero-based index at which to insert the SoapHeader into the SoapHeaderCollection.

header: SoapHeader

The SoapHeader to insert into the SoapHeaderCollection.

Exceptions

ArgumentOutOfRangeException

The index parameter is not a valid index in the SoapHeaderCollection.

Examples

mySoapHeader = gcnew MySoapHeader;
mySoapHeader->text = "This header is inserted before the first header";
mySoapHeaderCollection->Insert( 0, mySoapHeader );

mySoapHeader = new MySoapHeader();
mySoapHeader.text = "This header is inserted before the first header";
mySoapHeaderCollection.Insert(0, mySoapHeader);

mySoapHeader = New MySoapHeader()
mySoapHeader.text = "This header is inserted before the first header"
mySoapHeaderCollection.Insert(0, mySoapHeader)

Remarks

If the index parameter equals the number of items in the collection, then the SoapHeader is appended to the end of the collection.

The SoapHeader elements after the insertion point move down to accommodate the new element.

Applies to

Jaa