MessageCollection.Insert(Int32, Message) Method

Reference

Definition

Namespace:: System.Web.Services.Description

Assembly:: System.Web.Services.dll

Assembly:: System.Web.Services.Description.dll

Package:: System.Web.Services.Description v8.1.0

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.

Adds the specified Message to the MessageCollection at the specified zero-based index.

public:
 void Insert(int index, System::Web::Services::Description::Message ^ message);

public void Insert (int index, System.Web.Services.Description.Message message);

member this.Insert : int * System.Web.Services.Description.Message -> unit

Public Sub Insert (index As Integer, message As Message)

Parameters

index: Int32

The zero-based index at which to insert the message parameter.

message: Message

The Message to add to the collection.

Exceptions

IndexOutOfRangeException

The index parameter is less than zero.

-or-

The index parameter is greater than Count.

Examples

Message^ myMessage1 = gcnew Message;
myMessage1->Name = "AddSoapIn";
MessagePart^ myMessagePart1 = gcnew MessagePart;
myMessagePart1->Name = "parameters";
myMessagePart1->Element = gcnew XmlQualifiedName( "Add",myServiceDescription->TargetNamespace );
myMessage1->Parts->Insert( 0, myMessagePart1 );
myServiceDescription->Messages->Insert( 16, myMessage1 );

Message myMessage1 = new Message();
myMessage1.Name = "AddSoapIn";
MessagePart myMessagePart1 = new MessagePart();
myMessagePart1.Name = "parameters";
myMessagePart1.Element = new XmlQualifiedName("Add",myServiceDescription.TargetNamespace);
myMessage1.Parts.Insert(0,myMessagePart1);
myServiceDescription.Messages.Insert(16,myMessage1);

Dim myMessage1 As New Message()
myMessage1.Name = "AddSoapIn"
Dim myMessagePart1 As New MessagePart()
myMessagePart1.Name = "parameters"
myMessagePart1.Element = New XmlQualifiedName("Add", _
   myServiceDescription.TargetNamespace)
myMessage1.Parts.Insert(0, myMessagePart1)
myServiceDescription.Messages.Insert(16, myMessage1)

Remarks

If the number of items in the collection already equals the collection's capacity, the capacity is doubled by automatically reallocating the internal array before the new element is inserted.

If the index parameter is equal to Count, the message parameter is added to the end of the MessageCollection.

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

Applies to

Jaa