LogExtentCollection.Remove 方法

定義

命名空間:

System.IO.Log

組件:

System.IO.Log.dll

移除集合中的 LogExtent 執行個體。

多載

Remove(LogExtent, Boolean)	移除集合中的指定 LogExtent 執行個體。
Remove(String, Boolean)	移除集合中具有指定路徑的 LogExtent 執行個體。

Remove(LogExtent, Boolean)

移除集合中的指定 LogExtent 執行個體。

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)

參數

extent

LogExtent

要移除的 LogExtent 執行個體。

force

Boolean

如果要立即移除延伸區則為 true，否則為 false。

例外狀況

ArgumentNullException

extent 或 force 為 null。

ArgumentException

在集合中找不到 extent。

InvalidOperationException

無法移除 extent。 該延伸區仍是使用中區域的一部分，或是存取遭拒。

IOException

由於意外的 I/O 例外狀況，所以無法執行要求。

-或-

無法刪除 extent。

ObjectDisposedException

已在處置序列之後呼叫此方法。

OutOfMemoryException

沒有足夠的記憶體可以繼續執行程式。

SequenceFullException

記錄順序已滿。

UnauthorizedAccessException

存取指定的記錄存放區遭作業系統拒絕。

備註

只有在 LogExtent 執行個體不屬於 LogStore 使用中區域的一部分時，才能將其從集合中移除。 如果 force 參數為 true，而且無法立即移除延伸區，就會擲回例外狀況。 如果 force 參數為 false，而且無法立即移除延伸區，該移除作業會延後，直到該延伸區不再屬於使用中區域的一部分為止。

LogExtentCollection 中的最後一個延伸區無法移除，意指 Count 屬性在新增延伸區之後不可以為零。

Remove(String, Boolean)

移除集合中具有指定路徑的 LogExtent 執行個體。

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)

參數

path

String

要移除之 LogExtent 的路徑。

force

Boolean

如果要立即移除延伸區則為 true，否則為 false。

例外狀況

ArgumentNullException

path 或 force 為 null。

ArgumentException

在集合中找不到 path 指定的延伸區。

InvalidOperationException

無法移除 path 指定的延伸區。 該延伸區仍是使用中區域的一部分，或是存取遭拒。

IOException

由於意外的 I/O 例外狀況，所以無法執行要求。

-或-

無法刪除 path 指定的延伸區。

ObjectDisposedException

已在處置序列之後呼叫此方法。

OutOfMemoryException

沒有足夠的記憶體可以繼續執行程式。

SequenceFullException

記錄順序已滿。

UnauthorizedAccessException

存取指定的記錄存放區遭作業系統拒絕。

備註

只有在 LogExtent 執行個體不屬於 LogStore 使用中區域的一部分時，才能將其從集合中移除。 如果 force 參數為 true，而且無法立即移除延伸區，就會擲回例外狀況。 如果 force 參數為 false，而且無法立即移除延伸區，該移除作業會延後，直到該延伸區不再屬於使用中區域的一部分為止。

LogExtentCollection 中的最後一個延伸區無法移除，意指 Count 屬性在新增延伸區之後不可以為零。