PortCollection.Insert(Int32, Port) 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 Port instance to the PortCollection at the specified index.

public:
 void Insert(int index, System::Web::Services::Description::Port ^ port);

public void Insert (int index, System.Web.Services.Description.Port port);

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

Public Sub Insert (index As Integer, port As Port)

Parameters

index: Int32

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

port: Port

The Port to add to the collection.

Exceptions

IndexOutOfRangeException

The index parameter is less than zero.

-or-

The index parameter is greater than Count.

Examples

myPortCollection = myService->Ports;

// Create an array of Port objects.
Console::WriteLine( "\nPort collection :" );
array<Port^>^myPortArray = gcnew array<Port^>(myService->Ports->Count);
myPortCollection->CopyTo( myPortArray, 0 );
for ( int i1 = 0; i1 < myService->Ports->Count; ++i1 )
{
   Console::WriteLine( "Port[{0}] : {1}", i1, myPortArray[ i1 ]->Name );

}
Port^ myIndexPort = myPortCollection[ 0 ];
Console::WriteLine( "\n\nThe index of port '{0}' is : {1}", myIndexPort->Name, myPortCollection->IndexOf( myIndexPort ) );

Port^ myPortTestInsert = myPortCollection[ 0 ];
myPortCollection->Remove( myPortTestInsert );
myPortCollection->Insert( 0, myPortTestInsert );
Console::WriteLine( "\n\nTotal Number of Ports after inserting a new port '{0}' is : {1}", myPortTestInsert->Name, myService->Ports->Count );
for ( int i1 = 0; i1 < myService->Ports->Count; ++i1 )
{
   Console::WriteLine( "Port[{0}]  : {1}", i1, myPortArray[ i1 ]->Name );

}
myServiceDescription->Write( "MathServiceCopyToNew_cs.wsdl" );

myPortCollection = myService.Ports;

// Create an array of Port objects.
Console.WriteLine("\nPort collection :");
Port[] myPortArray = new Port[myService.Ports.Count];
myPortCollection.CopyTo(myPortArray, 0);
for(int i1=0 ; i1 < myService.Ports.Count ; ++i1)
{
   Console.WriteLine("Port[" + i1+ "] : " + myPortArray[i1].Name);
}
Port myIndexPort = myPortCollection[0];
Console.WriteLine("\n\nThe index of port '"
   +  myIndexPort.Name + "' is : "
   +  myPortCollection.IndexOf(myIndexPort));

Port myPortTestInsert =myPortCollection[0];
myPortCollection.Remove(myPortTestInsert);
myPortCollection.Insert(0, myPortTestInsert);
Console.WriteLine("\n\nTotal Number of Ports after inserting "
   + "a new port '" + myPortTestInsert.Name +"' is : "
   + myService.Ports.Count);
for(int i1=0 ; i1 < myService.Ports.Count ; ++i1)
{
   Console.WriteLine("Port[" + i1+"]  : " + myPortArray[i1].Name);
}
myServiceDescription.Write("MathServiceCopyToNew_cs.wsdl");

myPortCollection = myService.Ports

' Create an array of Port objects.
Console.WriteLine(ControlChars.NewLine & "Port collection :")
Dim myPortArray(myService.Ports.Count) As Port
myPortCollection.CopyTo(myPortArray, 0)
Dim i1 As Integer
For i1 = 0 to myService.Ports.Count -1
   Console.WriteLine("Port[" & i1.ToString + "] : " & _
      myPortArray(i1).Name)
Next
Dim myIndexPort As Port = myPortCollection(0)
Console.WriteLine(ControlChars.NewLine + ControlChars.NewLine + _
                  "The index of port '" + myIndexPort.Name + "' is : " + _
                  myPortCollection.IndexOf(myIndexPort).ToString)
Dim myPortTestInsert As Port = myPortCollection(0)
myPortCollection.Remove(myPortTestInsert)
myPortCollection.Insert(0, myPortTestInsert)
Console.WriteLine(ControlChars.NewLine + ControlChars.NewLine + _
      "Total Number of Ports after inserting " + "a new port '" + _
      myPortTestInsert.Name + "' is : " + myService.Ports.Count.ToString)
While i1 < myService.Ports.Count
   Console.WriteLine("Port[" + i1.ToString + "]  : " + myPortArray(i1).Name)
End While
myServiceDescription.Write("MathServiceCopyToNew_vb.wsdl")

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 value of the index parameter is equal to Count, the specified Port is added to the end of the PortCollection.

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

Applies to

Jaa