FaultBindingCollection.Insert Method

Adds the specified FaultBinding to the FaultBindingCollection at the specified zero-based index.

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

public:
void Insert (
	int index, 
	FaultBinding^ bindingOperationFault
)
public void Insert (
	int index, 
	FaultBinding bindingOperationFault
)
public function Insert (
	index : int, 
	bindingOperationFault : FaultBinding
)
Not applicable.

Parameters

index

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

bindingOperationFault

The FaultBinding to add to the collection.

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 bindingOperationFault parameter is added to the end of the FaultBindingCollection.

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

The following example demonstrates a typical use of the Insert method.

BindingCollection^ myBindingCollection = myServiceDescription->Bindings;
Binding^ myBinding = myBindingCollection[ 0 ];
OperationBindingCollection^ myOperationBindingCollection = myBinding->Operations;
OperationBinding^ myOperationBinding = myOperationBindingCollection[ 0 ];
FaultBindingCollection^ myFaultBindingCollection = myOperationBinding->Faults;

// Reverse the fault bindings order.
if ( myFaultBindingCollection->Count > 1 )
{
   FaultBinding^ myFaultBinding = myFaultBindingCollection[ 0 ];
   array<FaultBinding^>^myFaultBindingArray = gcnew array<FaultBinding^>(myFaultBindingCollection->Count);
   
   // Copy the fault bindings to a temporary array.
   myFaultBindingCollection->CopyTo( myFaultBindingArray, 0 );
   
   // Remove all the fault binding instances in the fault binding collection.
   for ( int i = 0; i < myFaultBindingArray->Length; i++ )
      myFaultBindingCollection->Remove( myFaultBindingArray[ i ] );
   
   // Insert the fault binding instance in the reverse order.
   for ( int i = 0,j = (myFaultBindingArray->Length - 1); i < myFaultBindingArray->Length; i++,j-- )
      myFaultBindingCollection->Insert( i, myFaultBindingArray[ j ] );
   
   // Check if the first element in the collection before the reversal is now the last element.
   if ( myFaultBindingCollection->Contains( myFaultBinding ) && myFaultBindingCollection->IndexOf( myFaultBinding ) == (myFaultBindingCollection->Count - 1) )
         
   // Display the WSDL generated to the console.
   myServiceDescription->Write( Console::Out );
   else
         Console::WriteLine( "Error while reversing" );
}

BindingCollection myBindingCollection = myServiceDescription.
    get_Bindings();
Binding myBinding = myBindingCollection.get_Item(0);
OperationBindingCollection myOperationBindingCollection = 
    myBinding.get_Operations();
OperationBinding myOperationBinding = 
    myOperationBindingCollection.get_Item(0);
FaultBindingCollection myFaultBindingCollection = 
    myOperationBinding.get_Faults();

// Reverse the fault bindings order.
if (myFaultBindingCollection.get_Count() > 1) {
    FaultBinding myFaultBinding = myFaultBindingCollection.get_Item(0);
    FaultBinding myFaultBindingArray[] = 
        new FaultBinding[myFaultBindingCollection.get_Count()];

    // Copy the fault bindings to a temporary array.
    myFaultBindingCollection.CopyTo(myFaultBindingArray, 0);

    // Remove all the fault binding instances in the fault binding
    // collection.
    for (int i = 0; i < myFaultBindingArray.length; i++) {
        myFaultBindingCollection.Remove(myFaultBindingArray.
            get_Item(i));
    }

    // Insert the fault binding instance in the reverse order.
    for (int i = 0, j = myFaultBindingArray.length - 1; 
        i < myFaultBindingArray.length; i++, j--) {
        myFaultBindingCollection.Insert(i, myFaultBindingArray.
            get_Item(j));
    }  

    // Check if the first element in the collection before the reversal
    // is now the last element.
    if (myFaultBindingCollection.Contains(myFaultBinding) 
        && myFaultBindingCollection.IndexOf(myFaultBinding) == 
        myFaultBindingCollection.get_Count() - 1) {
        // Display the WSDL generated to the console.
        myServiceDescription.Write(Console.get_Out());
    }
    else {
        Console.WriteLine("Error while reversing");
    }
}

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: