MemoryMappedFile.CreateViewAccessor メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
メモリ マップト ファイルのビューにマップする MemoryMappedViewAccessor を作成します。
オーバーロード
| 名前 | 説明 |
|---|---|
| CreateViewAccessor() |
メモリ マップト ファイルのビューにマップする MemoryMappedViewAccessor を作成します。 |
| CreateViewAccessor(Int64, Int64) |
メモリ マップト ファイルのビューにマップされ、指定したオフセットとサイズを持つ MemoryMappedViewAccessor を作成します。 |
| CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess) |
メモリ マップト ファイルのビューにマップされ、指定されたオフセット、サイズ、およびアクセス制限を持つ MemoryMappedViewAccessor を作成します。 |
CreateViewAccessor()
メモリ マップト ファイルのビューにマップする MemoryMappedViewAccessor を作成します。
public:
System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor();public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor();member this.CreateViewAccessor : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessorPublic Function CreateViewAccessor () As MemoryMappedViewAccessor返品
ランダムにアクセスできるメモリ ブロック。
例外
メモリ マップト ファイルへのアクセスが承認されていません。
注釈
メモリ マップト ファイルへのランダム アクセスには、このメソッドによって返されるビューを使用できます。
こちらもご覧ください
適用対象
CreateViewAccessor(Int64, Int64)
メモリ マップト ファイルのビューにマップされ、指定したオフセットとサイズを持つ MemoryMappedViewAccessor を作成します。
public:
System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor(long offset, long size);public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor(long offset, long size);member this.CreateViewAccessor : int64 * int64 -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessorPublic Function CreateViewAccessor (offset As Long, size As Long) As MemoryMappedViewAccessorパラメーター
- offset
- Int64
ビューを開始するバイト。
- size
- Int64
ビューのサイズ。 0 (ゼロ) を指定して、 offset で始まり、メモリ マップト ファイルのほぼ末尾で終了するビューを作成します。
返品
ランダムにアクセスできるメモリ ブロック。
例外
メモリ マップト ファイルへのアクセスが承認されていません。
I/O エラーが発生しました。
例
次の例では、メモリ マップト ファイルのビューを作成して編集します。 このコード例は、 MemoryMappedFile クラスに提供されるより大きな例の一部です。
// Create a random access view, from the 256th megabyte (the offset)
// to the 768th megabyte (the offset plus length).
using (var accessor = mmf.CreateViewAccessor(offset, length))
{
int colorSize = Marshal.SizeOf(typeof(MyColor));
MyColor color;
// Make changes to the view.
for (long i = 0; i < length; i += colorSize)
{
accessor.Read(i, out color);
color.Brighten(10);
accessor.Write(i, ref color);
}
}
' Create a random access view, from the 256th megabyte (the offset)
' to the 768th megabyte (the offset plus length).
Using accessor = mmf.CreateViewAccessor(offset, length)
Dim colorSize As Integer = Marshal.SizeOf(GetType(MyColor))
Dim color As MyColor
Dim i As Long = 0
' Make changes to the view.
Do While (i < length)
accessor.Read(i, color)
color.Brighten(10)
accessor.Write(i, color)
i += colorSize
Loop
End Using
注釈
メモリ マップト ファイルへのランダム アクセスには、このメソッドによって返されるビューを使用できます。
メモリ マップト ファイルの完全なビューを作成するには、 size パラメーターに 0 (ゼロ) を指定します。 これを行うと、ビューのサイズがディスク上のソース ファイルのサイズよりも大きくなる可能性があります。 これは、ビューはシステム ページ単位で提供され、ビューのサイズは次のシステム ページ サイズに切り上げられます。
こちらもご覧ください
適用対象
CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)
メモリ マップト ファイルのビューにマップされ、指定されたオフセット、サイズ、およびアクセス制限を持つ MemoryMappedViewAccessor を作成します。
public:
System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor(long offset, long size, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access);public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor(long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);[System.Security.SecurityCritical]
public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor(long offset, long size, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);member this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor[<System.Security.SecurityCritical>]
member this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessorPublic Function CreateViewAccessor (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewAccessorパラメーター
- offset
- Int64
ビューを開始するバイト。
- size
- Int64
ビューのサイズ。 0 (ゼロ) を指定して、 offset で始まり、メモリ マップト ファイルのほぼ末尾で終了するビューを作成します。
- access
- MemoryMappedFileAccess
メモリ マップト ファイルに対して許可されるアクセスの種類を指定する列挙値の 1 つ。 既定値は ReadWrite です。
返品
ランダムにアクセスできるメモリ ブロック。
- 属性
例外
access は、メモリ マップト ファイルに対して無効です。
I/O エラーが発生しました。
注釈
メモリ マップト ファイルへのランダム アクセスには、このメソッドによって返されるビューを使用できます。
メモリ マップト ファイルの完全なビューを作成するには、 size パラメーターに 0 (ゼロ) を指定します。 これを行うと、ビューのサイズがディスク上のソース ファイルのサイズよりも大きくなる可能性があります。 これは、ビューはシステム ページ単位で提供され、ビューのサイズは次のシステム ページ サイズに切り上げられます。
