FileRecordSequence.WriteRestartArea Метод

Определение

Пространство имен:

System.IO.Log

Сборка:

System.IO.Log.dll

Записывает область перезапуска в FileRecordSequence.

Перегрузки

WriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection)	Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.
WriteRestartArea(ArraySegment<Byte>)	Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.
WriteRestartArea(IList<ArraySegment<Byte>>)	Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.
WriteRestartArea(ArraySegment<Byte>, SequenceNumber)	Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.
WriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber)	Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.
WriteRestartArea(IList<ArraySegment<Byte>>, SequenceNumber, ReservationCollection)	Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.

Комментарии

Область перезапуска можно использовать для временного хранения сведений, содержащих последнюю операцию контрольной точки клиента. Если требуется выполнить восстановление, можно прочитать область перезапуска и извлечь все данные с последней операции контрольной точки. Эти данные инициализирует таблицу транзакций, таблицу "грязных страниц" и таблицу открытых файлов, чтобы их можно было использовать в процессе восстановления.

Чтение области перезапуска возможно с помощью метода ReadRestartAreas.

WriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection)

Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.

public:
 virtual System::IO::Log::SequenceNumber WriteRestartArea(ArraySegment<System::Byte> data, System::IO::Log::SequenceNumber newBaseSeqNum, System::IO::Log::ReservationCollection ^ reservations);

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

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

Public Function WriteRestartArea (data As ArraySegment(Of Byte), newBaseSeqNum As SequenceNumber, reservations As ReservationCollection) As SequenceNumber

Параметры

data

ArraySegment<Byte>

Список фрагментов массива байтов, которые будут сцеплены и добавлены в качестве записи.

newBaseSeqNum

SequenceNumber

Новый базовый порядковый номер. Заданный порядковый номер должен быть больше или равен текущему базовому порядковому номеру.

reservations

ReservationCollection

Коллекция ReservationCollection, содержащая резервирование, которое следует использовать для данной области перезапуска.

Возвращаемое значение

SequenceNumber

Порядковый номер записанной области перезапуска.

Реализации

WriteRestartArea(ArraySegment<Byte>, SequenceNumber, ReservationCollection)

Исключения

ArgumentNullException

Один или несколько аргументов имеют значение null.

ArgumentOutOfRangeException

Значение параметра newBaseSeqNum не лежит между основным и последним порядковыми номерами этой последовательности.

-или-

Новая или существующая архивная цепочка или база активного журнала недействительна.

ArgumentException

Параметр reservations не был создан этой последовательностью записи.

-или-

Значение параметра newBaseSeqNum недопустимо для этой последовательности.

NotSupportedException

Невозможно выполнить операцию, поскольку последовательность записей была открыта с доступом только для чтения.

IOException

Выполнить запрос невозможно из-за непредвиденного исключения ввода-вывода.

ObjectDisposedException

Метод был вызван после удаления последовательности.

OutOfMemoryException

Недостаточно памяти, чтобы продолжить выполнение программы.

SequenceFullException

Последовательность записей заполнена.

ReservationNotFoundException

В data не удается найти резервирование, достаточное для размещения параметра reservations.

Комментарии

Область перезапуска можно использовать для временного хранения сведений, содержащих последнюю операцию контрольной точки клиента. Если требуется выполнить восстановление, можно прочитать область перезапуска и извлечь все данные с последней операции контрольной точки. Эти данные инициализирует таблицу транзакций, таблицу "грязных страниц" и таблицу открытых файлов, чтобы их можно было использовать в процессе восстановления.

Чтение области перезапуска возможно с помощью метода ReadRestartAreas.

При записи области перезапуска данные в этих фрагментах массива байтов сцепляются в единый массив байтов для добавления в качестве записи. Не делается никаких допущений об обратном разделении данных на фрагменты массива при чтении области перезапуска.

