IRecordSequence.WriteRestartArea 方法

定義

命名空間:

System.IO.Log

組件:

System.IO.Log.dll

在衍生類別中覆寫時，將重新啟動區域寫入至 IRecordSequence。

多載

WriteRestartArea(ArraySegment<Byte>)	在衍生類別中覆寫時，將重新啟動區域寫入至 IRecordSequence。
WriteRestartArea(IList<ArraySegment<Byte>>)	在衍生類別中覆寫時，將重新啟動區域寫入至 IRecordSequence。
WriteRestartArea(ArraySegment<Byte>, SequenceNumber)	在衍生類別中覆寫時，將重新啟動區域寫入 IRecordSequence 並更新基底序號。
WriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber)	在衍生類別中覆寫時，將重新啟動區域寫入 IRecordSequence 並更新基底序號。
WriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection)	在衍生類別中覆寫時，使用保留將重新啟動區域寫入 IRecordSequence，並更新基底序號。
WriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection)	在衍生類別中覆寫時，使用保留將重新啟動區域寫入 IRecordSequence，並更新基底序號。

備註

重新啟動區域可用來暫時儲存包含客戶端最後一個檢查點作業的資訊。 需要復原時，您可以剖析重新啟動區域，以從最後一個檢查點作業擷取所有數據。 此數據會初始化異動數據表、髒頁數據表和開啟的檔案數據表，使其可用於復原程式。 您可以使用 ReadRestartAreas 方法來讀取重新啟動區域。

WriteRestartArea(ArraySegment<Byte>)

在衍生類別中覆寫時，將重新啟動區域寫入至 IRecordSequence。

public:
 System::IO::Log::SequenceNumber WriteRestartArea(ArraySegment<System::Byte> data);

public System.IO.Log.SequenceNumber WriteRestartArea (ArraySegment<byte> data);

abstract member WriteRestartArea : ArraySegment<byte> -> System.IO.Log.SequenceNumber

Public Function WriteRestartArea (data As ArraySegment(Of Byte)) As SequenceNumber

參數

data

ArraySegment<Byte>

將串連並附加為記錄的位元組陣列區段清單。

傳回

SequenceNumber

寫入的重新啟動區域的序號。

例外狀況

ArgumentException

一或多個自變數無效。

IOException

寫入重新啟動區域時發生 I/O 錯誤。

SequenceFullException

記錄序列無法提供足夠的可用空間來包含新的重新啟動區域。

ObjectDisposedException

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

備註

重新啟動區域可用來暫時儲存包含客戶端最後一個檢查點作業的資訊。 通用記錄檔系統 （CLFS） 會維護兩個重新啟動區域，以確保至少有一個有效區域一律可用。 需要復原時，CLFS 會讀取其重新啟動區域，以及來自最後一個檢查點作業的所有數據。 此數據會初始化異動數據表、髒頁數據表和開啟的檔案數據表，使其可用於復原程式。

您可以使用 ReadRestartAreas 方法來讀取重新啟動區域。

位元組陣列區段中的數據將會串連成單一位元陣陣列，以附加為記錄。 當讀取重新啟動區域時，不會布建將數據分割回數位區段。

WriteRestartArea(IList<ArraySegment<Byte>>)

在衍生類別中覆寫時，將重新啟動區域寫入至 IRecordSequence。

public:
 System::IO::Log::SequenceNumber WriteRestartArea(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data);

public System.IO.Log.SequenceNumber WriteRestartArea (System.Collections.Generic.IList<ArraySegment<byte>> data);

abstract member WriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> -> System.IO.Log.SequenceNumber

Public Function WriteRestartArea (data As IList(Of ArraySegment(Of Byte))) As SequenceNumber

參數

data

IList<ArraySegment<Byte>>

將串連並附加為記錄的位元組陣列區段清單。

傳回

SequenceNumber

寫入的重新啟動區域的序號。

例外狀況

ArgumentException

一或多個自變數無效。

IOException

寫入重新啟動區域時發生 I/O 錯誤。

SequenceFullException

記錄序列無法提供足夠的可用空間來包含新的重新啟動區域。

ObjectDisposedException

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

備註

重新啟動區域可用來暫時儲存包含客戶端最後一個檢查點作業的資訊。 需要復原時，您可以剖析重新啟動區域，以從最後一個檢查點作業擷取所有數據。 此數據會初始化異動數據表、髒頁數據表和開啟的檔案數據表，使其可用於復原程式。 您可以使用 ReadRestartAreas 方法來讀取重新啟動區域。

位元組陣列區段中的數據將會串連成單一位元陣陣列，以附加為記錄。 當讀取重新啟動區域時，不會布建將數據分割回數位區段。

WriteRestartArea(ArraySegment<Byte>, SequenceNumber)

在衍生類別中覆寫時，將重新啟動區域寫入 IRecordSequence 並更新基底序號。

public:
 System::IO::Log::SequenceNumber WriteRestartArea(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber newBaseSequenceNumber);

public System.IO.Log.SequenceNumber WriteRestartArea (ArraySegment<byte> data, System.IO.Log.SequenceNumber newBaseSequenceNumber);

abstract member WriteRestartArea : ArraySegment<byte> * System.IO.Log.SequenceNumber -> System.IO.Log.SequenceNumber

Public Function WriteRestartArea (data As ArraySegment(Of Byte), newBaseSequenceNumber As SequenceNumber) As SequenceNumber

參數

data

ArraySegment<Byte>

將串連並附加為記錄的位元組陣列區段清單。

newBaseSequenceNumber

SequenceNumber

新的基底序號。 指定的序號必須大於或等於目前的基底序號。

傳回

SequenceNumber

寫入的重新啟動區域的序號。

例外狀況

ArgumentException

一或多個自變數無效。

IOException

寫入重新啟動區域時發生 I/O 錯誤。

SequenceFullException

記錄序列無法提供足夠的可用空間來包含新的重新啟動區域。

ObjectDisposedException

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

備註

重新啟動區域可用來暫時儲存包含客戶端最後一個檢查點作業的資訊。 需要復原時，您可以剖析重新啟動區域，以從最後一個檢查點作業擷取所有數據。 此數據會初始化異動數據表、髒頁數據表和開啟的檔案數據表，使其可用於復原程式。 您可以使用 ReadRestartAreas 方法來讀取重新啟動區域。

寫入重新啟動區域時，位元組數位段中的數據會串連成單一位元組陣列，以附加為記錄。 當讀取重新啟動區域時，不會布建將數據分割回數位區段。

當這個方法成功完成時，基底序號已更新。 無法存取序號小於新基底序號的所有記錄檔記錄。

WriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber)

在衍生類別中覆寫時，將重新啟動區域寫入 IRecordSequence 並更新基底序號。

public:
 System::IO::Log::SequenceNumber WriteRestartArea(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber newBaseSequenceNumber);

public System.IO.Log.SequenceNumber WriteRestartArea (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber newBaseSequenceNumber);

abstract member WriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber -> System.IO.Log.SequenceNumber

Public Function WriteRestartArea (data As IList(Of ArraySegment(Of Byte)), newBaseSequenceNumber As SequenceNumber) As SequenceNumber

參數

data

IList<ArraySegment<Byte>>

將串連並附加為記錄的位元組陣列區段清單。

newBaseSequenceNumber

SequenceNumber

新的基底序號。 指定的序號必須大於或等於目前的基底序號。

傳回

SequenceNumber

寫入的重新啟動區域的序號。

例外狀況

ArgumentException

一或多個自變數無效。

IOException

寫入重新啟動區域時發生 I/O 錯誤。

SequenceFullException

記錄序列無法提供足夠的可用空間來包含新的重新啟動區域。

ObjectDisposedException

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

備註

重新啟動區域可用來暫時儲存包含客戶端最後一個檢查點作業的資訊。 需要復原時，您可以剖析重新啟動區域，以從最後一個檢查點作業擷取所有數據。 此數據會初始化異動數據表、髒頁數據表和開啟的檔案數據表，使其可用於復原程式。 您可以使用 ReadRestartAreas 方法來讀取重新啟動區域。

寫入重新啟動區域時，位元組數位段中的數據會串連成單一位元組陣列，以附加為記錄。 當讀取重新啟動區域時，不會布建將數據分割回數位區段。

當這個方法成功完成時，基底序號已更新。 無法存取序號小於新基底序號的所有記錄檔記錄。

WriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection)

在衍生類別中覆寫時，使用保留將重新啟動區域寫入 IRecordSequence，並更新基底序號。

public:
 System::IO::Log::SequenceNumber WriteRestartArea(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation);

public System.IO.Log.SequenceNumber WriteRestartArea (ArraySegment<byte> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, System.IO.Log.ReservationCollection reservation);

abstract member WriteRestartArea : ArraySegment<byte> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumber

Public Function WriteRestartArea (data As ArraySegment(Of Byte), newBaseSequenceNumber As SequenceNumber, reservation As ReservationCollection) As SequenceNumber

