MessagePartCollection.Remove(MessagePart) Method

Definition

Removes the first occurrence of the specified MessagePart from the MessagePartCollection.

public:
 void Remove(System::Web::Services::Description::MessagePart ^ messagePart);
public void Remove (System.Web.Services.Description.MessagePart messagePart);
member this.Remove : System.Web.Services.Description.MessagePart -> unit
Public Sub Remove (messagePart As MessagePart)

Parameters

messagePart
MessagePart

The MessagePart to remove from the collection.

Examples

The following example demonstrates the use of the Remove method.

Console::WriteLine( "Checking if message is AddHttpPostOut..." );
Message^ myMessage = myServiceDescription->Messages[ "AddHttpPostOut" ];
if ( myMessageCollection->Contains( myMessage ) )
{
   // Get the mssage part collection.
   MessagePartCollection^ myMessagePartCollection = myMessage->Parts;

   // Get the part named Body.
   MessagePart^ myMessagePart = myMessage->Parts[ "Body" ];
   if ( myMessagePartCollection->Contains( myMessagePart ) )
   {
      // Get the part named Body.
      Console::WriteLine( "Index of Body in MessagePart collection = {0}", myMessagePartCollection->IndexOf( myMessagePart ) );
      Console::WriteLine( "Deleting Body from MessagePart collection..." );
      myMessagePartCollection->Remove( myMessagePart );
      if ( myMessagePartCollection->IndexOf( myMessagePart ) == -1 )
               Console::WriteLine( "from the message AddHttpPostOut." );
   }
}
Console.WriteLine("Checking if message is AddHttpPostOut...");
Message myMessage = myServiceDescription.Messages["AddHttpPostOut"];
if (myMessageCollection.Contains(myMessage))
{
   // Get the message part collection.
   MessagePartCollection myMessagePartCollection = myMessage.Parts;

   // Get the part named Body.
   MessagePart myMessagePart = myMessage.Parts["Body"];
   if (myMessagePartCollection.Contains(myMessagePart))
   {
      // Get the index of the part named Body.
      Console.WriteLine("Index of Body in MessagePart collection = " +
         myMessagePartCollection.IndexOf(myMessagePart));
      Console.WriteLine("Deleting Body from MessagePart collection...");
      myMessagePartCollection.Remove(myMessagePart);
      if(myMessagePartCollection.IndexOf(myMessagePart)== -1)
      {
         Console.WriteLine("MessagePart Body successfully deleted " +
            "from the message AddHttpPostOut.");
      }
   }
}
Console.WriteLine("Checking if message is AddHttpPostOut...")
Dim myMessage As Message = myServiceDescription.Messages("AddHttpPostOut")
If myMessageCollection.Contains(myMessage) Then

   ' Get the message part collection.
   Dim myMessagePartCollection As MessagePartCollection = myMessage.Parts

   ' Get the part named Body.
   Dim myMessagePart As MessagePart = myMessage.Parts("Body")
   If myMessagePartCollection.Contains(myMessagePart) Then

      ' Get the index of the part named Body.
      Console.WriteLine("Index of Body in MessagePart collection = " & _
         myMessagePartCollection.IndexOf(myMessagePart).ToString)
      Console.WriteLine("Deleting Body from MessagePart Collection...")
      myMessagePartCollection.Remove(myMessagePart)
      If myMessagePartCollection.IndexOf(myMessagePart) = -1 Then
         Console.WriteLine("MessagePart Body successfully deleted " & _
         "from the message AddHttpPostOut.")
      End If
   End If
End If

Remarks

This method performs a linear search; therefore, the average execution time is proportional to Count.

The elements that follow the removed MessagePart move up to occupy the vacated spot.

Applies to