Если задано резервирование, записанная область перезапуска будет занимать место, ранее зарезервированное с помощью содержащегося в коллекции резервирования. Если метод завершается успешно, будет занята минимальная область резервирования, в которой поместятся данные, а эта область резервирования будет удалена из коллекции.

При успешном выполнении этого метода базовый порядковый номер обновляется. Все записи журнала с порядковыми номерами меньшими, чем новый базовый порядковый номер, недоступны.

Если последовательность записей была удалена, или если передается неверный аргумент, исключения создаются немедленно, в пределах данной операции. Ошибки, возникшие при выполнении запроса асинхронного добавления, например ошибка диска в процессе запроса ввода-вывода, приводят к созданию исключений при вызове метода EndReserveAndAppend.

WriteRestartArea(ArraySegment<Byte>)

Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.

public:
 virtual 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
override this.WriteRestartArea : ArraySegment<byte> -> System.IO.Log.SequenceNumber

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

Параметры

data

ArraySegment<Byte>

Список фрагментов массива байтов, которые будут сцеплены и добавлены в качестве записи.

Возвращаемое значение

SequenceNumber

Порядковый номер записанной области перезапуска.

Реализации

WriteRestartArea(ArraySegment<Byte>)

Исключения

ArgumentNullException

Один или несколько аргументов имеют значение null.

NotSupportedException

Невозможно выполнить операцию, поскольку последовательность записей была открыта с доступом только для чтения.

IOException

Выполнить запрос невозможно из-за непредвиденного исключения ввода-вывода.

ObjectDisposedException

Метод был вызван после удаления последовательности.

OutOfMemoryException

Недостаточно памяти, чтобы продолжить выполнение программы.

SequenceFullException

Последовательность записей заполнена.

Комментарии

Область перезапуска можно использовать для временного хранения сведений, содержащих последнюю операцию контрольной точки клиента. Если требуется выполнить восстановление, можно прочитать область перезапуска и извлечь все данные с последней операции контрольной точки. Эти данные инициализирует таблицу транзакций, таблицу "грязных страниц" и таблицу открытых файлов, чтобы их можно было использовать в процессе восстановления.

Чтение области перезапуска возможно с помощью метода ReadRestartAreas.

Данные в этих фрагментах массива байтов будут сцеплены в единый массив байтов для добавления в качестве записи. Не делается никаких допущений об обратном разделении данных на фрагменты массива при чтении области перезапуска.

WriteRestartArea(IList<ArraySegment<Byte>>)

Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.

public:
 virtual 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
override this.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

Порядковый номер записанной области перезапуска.

Реализации

WriteRestartArea(IList<ArraySegment<Byte>>)

Исключения

ArgumentNullException

Один или несколько аргументов имеют значение null.

NotSupportedException

Невозможно выполнить операцию, поскольку последовательность записей была открыта с доступом только для чтения.

IOException

Выполнить запрос невозможно из-за непредвиденного исключения ввода-вывода.

ObjectDisposedException

Метод был вызван после удаления последовательности.

OutOfMemoryException

Недостаточно памяти, чтобы продолжить выполнение программы.

SequenceFullException

Последовательность записей заполнена.

Комментарии

Область перезапуска можно использовать для временного хранения сведений, содержащих последнюю операцию контрольной точки клиента. Если требуется выполнить восстановление, можно прочитать область перезапуска и извлечь все данные с последней операции контрольной точки. Эти данные инициализирует таблицу транзакций, таблицу "грязных страниц" и таблицу открытых файлов, чтобы их можно было использовать в процессе восстановления.

Чтение области перезапуска возможно с помощью метода ReadRestartAreas.

Данные в этих фрагментах массива байтов будут сцеплены в единый массив байтов для добавления в качестве записи. Не делается никаких допущений об обратном разделении данных на фрагменты массива при чтении области перезапуска.

WriteRestartArea(ArraySegment<Byte>, SequenceNumber)

Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.

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

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

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

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

Параметры

data

ArraySegment<Byte>

Список фрагментов массива байтов, которые будут сцеплены и добавлены в качестве записи.

newBaseSeqNum

SequenceNumber

Новый базовый порядковый номер. Заданный порядковый номер должен быть больше или равен текущему базовому порядковому номеру.

Возвращаемое значение

SequenceNumber

Порядковый номер записанной области перезапуска.

Реализации

WriteRestartArea(ArraySegment<Byte>, SequenceNumber)

Исключения

ArgumentNullException

Один или несколько аргументов имеют значение null.

ArgumentOutOfRangeException

Значение параметра newBaseSeqNum не лежит между основным и последним порядковыми номерами этой последовательности.

-или-

Новая или существующая архивная цепочка или база активного журнала недействительна.

ArgumentException

Значение параметра newBaseSeqNum недопустимо для этой последовательности.

NotSupportedException

Невозможно выполнить операцию, поскольку последовательность записей была открыта с доступом только для чтения.

IOException

Выполнить запрос невозможно из-за непредвиденного исключения ввода-вывода.

ObjectDisposedException

Метод был вызван после удаления последовательности.

OutOfMemoryException

Недостаточно памяти, чтобы продолжить выполнение программы.

SequenceFullException

Последовательность записей заполнена.

Комментарии

Область перезапуска можно использовать для временного хранения сведений, содержащих последнюю операцию контрольной точки клиента. Если требуется выполнить восстановление, можно прочитать область перезапуска и извлечь все данные с последней операции контрольной точки. Эти данные инициализирует таблицу транзакций, таблицу "грязных страниц" и таблицу открытых файлов, чтобы их можно было использовать в процессе восстановления.

Чтение области перезапуска возможно с помощью метода ReadRestartAreas.

При записи области перезапуска данные в этих фрагментах массива байтов сцепляются в единый массив байтов для добавления в качестве записи. Не делается никаких допущений об обратном разделении данных на фрагменты массива при чтении области перезапуска.

При успешном выполнении этого метода базовый порядковый номер обновляется. Все записи журнала с порядковыми номерами меньшими, чем новый базовый порядковый номер, недоступны.

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

Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.

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

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

abstract member WriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber -> System.IO.Log.SequenceNumber
override this.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)), newBaseSeqNum As SequenceNumber) As SequenceNumber

Параметры

data

IList<ArraySegment<Byte>>

Список фрагментов массива байтов, которые будут сцеплены и добавлены в качестве записи.

newBaseSeqNum

SequenceNumber

Новый базовый порядковый номер. Заданный порядковый номер должен быть больше или равен текущему базовому порядковому номеру.

Возвращаемое значение

SequenceNumber

Порядковый номер записанной области перезапуска.

Реализации

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

Исключения

ArgumentNullException

Один или несколько аргументов имеют значение null.

ArgumentOutOfRangeException

Значение параметра newBaseSeqNum не лежит между основным и последним порядковыми номерами этой последовательности.

-или-

Новая или существующая архивная цепочка или база активного журнала недействительна.

ArgumentException

Значение параметра newBaseSeqNum недопустимо для этой последовательности.

NotSupportedException

Невозможно выполнить операцию, поскольку последовательность записей была открыта с доступом только для чтения.

IOException

Выполнить запрос невозможно из-за непредвиденного исключения ввода-вывода.

ObjectDisposedException

Метод был вызван после удаления последовательности.

OutOfMemoryException

Недостаточно памяти, чтобы продолжить выполнение программы.

SequenceFullException

Последовательность записей заполнена.

Комментарии

Область перезапуска можно использовать для временного хранения сведений, содержащих последнюю операцию контрольной точки клиента. Если требуется выполнить восстановление, можно прочитать область перезапуска и извлечь все данные с последней операции контрольной точки. Эти данные инициализирует таблицу транзакций, таблицу "грязных страниц" и таблицу открытых файлов, чтобы их можно было использовать в процессе восстановления.

