MemoryMappedFile.CreateViewStream 方法

定义

命名空间:

System.IO.MemoryMappedFiles

程序集:

System.IO.MemoryMappedFiles.dll

创建映射到内存映射文件视图的流。

重载

CreateViewStream()	创建映射到内存映射文件视图的流。
CreateViewStream(Int64, Int64)	创建一个流，它映射到内存映射文件的视图并具有指定的偏移和大小。
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)	创建一个流，它映射到内存映射文件的视图，并具有指定的偏移、大小和访问类型。

CreateViewStream()

Source:

MemoryMappedFile.cs

创建映射到内存映射文件视图的流。

public:
 System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream();

public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream ();

member this.CreateViewStream : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewStream

Public Function CreateViewStream () As MemoryMappedViewStream

返回

MemoryMappedViewStream

内存流。

例外

UnauthorizedAccessException

对内存映射文件的访问控制未获授权。

示例

以下示例创建一个流，并向其写入值。 此代码示例是为 方法提供的更大示例的 CreateNew 一部分。

using (MemoryMappedViewStream stream = mmf.CreateViewStream())
{
    BinaryWriter writer = new BinaryWriter(stream);
    writer.Write(1);
}

Using Stream As MemoryMappedViewStream = mmf.CreateViewStream()
    Dim writer As BinaryWriter = New BinaryWriter(Stream)
    writer.Write(1)
End Using

注解

可以使用此方法返回的流对内存映射文件进行顺序访问，例如进程间通信。

另请参阅

• 内存映射文件

CreateViewStream(Int64, Int64)

Source:

MemoryMappedFile.cs

创建一个流，它映射到内存映射文件的视图并具有指定的偏移和大小。

public:
 System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream(long offset, long size);

public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream (long offset, long size);

member this.CreateViewStream : int64 * int64 -> System.IO.MemoryMappedFiles.MemoryMappedViewStream

Public Function CreateViewStream (offset As Long, size As Long) As MemoryMappedViewStream

参数

offset

Int64

启动此视图的字节位置。

size

Int64

视图的大小。 指定 0（零）可创建从 offset 开始，大约在内存映射文件结尾处结束的视图。

返回

MemoryMappedViewStream

具有指定偏移和大小的内存流。

例外

ArgumentOutOfRangeException

offset 或 size 是负值。

- 或 -

size 大于逻辑地址空间。

UnauthorizedAccessException

对内存映射文件的访问控制未获授权。

IOException

size 大于总虚拟内存。

注解

可以使用此方法返回的流对内存映射文件进行顺序访问，例如进程间通信。

若要创建内存映射文件的完整视图，请为 size 参数指定 0 (零) 。 如果执行此操作，视图的大小可能大于磁盘上源文件的大小。 这是因为视图以系统页的单位提供，并且视图的大小将向上舍入到下一个系统页面大小。

另请参阅

• 内存映射文件

CreateViewStream(Int64, Int64, MemoryMappedFileAccess)

Source:

MemoryMappedFile.cs

创建一个流，它映射到内存映射文件的视图，并具有指定的偏移、大小和访问类型。

public:
 System::IO::MemoryMappedFiles::MemoryMappedViewStream ^ CreateViewStream(long offset, long size, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access);

public System.IO.MemoryMappedFiles.MemoryMappedViewStream CreateViewStream (long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);

member this.CreateViewStream : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewStream

Public Function CreateViewStream (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewStream

参数

offset

Int64

启动此视图的字节位置。

size

Int64

视图的大小。 指定 0（零）可创建从 offset 开始，大约在内存映射文件结尾处结束的视图。

access

MemoryMappedFileAccess

指定内存映射文件允许的访问类型的枚举值之一。 默认值为 ReadWrite。

返回

MemoryMappedViewStream

具有指定特征的内存流。

例外

ArgumentOutOfRangeException

offset 或 size 是负值。

- 或 -

size 大于逻辑地址空间。

- 或 -

access 不是有效的 MemoryMappedFileAccess 枚举值。

UnauthorizedAccessException

access 对于内存映射文件无效。

IOException

size 大于总虚拟内存。

- 或 -

access 对于内存映射文件无效。

注解

可以使用此方法返回的流对内存映射文件进行顺序访问，例如进程间通信。

若要创建内存映射文件的完整视图，请为 size 参数指定 0 (零) 。 如果执行此操作，视图的大小可能大于磁盘上源文件的大小。 这是因为视图以系统页的单位提供，并且视图的大小将向上舍入到下一个系统页面大小。

另请参阅

• 内存映射文件