參數

data

ArraySegment<Byte>

將串連並附加為記錄的位元組陣列區段清單。

newBaseSequenceNumber

SequenceNumber

新的基底序號。 指定的序號必須大於或等於目前的基底序號。

reservation

ReservationCollection

ReservationCollection，其中包含應該用於此重新啟動區域的保留。

傳回

SequenceNumber

寫入的重新啟動區域的序號。

例外狀況

ArgumentException

一或多個自變數無效。

IOException

寫入重新啟動區域時發生 I/O 錯誤。

SequenceFullException

記錄序列無法提供足夠的可用空間來包含新的重新啟動區域。

ObjectDisposedException

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

備註

重新啟動區域可用來暫時儲存包含客戶端最後一個檢查點作業的資訊。 需要復原時，您可以剖析重新啟動區域，以從最後一個檢查點作業擷取所有數據。 此數據會初始化異動數據表、髒頁數據表和開啟的檔案數據表，使其可用於復原程式。 您可以使用 ReadRestartAreas 方法來讀取重新啟動區域。

寫入重新啟動區域時，位元組數位段中的數據會串連成單一位元組陣列，以附加為記錄。 當讀取重新啟動區域時，不會布建將數據分割回數位區段。

如果指定保留，則寫入的重新啟動區域會使用集合中包含的保留來耗用先前保留的空間。 如果方法成功，它會取用可包含數據的最小保留，並將該保留從集合中移除。

當這個方法成功完成時，基底序號已更新。 無法存取序號小於新基底序號的所有記錄檔記錄。

如果已處置記錄序列，或如果您傳遞無效的自變數，則會立即在此作業內擲回例外狀況。 異步附加要求期間發生的錯誤，例如 I/O 要求期間的磁碟失敗，會導致呼叫 EndReserveAndAppend 方法時擲回例外狀況。

WriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection)

在衍生類別中覆寫時，使用保留將重新啟動區域寫入 IRecordSequence，並更新基底序號。

public:
 System::IO::Log::SequenceNumber WriteRestartArea(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ data, System::IO::Log::SequenceNumber newBaseSequenceNumber, System::IO::Log::ReservationCollection ^ reservation);

public System.IO.Log.SequenceNumber WriteRestartArea (System.Collections.Generic.IList<ArraySegment<byte>> data, System.IO.Log.SequenceNumber newBaseSequenceNumber, System.IO.Log.ReservationCollection reservation);

abstract member WriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumber

Public Function WriteRestartArea (data As IList(Of ArraySegment(Of Byte)), newBaseSequenceNumber As SequenceNumber, reservation As ReservationCollection) As SequenceNumber

參數

data

IList<ArraySegment<Byte>>

將串連並附加為記錄的位元組陣列區段清單。

newBaseSequenceNumber

SequenceNumber

新的基底序號。 指定的序號必須大於或等於目前的基底序號。

reservation

ReservationCollection

ReservationCollection，其中包含應該用於此重新啟動區域的保留。

傳回

SequenceNumber

寫入的重新啟動區域的序號。

例外狀況

ArgumentException

一或多個自變數無效。

IOException

寫入重新啟動區域時發生 I/O 錯誤。

SequenceFullException

記錄序列無法提供足夠的可用空間來包含新的重新啟動區域。

ObjectDisposedException

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

備註

重新啟動區域可用來暫時儲存包含客戶端最後一個檢查點作業的資訊。 需要復原時，您可以剖析重新啟動區域，以從最後一個檢查點作業擷取所有數據。 此數據會初始化異動數據表、髒頁數據表和開啟的檔案數據表，使其可用於復原程式。 您可以使用 ReadRestartAreas 方法來讀取重新啟動區域。

寫入重新啟動區域時，位元組數位段中的數據會串連成單一位元組陣列，以附加為記錄。 當讀取重新啟動區域時，不會布建將數據分割回數位區段。

如果指定保留，則寫入的重新啟動區域會使用集合中包含的保留來耗用先前保留的空間。 如果方法成功，它會取用可包含數據的最小保留，並將該保留從集合中移除。

當這個方法成功完成時，基底序號已更新。 無法存取序號小於新基底序號的所有記錄檔記錄。

如果已處置記錄序列，或如果您傳遞無效的自變數，則會立即在此作業內擲回例外狀況。 異步附加要求期間發生的錯誤，例如 I/O 要求期間的磁碟失敗，會導致呼叫 EndReserveAndAppend 方法時擲回例外狀況。