MessageCollection.Remove-Methode

Entfernt das erste Vorkommen der angegebenen Message aus der MessageCollection.

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

Syntax

'Declaration
Public Sub Remove ( _
    message As Message _
)
'Usage
Dim instance As MessageCollection
Dim message As Message

instance.Remove(message)

public void Remove (
    Message message
)

public:
void Remove (
    Message^ message
)

public void Remove (
    Message message
)

public function Remove (
    message : Message
)

Parameter

• message
  Die aus der Auflistung zu entfernende Message.

Hinweise

Diese Methode führt eine lineare Suche aus. Die durchschnittliche Ausführungszeit ist daher proportional zu Count.

Die Elemente, die auf die entfernte Message folgen, werden nach oben verschoben, um die frei gewordene Stelle einzunehmen.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung der Remove-Methode.

' Get Message by Name = "AddSoapIn".
Dim myMessage As Message = myServiceDescription.Messages("AddSoapIn")
Console.WriteLine("")
Console.WriteLine("Getting Message = 'AddSoapIn' {by Name}")
If myMessageCollection.Contains(myMessage) Then
   Console.WriteLine("")
   ' Get Message Name = "AddSoapIn" Index.
   Console.WriteLine("Message 'AddSoapIn' was found in Message Collection.")
   Console.WriteLine("Index of 'AddSoapIn' in Message Collection = " + _
                     myMessageCollection.IndexOf(myMessage).ToString)
   Console.WriteLine("Deleting Message from Message Collection...")
   myMessageCollection.Remove(myMessage)
   If myMessageCollection.IndexOf(myMessage) = -1 Then
      Console.WriteLine("Message 'AddSoapIn' was successfully " + _
                        " removed from Message Collection.")
   End If
End If

// Get Message by Name = "AddSoapIn".
Message myMessage = myServiceDescription.Messages["AddSoapIn"];
Console.WriteLine("");
Console.WriteLine("Getting Message = 'AddSoapIn' {by Name}");
if (myMessageCollection.Contains(myMessage))
{
   Console.WriteLine("");
   // Get Message Name = "AddSoapIn" Index.
   Console.WriteLine("Message 'AddSoapIn' was found in Message Collection.");
   Console.WriteLine("Index of 'AddSoapIn' in Message Collection = " + myMessageCollection.IndexOf(myMessage));
   Console.WriteLine("Deleting Message from Message Collection...");
   myMessageCollection.Remove(myMessage);
   if(myMessageCollection.IndexOf(myMessage) == -1)
   {
      Console.WriteLine("Message 'AddSoapIn' was successfully removed from Message Collection.");
   }
}

// Get Message by Name = S"AddSoapIn".
Message^ myMessage = myServiceDescription->Messages[ "AddSoapIn" ];
Console::WriteLine( "" );
Console::WriteLine( "Getting Message = 'AddSoapIn' {by Name}" );
if ( myMessageCollection->Contains( myMessage ) )
{
   Console::WriteLine( "" );

   // Get Message Name = S"AddSoapIn" Index.
   Console::WriteLine( "Message 'AddSoapIn' was found in Message Collection." );
   Console::WriteLine( "Index of 'AddSoapIn' in Message Collection = {0}", myMessageCollection->IndexOf( myMessage ) );
   Console::WriteLine( "Deleting Message from Message Collection..." );
   myMessageCollection->Remove( myMessage );
   if ( myMessageCollection->IndexOf( myMessage ) == -1 )
         Console::WriteLine( "Message 'AddSoapIn' was successfully removed from Message Collection." );
}

// Get Message by Name = "AddSoapIn".
Message myMessage = 
    myServiceDescription.get_Messages().get_Item("AddSoapIn");
Console.WriteLine("");
Console.WriteLine("Getting Message = 'AddSoapIn' {by Name}");
if (myMessageCollection.Contains(myMessage)) {
    Console.WriteLine("");

    // Get Message Name = "AddSoapIn" Index.
    Console.WriteLine("Message 'AddSoapIn' was found in "
        + "Message Collection.");
    Console.WriteLine("Index of 'AddSoapIn' in Message Collection = " 
        + myMessageCollection.IndexOf(myMessage));
    Console.WriteLine("Deleting Message from Message Collection...");
    myMessageCollection.Remove(myMessage);
    if (myMessageCollection.IndexOf(myMessage) == -1) {
        Console.WriteLine("Message 'AddSoapIn' was successfully "
            + "removed from Message Collection.");
    }
}

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

MessageCollection-Klasse
MessageCollection-Member
System.Web.Services.Description-Namespace