Чтение области перезапуска возможно с помощью метода ReadRestartAreas.

При записи области перезапуска данные в этих фрагментах массива байтов сцепляются в единый массив байтов для добавления в качестве записи. Не делается никаких допущений об обратном разделении данных на фрагменты массива при чтении области перезапуска.

При успешном выполнении этого метода базовый порядковый номер обновляется. Все записи журнала с порядковыми номерами меньшими, чем новый базовый порядковый номер, недоступны.

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

Записывает область перезапуска в FileRecordSequence. Этот метод не может быть унаследован.

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

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

abstract member WriteRestartArea : System.Collections.Generic.IList<ArraySegment<byte>> * System.IO.Log.SequenceNumber * System.IO.Log.ReservationCollection -> System.IO.Log.SequenceNumber
override this.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)), newBaseSeqNum As SequenceNumber, reservations As ReservationCollection) As SequenceNumber

Параметры

data

IList<ArraySegment<Byte>>

Список фрагментов массива байтов, которые будут сцеплены и добавлены в качестве записи.

newBaseSeqNum

SequenceNumber

Новый базовый порядковый номер. Заданный порядковый номер должен быть больше или равен текущему базовому порядковому номеру.

reservations

ReservationCollection

Коллекция ReservationCollection, содержащая резервирование, которое следует использовать для данной области перезапуска.

Возвращаемое значение

SequenceNumber

Порядковый номер записанной области перезапуска.

Реализации

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

Исключения

ArgumentNullException

Один или несколько аргументов имеют значение null.

ArgumentOutOfRangeException

Значение параметра newBaseSeqNum не лежит между основным и последним порядковыми номерами этой последовательности.

-или-

Новая или существующая архивная цепочка или база активного журнала недействительна.

ArgumentException

Параметр reservations не был создан этой последовательностью записи.

-или-

Значение параметра newBaseSeqNum недопустимо для этой последовательности.

NotSupportedException

Невозможно выполнить операцию, поскольку последовательность записей была открыта с доступом только для чтения.

IOException

Выполнить запрос невозможно из-за непредвиденного исключения ввода-вывода.

ObjectDisposedException

Метод был вызван после удаления последовательности.

OutOfMemoryException

Недостаточно памяти, чтобы продолжить выполнение программы.

SequenceFullException

Последовательность записей заполнена.

ReservationNotFoundException

В data не удается найти резервирование, достаточное для размещения параметра reservations.

Комментарии

Область перезапуска можно использовать для временного хранения сведений, содержащих последнюю операцию контрольной точки клиента. Если требуется выполнить восстановление, можно прочитать область перезапуска и извлечь все данные с последней операции контрольной точки. Эти данные инициализирует таблицу транзакций, таблицу "грязных страниц" и таблицу открытых файлов, чтобы их можно было использовать в процессе восстановления.

Чтение области перезапуска возможно с помощью метода ReadRestartAreas.

При записи области перезапуска данные в этих фрагментах массива байтов сцепляются в единый массив байтов для добавления в качестве записи. Не делается никаких допущений об обратном разделении данных на фрагменты массива при чтении области перезапуска.

Если задано резервирование, записанная область перезапуска будет занимать место, ранее зарезервированное с помощью содержащегося в коллекции резервирования. Если метод завершается успешно, будет занята минимальная область резервирования, в которой поместятся данные, а эта область резервирования будет удалена из коллекции.

При успешном выполнении этого метода базовый порядковый номер обновляется. Все записи журнала с порядковыми номерами меньшими, чем новый базовый порядковый номер, недоступны.

Если последовательность записей была удалена, или если передается неверный аргумент, исключения создаются немедленно, в пределах данной операции. Ошибки, возникшие при выполнении запроса асинхронного добавления, например ошибка диска в процессе запроса ввода-вывода, приводят к созданию исключений при вызове метода EndReserveAndAppend.