LogRecordSequence 构造函数

参考

定义

命名空间:: System.IO.Log

程序集:: System.IO.Log.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，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.LogRecordSequence

Public Sub New (logStore As LogStore)

参数

logStore: LogStore

此记录序列应使用的 LogStore。

例外

ArgumentException

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 值之一。

例外

ArgumentNullException

path 为 null。

ArgumentException

path 为空字符串 ("")。

- 或 -

path 仅包含空白。

- 或 -

path 包含一个或多个无效字符。

ArgumentOutOfRangeException

mode 包含无效值。

FileNotFoundException

无法找到该文件。

IOException

打开日志存储区时发生了 I/O 错误。

UnauthorizedAccessException

操作系统拒绝了对指定的日志序列的访问。

NotSupportedException

不支持此操作。

OutOfMemoryException

没有足够的内存来继续执行该程序。

PlatformNotSupportedException

无法使用 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)

参数

logStore: LogStore

此记录序列应使用的 LogStore。

bufferSize: Int32

所需的缓冲区大小（以字节为单位）。缓冲区大小确定了可追加或读取的记录的最大大小。

bufferCount: Int32

所需的缓冲区数量。

例外

ArgumentNullException

logStore 为 null。

ArgumentOutOfRangeException

bufferSize 为负数或零。

- 或 -

bufferCount 为负数或零。

注解

如果要指定 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.LogRecordSequence

Public Sub New (path As String, mode As FileMode, access As FileAccess)

参数

path: String

要打开的日志存储区的基文件的相对或绝对路径。

mode: FileMode

用于确定如何打开或创建存储区的 FileMode 值之一。

access: FileAccess

用于确定 FileAccess 可以如何访问文件的 LogStore 值之一。

例外

ArgumentNullException

path 为 null。

ArgumentException

path 为空字符串 ("")。

- 或 -

path 仅包含空白。

- 或 -

path 包含一个或多个无效字符。

ArgumentOutOfRangeException

mode 包含无效值。

FileNotFoundException

无法找到该文件。

IOException

打开日志存储区时发生了 I/O 错误。

UnauthorizedAccessException

操作系统拒绝了对指定的日志序列的访问。

NotSupportedException

不支持此操作。

OutOfMemoryException

没有足够的内存来继续执行该程序。

PlatformNotSupportedException

无法使用 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 值之一。

例外

ArgumentNullException

path 为 null。

ArgumentException

path 为空字符串 ("")。

- 或 -

path 仅包含空白。

- 或 -

path 包含一个或多个无效字符。

ArgumentOutOfRangeException

mode 包含无效值。

FileNotFoundException

无法找到该文件。

IOException

打开日志存储区时发生了 I/O 错误。

UnauthorizedAccessException

操作系统拒绝了对指定的日志序列的访问。

NotSupportedException

不支持此操作。

OutOfMemoryException

没有足够的内存来继续执行该程序。

PlatformNotSupportedException

无法使用 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

所需的缓冲区数量。

例外

ArgumentNullException

path 为 null。

ArgumentException

path 为空字符串 ("")。

- 或 -

path 仅包含空白。

- 或 -

path 包含一个或多个无效字符。

ArgumentOutOfRangeException

mode 包含无效值。

FileNotFoundException

无法找到该文件。

IOException

打开日志存储区时发生了 I/O 错误。

UnauthorizedAccessException

操作系统拒绝了对指定的日志序列的访问。

NotSupportedException

不支持此操作。

OutOfMemoryException

没有足够的内存来继续执行该程序。

PlatformNotSupportedException

无法使用 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 值，指定在必须创建存储区的情况下，要为新创建的存储区设置的安全性。

例外

ArgumentException

path 指定的文件无效。

- 或 -

指定的日志存储区文件名无效。

- 或 -

mode 的值为 CreateNew，在没有写访问权限的情况下无法使用它。

- 或 -

mode 的值为 OpenOrCreate，在没有写访问权限的情况下无法使用它。

ArgumentNullException

一个或多个参数为 null。

ArgumentOutOfRangeException

一个或多个自变量超出范围。

FileNotFoundException

找不到 path 指定的文件。

IOException

由于出现意外的 I/O 异常，因此无法执行该请求。

- 或 -

无法访问 path 指定的文件，因为另一个进程正在使用该文件。

- 或 -

无法创建 path 指定的文件，因为该文件或目录已存在。

- 或 -

日志句柄无法绑定到线程池。

- 或 -

指定的日志文件格式或版本无效。

NotSupportedException

不支持此操作。

ObjectDisposedException

该方法是在序列已释放之后调用的。

OutOfMemoryException

没有足够的内存来继续执行该程序。

PlatformNotSupportedException

无法使用 LogRecordSequence，因为没有安装所需的公用日志文件系统 (CLFS) 组件。如果可行，请为您的平台安装 CLFS 组件，或使用 FileRecordSequence 类。

SequenceFullException

记录序列已满。

UnauthorizedAccessException

操作系统拒绝了对指定的日志序列的访问。

适用于

通过

LogRecordSequence 构造函数

定义

重载

LogRecordSequence(LogStore)

参数

例外

注解

适用于

LogRecordSequence(String, FileMode)

参数

例外

注解

适用于

LogRecordSequence(LogStore, Int32, Int32)

参数

例外

注解

适用于

LogRecordSequence(String, FileMode, FileAccess)

参数

例外

注解

适用于

LogRecordSequence(String, FileMode, FileAccess, FileShare)

参数

例外

示例

注解

适用于

LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32)

参数

例外

注解

适用于

LogRecordSequence(String, FileMode, FileAccess, FileShare, Int32, Int32, FileSecurity)

参数

例外

适用于

其他资源