LogRecordSequence Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса LogRecordSequence.
Перегрузки
LogRecordSequence(LogStore) |
Инициализирует новый экземпляр класса LogRecordSequence с указанным хранилищем журналов. |
LogRecordSequence(String, FileMode) |
Инициализирует новый экземпляр класса LogRecordSequence с указанным путем к хранилищу журналов и режимом доступа. |
LogRecordSequence(LogStore, Int32, Int32) |
Инициализирует новый экземпляр класса LogRecordSequence с указанным хранилищем журналов, размером буфера и количеством буферов. |
LogRecordSequence(String, FileMode, FileAccess) |
Инициализирует новый экземпляр класса LogRecordSequence с указанным путем к хранилищу журналов и режимами доступа и общего доступа. |
LogRecordSequence(String, FileMode, FileAccess, FileShare) |
Инициализирует новый экземпляр класса LogRecordSequence с указанным путем к хранилищу журналов и режимом доступа. |
LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32) |
Инициализирует новый экземпляр класса LogRecordSequence с указанным путем к хранилищу журналов, разрешением для файлов, а также размером и количеством буферов для записей. |
LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32, FileSecurity) |
Инициализирует новый экземпляр класса LogRecordSequence. |
LogRecordSequence(LogStore)
Инициализирует новый экземпляр класса LogRecordSequence с указанным хранилищем журналов.
public:
LogRecordSequence(System::IO::Log::LogStore ^ logStore);
public LogRecordSequence (System.IO.Log.LogStore logStore);
new System.IO.Log.LogRecordSequence : System.IO.Log.LogStore -> System.IO.Log.LogRecordSequence
Public Sub New (logStore As LogStore)
Параметры
Исключения
logStore
недопустим.
Комментарии
Размер буфера определяет максимальный размер записи, которую можно добавить или прочитать. В этом конструкторе по умолчанию задано значение 64. Для требуемого количества буферов задано значение 10.
Применяется к
LogRecordSequence(String, FileMode)
Инициализирует новый экземпляр класса LogRecordSequence с указанным путем к хранилищу журналов и режимом доступа.
public:
LogRecordSequence(System::String ^ path, System::IO::FileMode mode);
public LogRecordSequence (string path, System.IO.FileMode mode);
new System.IO.Log.LogRecordSequence : string * System.IO.FileMode -> System.IO.Log.LogRecordSequence
Public Sub New (path As String, mode As FileMode)
Параметры
- path
- String
Относительный или абсолютный путь к базовому файлу хранилища журналов для открытия.
- mode
- FileMode
Одно из значений FileMode, с помощью которого можно определить способ открытия или создания хранилища.
Исключения
path
имеет значение null
.
Параметр path
является пустой строкой ("").
-или-
Параметр path
содержит только пробелы.
-или-
Параметр path
содержит один или несколько недопустимых символов.
Параметр mode
содержит недопустимое значение.
Не удается найти файл.
При открытии хранилища журналов произошла ошибка ввода-вывода.
Доступ к заданной последовательности журнала запрещен операционной системой.
Эта операция не поддерживается.
Недостаточно памяти, чтобы продолжить выполнение программы.
Невозможно использовать LogRecordSequence, так как не установлен требуемый компонент CLFS. Установите компонент CLFS, если он доступен на платформе, или используйте класс FileRecordSequence.
Комментарии
Этот конструктор инициализирует новый экземпляр LogRecordSequence в новом объекте LogStore, который открывается с указанным путем и режимом. Хранилищу предоставляется доступ на чтение и запись, и оно открывается с общим доступом на чтение.
Применяется к
LogRecordSequence(LogStore, Int32, Int32)
Инициализирует новый экземпляр класса LogRecordSequence с указанным хранилищем журналов, размером буфера и количеством буферов.
public:
LogRecordSequence(System::IO::Log::LogStore ^ logStore, int bufferSize, int bufferCount);
public LogRecordSequence (System.IO.Log.LogStore logStore, int bufferSize, int bufferCount);
new System.IO.Log.LogRecordSequence : System.IO.Log.LogStore * int * int -> System.IO.Log.LogRecordSequence
Public Sub New (logStore As LogStore, bufferSize As Integer, bufferCount As Integer)
Параметры
- bufferSize
- Int32
Требуемый размер буфера в байтах. Размер буфера определяет максимальный размер записи, которую можно добавить или прочитать.
- bufferCount
- Int32
Требуемое количество буферов.
Исключения
logStore
имеет значение null
.
Параметр bufferSize
имеет отрицательное значение или равен нулю.
-или-
Параметр bufferCount
имеет отрицательное значение или равен нулю.
Комментарии
Используйте этот конструктор, если необходимо указать значения для параметров bufferSize
и bufferCount
, а не использовать значение по умолчанию — 64 для bufferSize
и 10 для bufferCount
.
Применяется к
LogRecordSequence(String, FileMode, FileAccess)
Инициализирует новый экземпляр класса LogRecordSequence с указанным путем к хранилищу журналов и режимами доступа и общего доступа.
public:
LogRecordSequence(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);
public LogRecordSequence (string path, System.IO.FileMode mode, System.IO.FileAccess access);
new System.IO.Log.LogRecordSequence : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.Log.LogRecordSequence
Public Sub New (path As String, mode As FileMode, access As FileAccess)
Параметры
- path
- String
Относительный или абсолютный путь к базовому файлу хранилища журналов для открытия.
- mode
- FileMode
Одно из значений FileMode, с помощью которого можно определить способ открытия или создания хранилища.
- access
- FileAccess
Одно из значений FileAccess, определяющее, каким образом объект LogStore может получить доступ к файлу.
Исключения
path
имеет значение null
.
Параметр path
является пустой строкой ("").
-или-
Параметр path
содержит только пробелы.
-или-
Параметр path
содержит один или несколько недопустимых символов.
Параметр mode
содержит недопустимое значение.
Не удается найти файл.
При открытии хранилища журналов произошла ошибка ввода-вывода.
Доступ к заданной последовательности журнала запрещен операционной системой.
Эта операция не поддерживается.
Недостаточно памяти, чтобы продолжить выполнение программы.
Невозможно использовать LogRecordSequence, так как не установлен требуемый компонент CLFS. Установите компонент CLFS, если он доступен на платформе, или используйте класс FileRecordSequence.
Комментарии
Этот конструктор инициализирует новый экземпляр LogRecordSequence в новом объекте LogStore, который открывается с указанным путем, режимом и доступом. Хранилище открывается с общим доступом для чтения.
Применяется к
LogRecordSequence(String, FileMode, FileAccess, FileShare)
Инициализирует новый экземпляр класса LogRecordSequence с указанным путем к хранилищу журналов и режимом доступа.
public:
LogRecordSequence(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);
public LogRecordSequence (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);
new System.IO.Log.LogRecordSequence : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.Log.LogRecordSequence
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)
Параметры
- path
- String
Относительный или абсолютный путь к базовому файлу хранилища журналов для открытия.
- mode
- FileMode
Одно из значений FileMode, с помощью которого можно определить способ открытия или создания хранилища.
- access
- FileAccess
Одно из значений FileAccess, определяющее, каким образом объект LogStore может получить доступ к файлу.
- share
- FileShare
Одно из значений FileShare, с помощью которых можно определить, как процессы будут совместно использовать хранилище журнала.
Исключения
path
имеет значение null
.
Параметр path
является пустой строкой ("").
-или-
Параметр path
содержит только пробелы.
-или-
Параметр path
содержит один или несколько недопустимых символов.
Параметр mode
содержит недопустимое значение.
Не удается найти файл.
При открытии хранилища журналов произошла ошибка ввода-вывода.
Доступ к заданной последовательности журнала запрещен операционной системой.
Эта операция не поддерживается.
Недостаточно памяти, чтобы продолжить выполнение программы.
Невозможно использовать LogRecordSequence, так как не установлен требуемый компонент CLFS. Установите компонент CLFS, если он доступен на платформе, или используйте класс FileRecordSequence.
Примеры
В этом примере показано, как использовать конструктор LogRecordSequence:
// Create a LogRecordSequence.
sequence = new LogRecordSequence(this.logName,
FileMode.CreateNew,
FileAccess.ReadWrite,
FileShare.None);
// At least one container/extent must be added for Log Record Sequence.
sequence.LogStore.Extents.Add(this.logContainer, this.containerSize);
MySequence = sequence;
' Create a LogRecordSequence.
sequence = New LogRecordSequence(Me.logName, FileMode.CreateNew, FileAccess.ReadWrite, FileShare.None)
' At least one container/extent must be added for Log Record Sequence.
sequence.LogStore.Extents.Add(Me.logContainer, Me.containerSize)
MySequence = sequence
Комментарии
Этот конструктор инициализирует новый экземпляр LogRecordSequence в новом объекте LogStore, который открывается с указанным путем, режимом и доступом. Хранилище открывается с общим указанным доступом.
Применяется к
LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32)
Инициализирует новый экземпляр класса LogRecordSequence с указанным путем к хранилищу журналов, разрешением для файлов, а также размером и количеством буферов для записей.
public:
LogRecordSequence(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, int bufferCount);
public LogRecordSequence (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, int bufferCount);
new System.IO.Log.LogRecordSequence : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * int -> System.IO.Log.LogRecordSequence
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, bufferCount As Integer)
Параметры
- path
- String
Относительный или абсолютный путь к базовому файлу хранилища журналов для открытия.
- mode
- FileMode
Одно из значений FileMode, с помощью которого можно определить способ открытия или создания хранилища.
- access
- FileAccess
Одно из значений FileAccess, определяющее, каким образом объект LogStore может получить доступ к файлу.
- share
- FileShare
Одно из значений FileShare, с помощью которых можно определить, как процессы будут совместно использовать хранилище журнала.
- bufferSize
- Int32
Требуемый размер буфера в байтах. Размер буфера определяет максимальный размер записи, которую можно добавить или прочитать.
- bufferCount
- Int32
Требуемое количество буферов.
Исключения
path
имеет значение null
.
Параметр path
является пустой строкой ("").
-или-
Параметр path
содержит только пробелы.
-или-
Параметр path
содержит один или несколько недопустимых символов.
Параметр mode
содержит недопустимое значение.
Не удается найти файл.
При открытии хранилища журналов произошла ошибка ввода-вывода.
Доступ к заданной последовательности журнала запрещен операционной системой.
Эта операция не поддерживается.
Недостаточно памяти, чтобы продолжить выполнение программы.
Невозможно использовать LogRecordSequence, так как не установлен требуемый компонент CLFS. Установите компонент CLFS, если он доступен на платформе, или используйте класс FileRecordSequence.
Комментарии
Этот конструктор инициализирует новый экземпляр LogRecordSequence в новом объекте LogStore, который открывается с указанным путем, режимом и доступом. Хранилище открывается с общим указанным доступом.
Применяется к
LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32, FileSecurity)
Инициализирует новый экземпляр класса LogRecordSequence.
public:
LogRecordSequence(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, int bufferCount, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public LogRecordSequence (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, int bufferCount, System.Security.AccessControl.FileSecurity fileSecurity);
new System.IO.Log.LogRecordSequence : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * int * System.Security.AccessControl.FileSecurity -> System.IO.Log.LogRecordSequence
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, bufferCount As Integer, fileSecurity As FileSecurity)
Параметры
- path
- String
Относительный или абсолютный путь к базовому файлу хранилища журналов для открытия.
- mode
- FileMode
Допустимое значение FileMode, с помощью которого можно определить способ открытия или создания хранилища.
- access
- FileAccess
Допустимое значение FileAccess, определяющее способ доступа к хранилищу журналов.
- share
- FileShare
Допустимое значение FileShare, определяющее совместное использование хранилища сертификатов процессами.
- bufferSize
- Int32
Требуемый размер буфера в байтах. Размер буфера определяет максимальный размер записи, которую можно добавить или прочитать.
- bufferCount
- Int32
Требуемое количество буферов.
- fileSecurity
- FileSecurity
Допустимое значение FileSecurity, указывающее параметры безопасности, задаваемые для нового хранилища в случае его создания.
Исключения
Файл, заданный параметром path
, является недопустимым.
-или-
Указанное имя файла хранилища журналов недопустимо.
-или-
Параметр mode
имеет значение CreateNew и не может использоваться без доступа на запись.
-или-
Параметр mode
имеет значение OpenOrCreate и не может использоваться без доступа на запись.
Один или несколько аргументов имеют значение null
.
Один или несколько аргументов выходят за пределы диапазона.
Не удается найти файл, заданный параметром path
.
Не удалось выполнить запрос, так как возникла неожиданная ошибка ввода-вывода.
-или-
Не удается получить доступ к файлу, указанному в параметре path
, так как он уже используется другим процессом.
-или-
Невозможно создать файл, указанный параметром path
, так как файл или каталог уже существует.
-или-
Не удается привязать дескриптор журнала к пулу потоков.
-или-
Указан недопустимый формат или версия файла журнала.
Эта операция не поддерживается.
Метод был вызван после удаления последовательности.
Недостаточно памяти, чтобы продолжить выполнение программы.
Невозможно использовать LogRecordSequence, так как не установлен требуемый компонент CLFS. Установите компонент CLFS, если он доступен на платформе, или используйте класс FileRecordSequence.
Последовательность записей заполнена.
Доступ к заданной последовательности журнала запрещен операционной системой.