MimePartCollection.Insert(Int32, MimePart) Método

Definição

Namespace:

System.Web.Services.Description

Assembly:

System.Web.Services.dll

Adiciona o MimePart especificado para o MimePartCollection no índice especificado.

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)

Parâmetros

index

Int32

O índice de base zero no qual inserir o parâmetro mimePart.

mimePart

MimePart

O MimePart a adicionar à coleção.

Exceções

IndexOutOfRangeException

O parâmetro index é menor que zero.

- ou - O parâmetro index é maior que Count.

Exemplos

O exemplo a seguir demonstra um uso típico do Insert método.

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

Comentários

Se o número de itens na coleção já for igual à capacidade da coleção, a capacidade será duplicada realocando automaticamente a matriz interna antes que o novo elemento seja inserido.

Se o index parâmetro for igual a Count, o mimePart parâmetro será adicionado ao final do MimePartCollection.

Os elementos após o ponto de inserção se movem para baixo para acomodar o novo elemento.