HttpListenerPrefixCollection.Clear Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.HttpListener.dll

Quelle:

HttpListenerPrefixCollection.cs

Entfernt alle URI-Präfixe aus der Auflistung.

public:
 virtual void Clear();

public void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Sub Clear ()

Implementiert

Clear()

Ausnahmen

HttpListenerException

Bei einem Windows-Funktionsaufruf ist ein Fehler aufgetreten. Überprüfen Sie die ErrorCode-Eigenschaft der Ausnahme, um die Ursache der Ausnahme zu bestimmen.

ObjectDisposedException

Der HttpListener, der dieser Sammlung zugeordnet ist, ist geschlossen.

Beispiele

Im folgenden Codebeispiel werden alle Präfixe in einem HttpListenerPrefixCollectionentfernt.

public static bool RemoveAllPrefixes(HttpListener listener)
{
    // Get the prefixes that the Web server is listening to.
    HttpListenerPrefixCollection prefixes = listener.Prefixes;
    try
    {
        prefixes.Clear();
    }
    // If the operation failed, return false.
    catch
    {
        return false;
    }
    return true;
}

Public Shared Function RemoveAllPrefixes(ByVal listener As HttpListener) As Boolean
    ' Get the prefixes that the Web server is listening to.
    Dim prefixes As HttpListenerPrefixCollection = listener.Prefixes

    Try
        prefixes.Clear()
    Catch ' If the operation failed, return false.
        Return False
    End Try

    Return True
End Function

Hinweise

Nach dem Aufrufen dieser Methode können Sie das zugeordnete HttpListener nicht starten, ohne neue Präfixe hinzuzufügen. Wenn Sie dies versuchen, wird eine Ausnahme ausgelöst.

Hinweise für Aufrufer

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung im .NET Framework.

Weitere Informationen

• HttpListener