MemoryMappedFile.CreateViewAccessor メソッド

定義

名前空間:

System.IO.MemoryMappedFiles

アセンブリ:

System.IO.MemoryMappedFiles.dll

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

オーバーロード

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

CreateViewAccessor()

ソース:

MemoryMappedFile.cs

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

public:
 System::IO::MemoryMappedFiles::MemoryMappedViewAccessor ^ CreateViewAccessor();

public System.IO.MemoryMappedFiles.MemoryMappedViewAccessor CreateViewAccessor ();

member this.CreateViewAccessor : unit -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor

Public Function CreateViewAccessor () As MemoryMappedViewAccessor

戻り値

MemoryMappedViewAccessor

ランダムにアクセスできるメモリ ブロック。

例外

UnauthorizedAccessException

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

注釈

このメソッドによって返されるビューを使用して、メモリ マップファイルにランダムにアクセスできます。

こちらもご覧ください

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

CreateViewAccessor(Int64, Int64)

ソース:

MemoryMappedFile.cs

メモリ マップト ファイルのビューに対応する、オフセットとサイズが指定された 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.MemoryMappedViewAccessor

Public Function CreateViewAccessor (offset As Long, size As Long) As MemoryMappedViewAccessor

パラメーター

offset

Int64

ビューの開始位置のバイト。

size

Int64

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

戻り値

MemoryMappedViewAccessor

ランダムにアクセスできるメモリ ブロック。

例外

ArgumentOutOfRangeException

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

- または -

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

UnauthorizedAccessException

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

IOException

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

注釈

このメソッドによって返されるビューを使用して、メモリ マップファイルにランダムにアクセスできます。

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

こちらもご覧ください

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

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

ソース:

MemoryMappedFile.cs

メモリ マップト ファイルのビューに対応するオフセット、サイズ、およびアクセス制限が指定された 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);

member this.CreateViewAccessor : int64 * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedViewAccessor

Public Function CreateViewAccessor (offset As Long, size As Long, access As MemoryMappedFileAccess) As MemoryMappedViewAccessor

パラメーター

offset

Int64

ビューの開始位置のバイト。

size

Int64

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

access

MemoryMappedFileAccess

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

戻り値

MemoryMappedViewAccessor

ランダムにアクセスできるメモリ ブロック。

例外

ArgumentOutOfRangeException

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

- または -

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

UnauthorizedAccessException

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

IOException

I/O エラーが発生しました。

注釈

このメソッドによって返されるビューを使用して、メモリ マップファイルにランダムにアクセスできます。

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

こちらもご覧ください

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