MemoryMappedFile.CreateViewStream メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
メモリ マップト ファイルのビューに対応するストリームを作成します。
オーバーロード
CreateViewStream() |
メモリ マップト ファイルのビューに対応するストリームを作成します。 |
CreateViewStream(Int64, Int64) |
メモリ マップト ファイルのビューに対応する、オフセットとサイズが指定されたストリームを作成します。 |
CreateViewStream(Int64, Int64, MemoryMappedFileAccess) |
メモリ マップト ファイルのビューに対応するオフセット、サイズ、およびアクセスの種類が指定されたストリームを作成します。 |
CreateViewStream()
メモリ マップト ファイルのビューに対応するストリームを作成します。
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
戻り値
メモリのストリーム。
例外
メモリ マップト ファイル リソースへのアクセスが承認されていません。
例
次の例では、ストリームを作成し、それに値を書き込みます。 このコード例は、 メソッドに対して提供されるより大きな例の 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)
メモリ マップト ファイルのビューに対応する、オフセットとサイズが指定されたストリームを作成します。
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 (ゼロ) を指定します。
戻り値
オフセットおよびサイズが指定されたメモリのストリーム。
例外
メモリ マップト ファイル リソースへのアクセスが承認されていません。
size
が仮想メモリの合計よりも大きくなっています。
注釈
このメソッドによって返されるストリームは、プロセス間通信など、メモリ マップド ファイルへのシーケンシャル アクセスに使用できます。
メモリ マップト ファイルの完全なビューを作成するには、 パラメーターに 0 (ゼロ) を size
指定します。 これを行うと、ビューのサイズがディスク上のソース ファイルのサイズよりも大きくなる可能性があります。 これは、ビューはシステム ページの単位で提供され、ビューのサイズは次のシステム ページ サイズに切り上げられます。
こちらもご覧ください
適用対象
CreateViewStream(Int64, Int64, MemoryMappedFileAccess)
メモリ マップト ファイルのビューに対応するオフセット、サイズ、およびアクセスの種類が指定されたストリームを作成します。
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);
[System.Security.SecurityCritical]
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
[<System.Security.SecurityCritical>]
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 です。
戻り値
特性が指定されたメモリのストリーム。
- 属性
例外
offset
または size
が負の値です。
- または -
size
が論理アドレス空間を超えています。
- または -
access
が有効な MemoryMappedFileAccess 列挙値ではありません。
access
は、メモリ マップト ファイルに対して無効です。
注釈
このメソッドによって返されるストリームは、プロセス間通信など、メモリ マップド ファイルへのシーケンシャル アクセスに使用できます。
メモリ マップト ファイルの完全なビューを作成するには、 パラメーターに 0 (ゼロ) を size
指定します。 これを行うと、ビューのサイズがディスク上のソース ファイルのサイズよりも大きくなる可能性があります。 これは、ビューはシステム ページの単位で提供され、ビューのサイズは次のシステム ページ サイズに切り上げられます。
こちらもご覧ください
適用対象
.NET