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> 是唯一客户端标识符。 日志存储区应是物理日志存储区或虚拟日志存储区，但不能同时为两者。 以物理或虚拟方式创建日志存储区后，它在整个生命周期中都将保持该形态。 物理日志存储区是通过仅指定物理日志名称来创建的。 虚拟日志存储区是通过指定物理日志名称和日志客户端名称来创建的。
共享同一个物理日志名称的客户端将共享相同的范围集合与策略。
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