次の方法で共有


MemoryMappedFile.CreateViewAccessor メソッド

定義

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

オーバーロード

CreateViewAccessor()

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

CreateViewAccessor(Int64, Int64)

メモリ マップト ファイルのビューに対応する、オフセットとサイズが指定された MemoryMappedViewAccessor を作成します。

CreateViewAccessor(Int64, Int64, MemoryMappedFileAccess)

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

CreateViewAccessor()

ソース:
MemoryMappedFile.cs
ソース:
MemoryMappedFile.cs
ソース:
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

戻り値

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

例外

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

注釈

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

こちらもご覧ください

適用対象

CreateViewAccessor(Int64, Int64)

ソース:
MemoryMappedFile.cs
ソース:
MemoryMappedFile.cs
ソース:
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 (ゼロ) を指定します。

戻り値

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

例外

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

- または -

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

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

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
ソース:
MemoryMappedFile.cs
ソース:
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);
[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.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 です。

戻り値

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

属性

例外

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

- または -

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

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

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

注釈

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

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

こちらもご覧ください

適用対象