LogRecordSequence 构造函数

定义

初始化 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此记录序列应使用。

例外

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确定如何打开或创建存储区的值之一。

例外

pathnull

path 是空字符串(“)。

-或-

path 仅包含空格。

-或-

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

mode 包含无效值。

找不到该文件。

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

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

不支持此操作。

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

LogRecordSequence 不能使用,因为未安装所需的通用日志文件系统 (CLFS) 组件。 安装 CLFS 组件(如果可用于平台),或使用该 FileRecordSequence 类。

注解

此构造函数使用指定的路径和模式在打开的新对象上初始化一个新LogRecordSequenceLogStore对象。 它授予对存储的读/写访问权限,并且该存储区已打开共享读取访问权限。

适用于

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

所需的缓冲区数。

例外

logStorenull

bufferSize 为负数或零。

-或-

bufferCount 为负数或零。

注解

如果要指定 bufferSize 值,并且 bufferCount 不希望将默认值 64 用于 bufferSize 和 10, bufferCount请使用此构造函数。

适用于

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访问。

例外

pathnull

path 是空字符串(“)。

-或-

path 仅包含空格。

-或-

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

mode 包含无效值。

找不到该文件。

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

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

不支持此操作。

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

LogRecordSequence 不能使用,因为未安装所需的通用日志文件系统 (CLFS) 组件。 安装 CLFS 组件(如果可用于平台),或使用该 FileRecordSequence 类。

注解

此构造函数使用指定的路径、模式和访问权限在打开的新对象上初始化一个新LogRecordSequenceLogStore对象。 存储区已打开共享读取访问权限。

适用于

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确定日志存储如何在进程之间共享的值之一。

例外

pathnull

path 是空字符串(“)。

-或-

path 仅包含空格。

-或-

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

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

注解

此构造函数使用指定的路径、模式和访问权限在打开的新对象上初始化一个新LogRecordSequenceLogStore对象。 打开存储区以共享指定的访问权限。

适用于

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

所需的缓冲区数。

例外

pathnull

path 是空字符串(“)。

-或-

path 仅包含空格。

-或-

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

mode 包含无效值。

找不到该文件。

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

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

不支持此操作。

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

LogRecordSequence 不能使用,因为未安装所需的通用日志文件系统 (CLFS) 组件。 安装 CLFS 组件(如果可用于平台),或使用该 FileRecordSequence 类。

注解

此构造函数使用指定的路径、模式和访问权限在打开的新对象上初始化一个新LogRecordSequenceLogStore对象。 打开存储区以共享指定的访问权限。

适用于

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 值,该值指定要在新创建的存储区上设置的安全性(如果必须创建存储)。

例外

指定的 path 文件无效。

-或-

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

-或-

mode 具有值 CreateNew,并且不能在没有写入访问权限的情况下使用。

-或-

mode 具有值 OpenOrCreate,并且不能在没有写入访问权限的情况下使用。

一个或多个参数是 null

一个或多个参数处于范围外。

找不到由 <a0/a0> 指定的文件。

由于出现意外的 I/O 异常,无法执行请求。

-或-

无法访问由其 path 指定的文件,因为它正在由另一个进程使用。

-或-

无法创建由其 path 指定的文件,因为文件或目录已存在。

-或-

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

-或-

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

不支持此操作。

在释放序列后调用了该方法。

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

LogRecordSequence 不能使用,因为未安装所需的通用日志文件系统 (CLFS) 组件。 安装 CLFS 组件(如果可用于平台),或使用该 FileRecordSequence 类。

记录序列已满。

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

适用于