MimePartCollection.Insert(Int32, MimePart) Метод

Определение

Пространство имен:

System.Web.Services.Description

Сборка:

System.Web.Services.dll

Добавляет заданный объект MimePart в коллекцию MimePartCollection по заданному индексу.

public:
 void Insert(int index, System::Web::Services::Description::MimePart ^ mimePart);

public void Insert (int index, System.Web.Services.Description.MimePart mimePart);

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

Public Sub Insert (index As Integer, mimePart As MimePart)

Параметры

index

Int32

Индекс (с нуля) места вставки параметра mimePart.

mimePart

MimePart

Параметр MimePart для добавления в коллекцию.

Исключения

IndexOutOfRangeException

Значение параметра index меньше нуля.

-или-

Значение параметра index больше значения Count.

Примеры

В следующем примере демонстрируется типичное Insert использование метода .

MimeMultipartRelatedBinding^ myMimeMultipartRelatedBinding = nullptr;
IEnumerator^ myIEnumerator = myOutputBinding->Extensions->GetEnumerator();
while ( myIEnumerator->MoveNext() )
   myMimeMultipartRelatedBinding = (MimeMultipartRelatedBinding^)myIEnumerator->Current;

// Create an instance of 'MimePartCollection'.
MimePartCollection^ myMimePartCollection = gcnew MimePartCollection;
myMimePartCollection = myMimeMultipartRelatedBinding->Parts;
Console::WriteLine( "Total number of mimepart elements in the collection initially  is: {0}", myMimePartCollection->Count );

// Get the type of first 'Item' in collection.
Console::WriteLine( "The first object in collection is of type: {0}", myMimePartCollection[ 0 ] );
MimePart^ myMimePart1 = gcnew MimePart;

// Create an instance of 'MimeXmlBinding'.
MimeXmlBinding^ myMimeXmlBinding1 = gcnew 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 successfully inserted at position: {0}", myMimePartCollection->IndexOf( myMimePart1 ) );
}

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 successfully inserted at position: "
                        +myMimePartCollection.IndexOf(myMimePart1));
}

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 successfully inserted at position: " + _
                                      myMimePartCollection.IndexOf(myMimePart1).ToString())
End If

Комментарии

Если количество элементов в коллекции уже равно емкости коллекции, емкость удваивается путем автоматического перераспределения внутреннего массива до вставки нового элемента.

index Если параметр равен Count, mimePart параметр добавляется в конец MimePartCollection.

Элементы после точки вставки перемещаются вниз для размещения нового элемента.