This documentation is archived and is not being maintained.

FaultBindingCollection.Insert Method

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

[Visual Basic]
Public Sub Insert( _
   ByVal index As Integer, _
   ByVal bindingOperationFault As FaultBinding _
)
[C#]
public void Insert(
 int index,
 FaultBinding bindingOperationFault
);
[C++]
public: void Insert(
 int index,
 FaultBinding* bindingOperationFault
);
[JScript]
public function Insert(
   index : int,
 bindingOperationFault : FaultBinding
);

Parameters

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

Remarks

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.

Example

[Visual Basic, C#, C++] The following example demonstrates a typical use of the Insert method.

[Visual Basic] 
Dim myBindingCollection As BindingCollection = myServiceDescription.Bindings
Dim myBinding As Binding = myBindingCollection(0)
Dim myOperationBindingCollection As OperationBindingCollection = myBinding.Operations
Dim myOperationBinding As OperationBinding = myOperationBindingCollection(0)
Dim myFaultBindingCollection As FaultBindingCollection = myOperationBinding.Faults

' Reverse the fault bindings order.
If myFaultBindingCollection.Count > 1 Then
   Dim myFaultBinding As FaultBinding = myFaultBindingCollection(0)

   Dim myFaultBindingArray(myFaultBindingCollection.Count - 1) As FaultBinding
   ' Copy the fault bindings to a temporary array.
   myFaultBindingCollection.CopyTo(myFaultBindingArray, 0)

   ' Remove all the fault binding instances in the fault binding collection.
   Dim i, j As Integer

   For i = 0 To myFaultBindingArray.Length - 1
      myFaultBindingCollection.Remove(myFaultBindingArray(i))
   Next i

   j = myFaultBindingArray.Length - 1
   For i = 0 To myFaultBindingArray.Length - 1
      myFaultBindingCollection.Insert(i, myFaultBindingArray(j))
      j = j - 1
   Next

   If myFaultBindingCollection.Contains(myFaultBinding) And myFaultBindingCollection.IndexOf(myFaultBinding) = myFaultBindingCollection.Count - 1 Then
      ' Display the WSDL generated to the console.
      myServiceDescription.Write(Console.Out)
   Else
      Console.WriteLine("Error while reversing")
   End If
End If
   End Sub 'Main 

End Class 'FaultBindingCollection_Remove

[C#] 

      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];

         FaultBinding[] myFaultBindingArray = new 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");
      }


[C++] 

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

   // Reverse the fault bindings order.
   if (myFaultBindingCollection->Count > 1)
   {
      FaultBinding * myFaultBinding = myFaultBindingCollection->Item[0];

      FaultBinding* myFaultBindingArray[] = new 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->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->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->Count - 1))

         // Display the WSDL generated to the console.
         myServiceDescription->Write(Console::Out);
      else
         Console::WriteLine(S"Error while reversing");
   }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

FaultBindingCollection Class | FaultBindingCollection Members | System.Web.Services.Description Namespace

Show: