MimePartCollection.Insert メソッド

MimePartCollection 内の指定したインデックスに、指定した MimePart を追加します。

Public Sub Insert( _
   ByVal index As Integer, _   ByVal mimePart As MimePart _)
[C#]
public void Insert(intindex,MimePartmimePart);
[C++]
public: void Insert(intindex,MimePart* mimePart);
[JScript]
public function Insert(
   index : int,mimePart : MimePart);

パラメータ

• index
  mimePart パラメータを挿入する位置の、0 から始まるインデックス番号。
• mimePart
  コレクションに追加する MimePart 。

例外

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

解説

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

index パラメータと Count が等しい場合は、 mimePart パラメータが MimePartCollection の末尾に追加されます。

新しい要素を挿入するために、挿入位置より後にある要素の位置が繰り下げられます。

使用例

[Visual Basic, C#, C++] Insert メソッドの典型的な使用例を次に示します。

 
Dim myMimeMultipartRelatedBinding As MimeMultipartRelatedBinding = Nothing
Dim myIEnumerator As IEnumerator = myOutputBinding.Extensions.GetEnumerator()
While myIEnumerator.MoveNext()
   myMimeMultipartRelatedBinding = CType(myIEnumerator.Current, MimeMultipartRelatedBinding)
End While
' Create an instance of 'MimePartCollection'.
Dim myMimePartCollection As New MimePartCollection()
myMimePartCollection = myMimeMultipartRelatedBinding.Parts
Console.WriteLine("Total number of mimepart elements in the collection initially" + _
                                             " is: " + myMimePartCollection.Count.ToString())
' Get the type of first 'Item' in collection.
Console.WriteLine("The first object in collection is of type: " + _
                                                      myMimePartCollection.Item(0).ToString())
Dim myMimePart1 As New MimePart()
' Create an instance of 'MimeXmlBinding'.
Dim myMimeXmlBinding1 As New MimeXmlBinding()
myMimeXmlBinding1.Part = "body"
myMimePart1.Extensions.Add(myMimeXmlBinding1)
'  a mimepart at first position.
myMimePartCollection.Insert(0, myMimePart1)
Console.WriteLine("Inserting a mimepart object...")
' Check whether 'Insert' was successful or not.
If myMimePartCollection.Contains(myMimePart1) Then
   ' Display the index of inserted 'MimePart'.
   Console.WriteLine("'MimePart' is succesfully inserted at position: " + _
                                      myMimePartCollection.IndexOf(myMimePart1).ToString())
End If

[C#] 
MimeMultipartRelatedBinding myMimeMultipartRelatedBinding = null;
IEnumerator myIEnumerator = myOutputBinding.Extensions.GetEnumerator();
while(myIEnumerator.MoveNext())
{ 
   myMimeMultipartRelatedBinding=(MimeMultipartRelatedBinding)myIEnumerator.Current;
}
// Create an instance of 'MimePartCollection'.
MimePartCollection myMimePartCollection = new MimePartCollection();
myMimePartCollection= myMimeMultipartRelatedBinding.Parts;
Console.WriteLine("Total number of mimepart elements in the collection initially"+
                     " is: " +myMimePartCollection.Count);
// Get the type of first 'Item' in collection.
Console.WriteLine("The first object in collection is of type: "
                  +myMimePartCollection[0].ToString());
MimePart myMimePart1=new MimePart();
// Create an instance of 'MimeXmlBinding'.
MimeXmlBinding myMimeXmlBinding1 = new MimeXmlBinding();
myMimeXmlBinding1.Part = "body";
myMimePart1.Extensions.Add(myMimeXmlBinding1);
//  a mimepart at first position.
myMimePartCollection.Insert(0,myMimePart1);
Console.WriteLine("Inserting a mimepart object...");
// Check whether 'Insert' was successful or not.
if(myMimePartCollection.Contains(myMimePart1))
{
   // Display the index of inserted 'MimePart'.
   Console.WriteLine("'MimePart' is succesfully inserted at position: "
                        +myMimePartCollection.IndexOf(myMimePart1));         
}

[C++] 
MimeMultipartRelatedBinding* myMimeMultipartRelatedBinding = 0;
IEnumerator* myIEnumerator = myOutputBinding->Extensions->GetEnumerator();
while(myIEnumerator->MoveNext())
   myMimeMultipartRelatedBinding = 
   dynamic_cast<MimeMultipartRelatedBinding*>(myIEnumerator->Current);
// Create an instance of 'MimePartCollection'.
MimePartCollection* myMimePartCollection = new MimePartCollection();
myMimePartCollection= myMimeMultipartRelatedBinding->Parts;
Console::WriteLine(S"Total number of mimepart elements in the collection initially  is: {0}", 
   __box(myMimePartCollection->Count));
// Get the type of first 'Item' in collection.
Console::WriteLine(S"The first object in collection is of type: {0}", 
   myMimePartCollection->Item[0]);
MimePart* myMimePart1 = new MimePart();
// Create an instance of 'MimeXmlBinding'.
MimeXmlBinding* myMimeXmlBinding1 = new MimeXmlBinding();
myMimeXmlBinding1->Part = S"body";
myMimePart1->Extensions->Add(myMimeXmlBinding1);
//  a mimepart at first position.
myMimePartCollection->Insert(0, myMimePart1);
Console::WriteLine(S"Inserting a mimepart object...");
// Check whether 'Insert' was successful or not.
if (myMimePartCollection->Contains(myMimePart1))
{
   // Display the index of inserted 'MimePart'.
   Console::WriteLine(S"'MimePart' is succesfully inserted at position: {0}", 
      __box(myMimePartCollection->IndexOf(myMimePart1)));
}

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

MimePartCollection クラス | MimePartCollection メンバ | System.Web.Services.Description 名前空間