LogStore 构造函数
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
初始化 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.LogStorePublic 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.LogStorePublic Sub New (path As String, mode As FileMode)参数
- path
- String
要打开的日志存储基文件的相对路径或绝对路径。
例外
path 是 null。
mode 包含无效值。
找不到该文件。
打开日志存储时发生 I/O 错误。
操作系统拒绝对指定日志存储的访问。
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.LogStorePublic Sub New (path As String, mode As FileMode, access As FileAccess)参数
- path
- String
要打开的日志存储基文件的相对路径或绝对路径。
- access
- FileAccess
FileAccess一个值，用于确定文件如何被LogStore访问。
例外
path 是 null。
找不到该文件。
打开日志存储时发生 I/O 错误。
操作系统拒绝对指定日志存储的访问。
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.LogStorePublic Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)参数
- path
- String
要打开的日志存储基文件的相对路径或绝对路径。
- access
- FileAccess
FileAccess一个值，用于确定文件如何被LogStore访问。
例外
path 是 null。
找不到该文件。
打开日志存储时发生 I/O 错误。
操作系统拒绝对指定日志存储的访问。
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.LogStorePublic Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, fileSecurity As FileSecurity)参数
- path
- String
要打开的日志存储基文件的相对路径或绝对路径。
- access
- FileAccess
FileAccess一个值，用于确定文件如何被LogStore访问。
- fileSecurity
- FileSecurity
一个 FileSecurity 值，该值指定要在新创建的存储区上设置的安全性（如果必须创建存储）。
例外
path 是 null。
指定的 path 日志文件名无效。
-或-
mode 是 CreateNew，不能在没有写入访问权限的情况下使用。
-或-
mode 是 OpenOrCreate，不能在没有写入访问权限的情况下使用。
找不到该文件。
打开日志存储时发生 I/O 错误。
无法访问由其 path 指定的文件，因为它正在由另一个进程使用。
-或-
无法创建由其 path 指定的文件，因为文件或目录已存在。
-或-
日志句柄无法绑定到线程池。
-或-
指定的日志文件格式或版本无效。
LogStore 不能使用，因为未安装所需的通用日志文件系统 （CLFS） 组件。 如果 CLFS 组件可用于平台或使用类，请安装它 FileRecordSequence 。
在释放序列后调用了该方法。
内存不足，无法继续执行程序。
记录序列已满。
操作系统拒绝对指定日志存储的访问。
注解
此构造函数初始化一个新 LogStore 对象，该对象使用指定的路径、模式和访问权限打开。 打开存储区以共享指定的访问权限。 该 path 参数应遵循以下语法：
log:<physical log name>[::<log client name>]
其中 <physical log name> 是日志文件的有效路径，并且 <log client name> 是唯一的客户端标识符。 日志存储应该是物理日志存储或虚拟日志存储，但不能同时存储两者。 一旦以物理方式或虚拟方式创建日志存储，它就会在生存期内保留。 通过仅指定物理日志名称来创建物理日志存储。 通过指定物理日志名称和日志客户端名称来创建虚拟日志存储。
共享相同物理日志名称的客户端共享相同的盘区集合和策略。
