MimeTextMatchCollection.Insert(Int32, MimeTextMatch) Método

Definição

Adiciona o MimeTextMatch especificado para o MimeTextMatchCollection no índice especificado.Adds the specified MimeTextMatch to the MimeTextMatchCollection at the specified index.

public:
 void Insert(int index, System::Web::Services::Description::MimeTextMatch ^ match);
public void Insert (int index, System.Web.Services.Description.MimeTextMatch match);
member this.Insert : int * System.Web.Services.Description.MimeTextMatch -> unit
Public Sub Insert (index As Integer, match As MimeTextMatch)

Parâmetros

index
Int32

O índice de base zero no qual inserir o parâmetro match.The zero-based index at which to insert the match parameter.

match
MimeTextMatch

O MimeTextMatch a adicionar à coleção.The MimeTextMatch to add to the collection.

Exceções

O parâmetro index é menor que zero.The index parameter is less than zero.

- ou --or- O parâmetro index é maior que Count.The index parameter is greater than Count.

Exemplos

O exemplo a seguir demonstra o uso do método Insert.The following example demonstrates the use of the Insert method.

// Get an instance of 'MimeTextMatchCollection'.
MimeTextMatchCollection^ myMimeTextMatchCollection1 = gcnew MimeTextMatchCollection;
array<MimeTextMatch^>^myMimeTextMatch1 = gcnew array<MimeTextMatch^>(5);
myMimeTextMatchCollection1 = myMimeTextBinding1->Matches;
for ( myInt = 0; myInt < 4; myInt++ )
{
   myMimeTextMatch1[ myInt ] = gcnew MimeTextMatch;
   myMimeTextMatch1[ myInt ]->Name = String::Format( "Title{0}", Convert::ToString( myInt ) );
   if ( myInt != 0 )
   {
      myMimeTextMatch1[ myInt ]->RepeatsString = "7";
   }
   myMimeTextMatchCollection1->Add( myMimeTextMatch1[ myInt ] );
}
myMimeTextMatch1[ 4 ] = gcnew MimeTextMatch;

// Remove 'MimeTextMatch' instance from collection.
myMimeTextMatchCollection1->Remove( myMimeTextMatch1[ 1 ] );

// Using MimeTextMatchCollection.Item indexer to comapre. 
if ( myMimeTextMatch1[ 2 ] == myMimeTextMatchCollection1[ 1 ] )
{
   // Check whether 'MimeTextMatch' instance exists. 
   myInt = myMimeTextMatchCollection1->IndexOf( myMimeTextMatch1[ 2 ] );

   // Insert 'MimeTextMatch' instance at a desired position.
   myMimeTextMatchCollection1->Insert( 1, myMimeTextMatch1[ myInt ] );
   myMimeTextMatchCollection1[ 1 ]->RepeatsString = "5";
   myMimeTextMatchCollection1->Insert( 4, myMimeTextMatch1[ myInt ] );
}
// Get an instance of 'MimeTextMatchCollection'.
MimeTextMatchCollection myMimeTextMatchCollection1 = new MimeTextMatchCollection();
MimeTextMatch[] myMimeTextMatch1 = new MimeTextMatch[5];
myMimeTextMatchCollection1 = myMimeTextBinding1.Matches;
for( myInt = 0 ; myInt < 4 ; myInt++ )
{
   myMimeTextMatch1[ myInt ]  = new MimeTextMatch();
   myMimeTextMatch1[ myInt ].Name = "Title" + Convert.ToString( myInt );
   if( myInt != 0 )
   {
      myMimeTextMatch1[ myInt ].RepeatsString = "7";
   }
   myMimeTextMatchCollection1.Add( myMimeTextMatch1[ myInt ] );
}
myMimeTextMatch1[4] = new MimeTextMatch();
// Remove 'MimeTextMatch' instance from collection.
myMimeTextMatchCollection1.Remove( myMimeTextMatch1[ 1 ] );
// Using MimeTextMatchCollection.Item indexer to comapre.
if( myMimeTextMatch1[ 2 ] == myMimeTextMatchCollection1[ 1 ] )
{
   // Check whether 'MimeTextMatch' instance exists.
   myInt = myMimeTextMatchCollection1.IndexOf( myMimeTextMatch1[ 2 ] );
   // Insert 'MimeTextMatch' instance at a desired position.
   myMimeTextMatchCollection1.Insert( 1, myMimeTextMatch1[ myInt ] );
   myMimeTextMatchCollection1[ 1 ].RepeatsString = "5";
   myMimeTextMatchCollection1.Insert( 4, myMimeTextMatch1[ myInt ] );
}
' Get an instance of 'MimeTextMatchCollection'.
Dim myMimeTextMatchCollection1 As New MimeTextMatchCollection()
Dim myMimeTextMatch1(4) As MimeTextMatch
myMimeTextMatchCollection1 = myMimeTextBinding1.Matches
For myInt = 0 To 3
   myMimeTextMatch1(myInt) = New MimeTextMatch()
   myMimeTextMatch1(myInt).Name = "Title" + Convert.ToString(myInt)
   If myInt <> 0 Then
      myMimeTextMatch1(myInt).RepeatsString = "7"
   End If
   myMimeTextMatchCollection1.Add(myMimeTextMatch1(myInt))
Next myInt
myMimeTextMatch1(4) = New MimeTextMatch()
' Remove 'MimeTextMatch' instance from collection.
myMimeTextMatchCollection1.Remove(myMimeTextMatch1(1))
' Using MimeTextMatchCollection.Item indexer to comapre. 
If myMimeTextMatch1(2) Is myMimeTextMatchCollection1(1) Then
   ' Check whether 'MimeTextMatch' instance exists. 
   myInt = myMimeTextMatchCollection1.IndexOf(myMimeTextMatch1(2))
   ' Insert 'MimeTextMatch' instance at a desired position.
   myMimeTextMatchCollection1.Insert(1, myMimeTextMatch1(myInt))
   myMimeTextMatchCollection1(1).RepeatsString = "5"
   myMimeTextMatchCollection1.Insert(4, myMimeTextMatch1(myInt))
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.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.

Se o index parâmetro for igual a Count , o match parâmetro será adicionado ao final do MimeTextMatchCollection .If the index parameter is equal to Count, the match parameter is added to the end of the MimeTextMatchCollection.

Os elementos após o ponto de inserção se movem para baixo para acomodar o novo elemento.The elements after the insertion point move down to accommodate the new element.

Aplica-se a