LogRecordSequence 构造函数
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
初始化 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.LogRecordSequencePublic 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.LogRecordSequencePublic Sub New (path As String, mode As FileMode)参数
- path
- String
要打开的日志存储区的基文件的相对或绝对路径。
例外
path 为 null。
mode 包含无效值。
无法找到该文件。
打开日志存储区时发生了 I/O 错误。
操作系统拒绝了对指定的日志序列的访问。
不支持此操作。
没有足够的内存来继续执行该程序。
无法使用 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.LogRecordSequencePublic Sub New (logStore As LogStore, bufferSize As Integer, bufferCount As Integer)参数
- bufferSize
- Int32
所需的缓冲区大小（以字节为单位）。 缓冲区大小确定了可追加或读取的记录的最大大小。
- bufferCount
- Int32
所需的缓冲区数量。
例外
logStore 为 null。
注解
如果要指定 bufferSize 和 bufferCount 值，而不是使用 bufferSize 的默认值 64 以及 bufferCount 的默认值 10，则可以使用此构造函数。
适用于
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.LogRecordSequencePublic Sub New (path As String, mode As FileMode, access As FileAccess)参数
- path
- String
要打开的日志存储区的基文件的相对或绝对路径。
- access
- FileAccess
用于确定 FileAccess 可以如何访问文件的 LogStore 值之一。
例外
path 为 null。
mode 包含无效值。
无法找到该文件。
打开日志存储区时发生了 I/O 错误。
操作系统拒绝了对指定的日志序列的访问。
不支持此操作。
没有足够的内存来继续执行该程序。
无法使用 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.LogRecordSequencePublic Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)参数
- path
- String
要打开的日志存储区的基文件的相对或绝对路径。
- access
- FileAccess
用于确定 FileAccess 可以如何访问文件的 LogStore 值之一。
例外
path 为 null。
mode 包含无效值。
无法找到该文件。
打开日志存储区时发生了 I/O 错误。
操作系统拒绝了对指定的日志序列的访问。
不支持此操作。
没有足够的内存来继续执行该程序。
无法使用 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.LogRecordSequencePublic Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, bufferCount As Integer)参数
- path
- String
要打开的日志存储区的基文件的相对或绝对路径。
- access
- FileAccess
用于确定 FileAccess 可以如何访问文件的 LogStore 值之一。
- bufferSize
- Int32
所需的缓冲区大小（以字节为单位）。 缓冲区大小确定了可追加或读取的记录的最大大小。
- bufferCount
- Int32
所需的缓冲区数量。
例外
path 为 null。
mode 包含无效值。
无法找到该文件。
打开日志存储区时发生了 I/O 错误。
操作系统拒绝了对指定的日志序列的访问。
不支持此操作。
没有足够的内存来继续执行该程序。
无法使用 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.LogRecordSequencePublic 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
要打开的日志存储区的基文件的相对或绝对路径。
- access
- FileAccess
一个有效的 FileAccess 值，用于确定如何访问日志存储区。
- bufferSize
- Int32
所需的缓冲区大小（以字节为单位）。 缓冲区大小确定了可追加或读取的记录的最大大小。
- bufferCount
- Int32
所需的缓冲区数量。
- fileSecurity
- FileSecurity
一个有效的 FileSecurity 值，指定在必须创建存储区的情况下，要为新创建的存储区设置的安全性。
例外
path 指定的文件无效。
- 或 -
指定的日志存储区文件名无效。
- 或 -
mode 的值为 CreateNew，在没有写访问权限的情况下无法使用它。
- 或 -
mode 的值为 OpenOrCreate，在没有写访问权限的情况下无法使用它。
一个或多个参数为 null。
一个或多个自变量超出范围。
找不到 path 指定的文件。
由于出现意外的 I/O 异常，因此无法执行该请求。
- 或 -
无法访问 path 指定的文件，因为另一个进程正在使用该文件。
- 或 -
无法创建 path 指定的文件，因为该文件或目录已存在。
- 或 -
日志句柄无法绑定到线程池。
- 或 -
指定的日志文件格式或版本无效。
不支持此操作。
该方法是在序列已释放之后调用的。
没有足够的内存来继续执行该程序。
无法使用 LogRecordSequence，因为没有安装所需的公用日志文件系统 (CLFS) 组件。 如果可行，请为您的平台安装 CLFS 组件，或使用 FileRecordSequence 类。
记录序列已满。
操作系统拒绝了对指定的日志序列的访问。
适用于
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