LogExtentCollection.Remove Methode

Definition

Namespace:

System.IO.Log

Assembly:

System.IO.Log.dll

Entfernt eine LogExtent-Instanz aus der Auflistung.

Überlädt

Remove(LogExtent, Boolean)	Entfernt die angegebene LogExtent-Instanz aus der Auflistung.
Remove(String, Boolean)	Entfernt die LogExtent-Instanz mit dem angegebenen Pfad aus der Auflistung.

Remove(LogExtent, Boolean)

Entfernt die angegebene LogExtent-Instanz aus der Auflistung.

public:
 void Remove(System::IO::Log::LogExtent ^ extent, bool force);

public void Remove (System.IO.Log.LogExtent extent, bool force);

member this.Remove : System.IO.Log.LogExtent * bool -> unit

Public Sub Remove (extent As LogExtent, force As Boolean)

Parameter

extent

LogExtent

Die zu entfernende LogExtent-Instanz.

force

Boolean

true, wenn der Wertebereich sofort entfernt werden sollte; andernfalls false.

Ausnahmen

ArgumentNullException

extent oder force ist null.

ArgumentException

extent kann in der Auflistung nicht gefunden werden.

InvalidOperationException

extent kann nicht entfernt werden. Er ist entweder noch Bestandteil des aktiven Bereichs, oder der Zugriff wird verweigert.

IOException

Die Anforderung konnte aufgrund einer unerwarteten E/A-Ausnahme nicht ausgeführt werden.

- oder -

extent kann nicht gelöscht werden.

ObjectDisposedException

Die Methode wurde aufgerufen, nachdem die Sequenz verworfen wurde.

OutOfMemoryException

Der Arbeitsspeicher reicht nicht aus, um die Ausführung des Programms fortzusetzen.

SequenceFullException

Die Datensatzsequenz ist voll.

UnauthorizedAccessException

Der Zugriff auf den angegebenen Protokollspeicher wird vom Betriebssystem verweigert.

Hinweise

Eine LogExtent-Instanz kann nur aus der Auflistung entfernt werden, wenn sie nicht Bestandteil des aktiven Bereichs des LogStore ist. Wenn der force-Parameter true lautet und der Wertebereich nicht sofort entfernt werden kann, wird eine Ausnahme ausgelöst. Wenn der force-Parameter false lautet und der Wertebereich nicht sofort entfernt werden kann, wird das Entfernen verzögert, bis der Wertebereich kein Bestandteil des aktiven Bereichs mehr ist.

Sie können den letzten Wertebereich in der LogExtentCollection nicht entfernen. Das bedeutet, dass die Count-Eigenschaft nicht 0 (null) sein kann, wenn ein Wertebereich hinzugefügt wurde.

Remove(String, Boolean)

Entfernt die LogExtent-Instanz mit dem angegebenen Pfad aus der Auflistung.

public:
 void Remove(System::String ^ path, bool force);

public void Remove (string path, bool force);

member this.Remove : string * bool -> unit

Public Sub Remove (path As String, force As Boolean)

Parameter

path

String

Der Pfad der zu entfernenden LogExtent-Instanz.

force

Boolean

true, wenn der Wertebereich sofort entfernt werden sollte; andernfalls false.

Ausnahmen

ArgumentNullException

path oder force ist null.

ArgumentException

Der durch path angegebene Wertebereich kann nicht in der Auflistung gefunden werden.

InvalidOperationException

Der durch path angegebene Wertebereich kann nicht entfernt werden. Er ist entweder noch Bestandteil des aktiven Bereichs, oder der Zugriff wird verweigert.

IOException

Die Anforderung konnte aufgrund einer unerwarteten E/A-Ausnahme nicht ausgeführt werden.

- oder -

Der durch path angegebene Wertebereich kann nicht gelöscht werden.

ObjectDisposedException

Die Methode wurde aufgerufen, nachdem die Sequenz verworfen wurde.

OutOfMemoryException

Der Arbeitsspeicher reicht nicht aus, um die Ausführung des Programms fortzusetzen.

SequenceFullException

Die Datensatzsequenz ist voll.

UnauthorizedAccessException

Der Zugriff auf den angegebenen Protokollspeicher wird vom Betriebssystem verweigert.

Hinweise

Eine LogExtent-Instanz kann nur aus der Auflistung entfernt werden, wenn sie nicht Bestandteil des aktiven Bereichs des LogStore ist. Wenn der force-Parameter true lautet und der Wertebereich nicht sofort entfernt werden kann, wird eine Ausnahme ausgelöst. Wenn der force-Parameter false lautet und der Wertebereich nicht sofort entfernt werden kann, wird das Entfernen verzögert, bis der Wertebereich kein Bestandteil des aktiven Bereichs mehr ist.

Sie können den letzten Wertebereich in der LogExtentCollection nicht entfernen. Das bedeutet, dass die Count-Eigenschaft nicht 0 (null) sein kann, wenn ein Wertebereich hinzugefügt wurde.