MimeTextMatchCollection.Insert Method

Adds the specified MimeTextMatch to the MimeTextMatchCollection at the specified index.

Namespace: System.Web.Services.Description
Assembly: System.Web.Services (in system.web.services.dll)

public:
void Insert (
	int index, 
	MimeTextMatch^ match
)
public void Insert (
	int index, 
	MimeTextMatch match
)
public function Insert (
	index : int, 
	match : MimeTextMatch
)
Not applicable.

Parameters

index

The zero-based index at which to insert the match parameter.

match

The MimeTextMatch to add to the collection.

Exception typeCondition

IndexOutOfRangeException

The index parameter is less than zero.

- or -

The index parameter is greater than Count.

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.

If the index parameter is equal to Count, the match parameter is added to the end of the MimeTextMatchCollection.

The elements after the insertion point move down to accommodate the new element.

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.get_Matches();
for (myInt = 0; myInt < 4; myInt++) {
    myMimeTextMatch1.set_Item(myInt, new MimeTextMatch());
    ((MimeTextMatch)myMimeTextMatch1.get_Item(myInt)).
        set_Name("Title" + Convert.ToString(myInt));

    if (myInt != 0) {
        ((MimeTextMatch)myMimeTextMatch1.get_Item(myInt)).
            set_RepeatsString("7");
    }
    myMimeTextMatchCollection1.Add(myMimeTextMatch1.get_Item(myInt));
}
myMimeTextMatch1.set_Item(4, new MimeTextMatch());

// Remove 'MimeTextMatch' instance from collection.
myMimeTextMatchCollection1.Remove(myMimeTextMatch1.get_Item(1));

// Using MimeTextMatchCollection.Item indexer to comapre. 
if (myMimeTextMatch1.get_Item(2).Equals(
    myMimeTextMatchCollection1.get_Item(1))) {

    // Check whether 'MimeTextMatch' instance exists. 
    myInt = myMimeTextMatchCollection1.
        IndexOf(myMimeTextMatch1.get_Item(2));

    // Insert 'MimeTextMatch' instance at a desired position.
    myMimeTextMatchCollection1.Insert(1, myMimeTextMatch1.
        get_Item(myInt));
    myMimeTextMatchCollection1.get_Item(1).set_RepeatsString("5");
    myMimeTextMatchCollection1.Insert(4, myMimeTextMatch1.
        get_Item(myInt));
}

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show: