MemoryMappedFile.CreateViewStream メソッド

定義

名前空間:

System.IO.MemoryMappedFiles

アセンブリ:

System.IO.MemoryMappedFiles.dll

メモリ マップト ファイルのビューに対応するストリームを作成します。

オーバーロード

CreateViewStream()	メモリ マップト ファイルのビューに対応するストリームを作成します。
CreateViewStream(Int64, Int64)	メモリ マップト ファイルのビューに対応する、オフセットとサイズが指定されたストリームを作成します。
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)	メモリ マップト ファイルのビューに対応するオフセット、サイズ、およびアクセスの種類が指定されたストリームを作成します。

CreateViewStream()

ソース:

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)

ソース:

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

ビューのサイズ。 offset で始まり、メモリ マップト ファイルの終端付近で終わるビューを作成するには 0 (ゼロ) を指定します。

戻り値

MemoryMappedViewStream

オフセットおよびサイズが指定されたメモリのストリーム。

例外

ArgumentOutOfRangeException

offset または size が負の値です。

- または -

size が論理アドレス空間を超えています。

UnauthorizedAccessException

メモリ マップト ファイル リソースへのアクセスが承認されていません。

IOException

size が仮想メモリの合計よりも大きくなっています。

注釈

このメソッドによって返されるストリームは、プロセス間通信など、メモリ マップト ファイルへのシーケンシャル アクセスに使用できます。

メモリ マップト ファイルの完全なビューを作成するには、 パラメーターに 0 (ゼロ) を size 指定します。 これを行うと、ビューのサイズがディスク上のソース ファイルのサイズよりも大きくなる可能性があります。 これは、ビューはシステム ページの単位で提供され、ビューのサイズは次のシステム ページ サイズに切り上げられます。

こちらもご覧ください

• メモリ マップト ファイル

CreateViewStream(Int64, Int64, MemoryMappedFileAccess)

ソース:

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

ビューのサイズ。 offset で始まり、メモリ マップト ファイルの終端付近で終わるビューを作成するには 0 (ゼロ) を指定します。

access

MemoryMappedFileAccess

メモリ マップト ファイルに対して許可されたアクセス権の種類を指定する列挙値の 1 つ。 既定値は、ReadWrite です。

戻り値

MemoryMappedViewStream

特性が指定されたメモリのストリーム。

例外

ArgumentOutOfRangeException

offset または size が負の値です。

- または -

size が論理アドレス空間を超えています。

- または -

access が有効な MemoryMappedFileAccess 列挙値ではありません。

UnauthorizedAccessException

access は、メモリ マップト ファイルに対して無効です。

IOException

size が仮想メモリの合計よりも大きくなっています。

- または -

access は、メモリ マップト ファイルに対して無効です。

注釈

このメソッドによって返されるストリームは、プロセス間通信など、メモリ マップト ファイルへのシーケンシャル アクセスに使用できます。

メモリ マップト ファイルの完全なビューを作成するには、 パラメーターに 0 (ゼロ) を size 指定します。 これを行うと、ビューのサイズがディスク上のソース ファイルのサイズよりも大きくなる可能性があります。 これは、ビューはシステム ページの単位で提供され、ビューのサイズは次のシステム ページ サイズに切り上げられます。

こちらもご覧ください

• メモリ マップト ファイル