LogStore Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса LogStore.
Перегрузки
LogStore(SafeFileHandle) |
Инициализирует новый экземпляр класса LogStore для указанного дескриптора. |
LogStore(String, FileMode) |
Инициализирует новый экземпляр класса LogStore с указанным путем и режимом. |
LogStore(String, FileMode, FileAccess) |
Инициализирует новый экземпляр класса LogStore с указанным путем, режимом и доступом. |
LogStore(String, FileMode, FileAccess, FileShare) |
Инициализирует новый экземпляр класса LogStore. |
LogStore(String, FileMode, FileAccess, FileShare, FileSecurity) |
Инициализирует новый экземпляр класса LogStore. |
LogStore(SafeFileHandle)
Инициализирует новый экземпляр класса LogStore для указанного дескриптора.
public:
LogStore(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle);
public LogStore (Microsoft.Win32.SafeHandles.SafeFileHandle handle);
new System.IO.Log.LogStore : Microsoft.Win32.SafeHandles.SafeFileHandle -> System.IO.Log.LogStore
Public Sub New (handle As SafeFileHandle)
Параметры
- handle
- SafeFileHandle
Дескриптор для файла журнала, инкапсулируемого текущим объектом LogStore.
Исключения
handle
имеет значение null
.
Не удается привязать дескриптор журнала к пулу потоков.
Доступ к заданному хранилищу журнала запрещен операционной системой.
Метод был вызван после удаления последовательности.
Недостаточно памяти, чтобы продолжать выполнение программы.
Применяется к
LogStore(String, FileMode)
Инициализирует новый экземпляр класса LogStore с указанным путем и режимом.
public:
LogStore(System::String ^ path, System::IO::FileMode mode);
public LogStore (string path, System.IO.FileMode mode);
new System.IO.Log.LogStore : string * System.IO.FileMode -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode)
Параметры
- path
- String
Относительный или абсолютный путь к базовому файлу хранилища журналов для открытия.
- mode
- FileMode
Одно из значений FileMode, с помощью которого можно определить способ открытия или создания хранилища.
Исключения
path
имеет значение null
.
Параметр path
является пустой строкой ("").
-или-
Параметр path
содержит только пробелы.
-или-
Параметр path
содержит один или несколько недопустимых символов.
Параметр mode
содержит недопустимое значение.
Не удается найти файл.
При открытии хранилища журналов произошла ошибка ввода-вывода.
Доступ к заданному хранилищу журнала запрещен операционной системой.
Невозможно использовать LogStore, так как не установлен требуемый компонент CLFS. Установите компонент CLFS, если он доступен на платформе, или используйте класс FileRecordSequence.
Недостаточно памяти, чтобы продолжать выполнение программы.
Комментарии
Используйте этот конструктор, чтобы открыть хранилище журнала с указанным путем и режимом. Хранилище открывается с доступом для чтения и записи и имеет общий доступ для чтения.
В параметре path
используется следующий синтаксис.
log:<physical log name>[::<log client name>]
где <physical log name>
— это допустимый путь к файлу журнала, а <log client name>
— это уникальный идентификатор клиента. Хранилище журнала должно быть физическим или виртуальным хранилищем журнала, но оно не может быть одновременно обоих типов. После создания хранилища журналов физически или виртуально хранилище сохраняет данный тип на все время своего существования. Физическое хранилище журнала создается с помощью указания только физического имени журнала. Виртуальное хранилище журнала создается с помощью указания как физического имени журнала, так и имени клиента журнала.
Клиенты, использующие одно имя физического журнала, используют одну коллекцию областей и политику.
Применяется к
LogStore(String, FileMode, FileAccess)
Инициализирует новый экземпляр класса LogStore с указанным путем, режимом и доступом.
public:
LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);
public LogStore (string path, System.IO.FileMode mode, System.IO.FileAccess access);
new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.Log.LogStore
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
содержит недопустимое значение.
или
Параметр access
содержит недопустимое значение.
Не удается найти файл.
При открытии хранилища журналов произошла ошибка ввода-вывода.
Доступ к заданному хранилищу журнала запрещен операционной системой.
Невозможно использовать LogStore, так как не установлен требуемый компонент CLFS. Установите компонент CLFS, если он доступен на платформе, или используйте класс FileRecordSequence.
Недостаточно памяти, чтобы продолжать выполнение программы.
Комментарии
Используйте этот конструктор, чтобы открыть новое хранилище журнала с указанным путем, режимом и доступом. Хранилище открывается с общим доступом для чтения.
В параметре path
используется следующий синтаксис.
log:<physical log name>[::<log client name>]
где <physical log name>
— это допустимый путь к файлу журнала, а <log client name>
— это уникальный идентификатор клиента. Хранилище журнала должно быть физическим или виртуальным хранилищем журнала, но оно не может быть одновременно обоих типов. После создания хранилища журналов физически или виртуально хранилище сохраняет данный тип на все время своего существования. Физическое хранилище журнала создается с помощью указания только физического имени журнала. Виртуальное хранилище журнала создается с помощью указания как физического имени журнала, так и имени клиента журнала.
Клиенты, использующие одно имя физического журнала, используют одну коллекцию областей и политику.
Применяется к
LogStore(String, FileMode, FileAccess, FileShare)
Инициализирует новый экземпляр класса LogStore.
public:
LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);
public LogStore (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);
new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.Log.LogStore
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
содержит недопустимое значение.
или
Параметр access
содержит недопустимое значение.
-или-
Параметр share
содержит недопустимое значение.
Не удается найти файл.
При открытии хранилища журналов произошла ошибка ввода-вывода.
Доступ к заданному хранилищу журнала запрещен операционной системой.
Невозможно использовать LogStore, так как не установлен требуемый компонент CLFS. Установите компонент CLFS, если он доступен на платформе, или используйте класс FileRecordSequence.
Недостаточно памяти, чтобы продолжать выполнение программы.
Комментарии
Этот конструктор инициализирует новый объект LogStore, который открывается с помощью указанного пути, режима и доступа. Хранилище открывается с общим указанным доступом.
В параметре path
используется следующий синтаксис.
log:<physical log name>[::<log client name>]
где <physical log name>
— это допустимый путь к файлу журнала, а <log client name>
— это уникальный идентификатор клиента. Хранилище журнала должно быть физическим или виртуальным хранилищем журнала, но оно не может быть одновременно обоих типов. После создания хранилища журналов физически или виртуально хранилище сохраняет данный тип на все время своего существования. Физическое хранилище журнала создается с помощью указания только физического имени журнала. Виртуальное хранилище журнала создается с помощью указания как физического имени журнала, так и имени клиента журнала.
Клиенты, использующие одно имя физического журнала, используют одну коллекцию областей и политику.
Применяется к
LogStore(String, FileMode, FileAccess, FileShare, FileSecurity)
Инициализирует новый экземпляр класса LogStore.
public:
LogStore(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public LogStore (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, System.Security.AccessControl.FileSecurity fileSecurity);
new System.IO.Log.LogStore : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * System.Security.AccessControl.FileSecurity -> System.IO.Log.LogStore
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, fileSecurity As FileSecurity)
Параметры
- path
- String
Относительный или абсолютный путь к базовому файлу хранилища журналов для открытия.
- mode
- FileMode
Одно из значений FileMode, с помощью которого можно определить способ открытия или создания хранилища.
- access
- FileAccess
Одно из значений FileAccess, определяющее, каким образом объект LogStore может получить доступ к файлу.
- share
- FileShare
Одно из значений FileShare, с помощью которых можно определить, как процессы будут совместно использовать хранилище журнала.
- fileSecurity
- FileSecurity
Одно из значений FileSecurity, указывающее тип безопасности, который задается для нового хранилища в случае его создания.
Исключения
path
имеет значение null
.
Имя файла хранилища журнала, указанное параметром path
, является недопустимым.
-или-
Параметр Mode
имеет значение CreateNew
, которое невозможно использовать без доступа на запись.
-или-
Параметр Mode
имеет значение OpenOrCreate
, которое невозможно использовать без доступа на запись.
Параметр mode
содержит недопустимое значение.
или
Параметр access
содержит недопустимое значение.
-или-
Параметр share
содержит недопустимое значение.
Не удается найти файл.
При открытии хранилища журналов произошла ошибка ввода-вывода.
Не удается получить доступ к файлу, указанному в параметре path
, так как он уже используется другим процессом.
-или-
Невозможно создать файл, указанный параметром path
, так как файл или каталог уже существует.
-или-
Не удается привязать дескриптор журнала к пулу потоков.
-или-
Указан недопустимый формат или версия файла журнала.
Невозможно использовать LogStore, так как не установлен требуемый компонент CLFS. Установите компонент CLFS, если он доступен на платформе, или используйте класс FileRecordSequence.
Метод был вызван после удаления последовательности.
Недостаточно памяти, чтобы продолжать выполнение программы.
Последовательность записей заполнена.
Доступ к заданному хранилищу журнала запрещен операционной системой.
Комментарии
Этот конструктор инициализирует новый объект LogStore, который открывается с помощью указанного пути, режима и доступа. Хранилище открывается с общим указанным доступом. В параметре path
должен использоваться следующий синтаксис.
log:<physical log name>[::<log client name>]
где <physical log name>
— это допустимый путь к файлу журнала, а <log client name>
— это уникальный идентификатор клиента. Хранилище журнала должно быть физическим или виртуальным хранилищем журнала, но оно не может быть одновременно обоих типов. После создания хранилища журналов физически или виртуально хранилище сохраняет данный тип на все время своего существования. Физическое хранилище журнала создается с помощью указания только физического имени журнала. Виртуальное хранилище журнала создается с помощью указания как физического имени журнала, так и имени клиента журнала.
Клиенты, использующие одно имя физического журнала, используют одну коллекцию областей и политику.