MessagePartCollection.Remove(MessagePart) Method

Reference

Definition

Namespace:: System.Web.Services.Description

Assembly:: System.Web.Services.dll

Assembly:: System.Web.Services.Description.dll

Package:: System.Web.Services.Description v8.1.0

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Jaa