PortCollection.Insert メソッド

.NET Framework クラス ライブラリ リファレンス

PortCollection.Insert メソッド

PortCollection の指定したインデックス位置に、指定した Port インスタンスを追加します。

名前空間: System.Web.Services.Description
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As PortCollection
Dim index As Integer
Dim port As Port

instance.Insert(index, port)

C#

public void Insert (
    int index,
    Port port
)

C++

public:
void Insert (
    int index, 
    Port^ port
)

J#

public void Insert (
    int index, 
    Port port
)

JScript

public function Insert (
    index : int, 
    port : Port
)

パラメータ

index

port パラメータを挿入する位置の、0 から始まるインデックス番号。

port

コレクションに追加する Port。

例外

例外の種類	条件
IndexOutOfRangeException	index パラメータが 0 未満です。 または index パラメータが Count より大きい値です。

解説

コレクション内の項目数が既にコレクションの許容量に達している場合は、新しい要素が挿入される前に内部配列が自動的に再割り当てされ、コレクションの容量が 2 倍になります。

index パラメータの値と Count が等しい場合は、指定した Port が PortCollection の末尾に追加されます。

新しい要素を挿入できるように、挿入位置より後にある要素の位置が繰り下がります。

使用例

Visual Basic

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")

C#

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");

C++

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" );

J#

myPortCollection = myService.get_Ports();

// Create an array of Port objects.
Console.WriteLine("\nPort collection :");
Port myPortArray[] = 
     new Port[myService.get_Ports().get_Count()];
myPortCollection.CopyTo(myPortArray, 0);
for (int i1 = 0; i1 < myService.get_Ports().get_Count();
    ++i1) {
    Console.WriteLine("Port[" + i1 + "] : " 
        + myPortArray[i1].get_Name());
}

Port myIndexPort = myPortCollection.get_Item(0);
Console.WriteLine("\n\nThe index of port '" 
    + myIndexPort.get_Name() + "' is : " 
    + myPortCollection.IndexOf(myIndexPort));

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PortCollection クラス
PortCollection メンバ
System.Web.Services.Description 名前空間