MemoryMappedFile.CreateOrOpen メソッド

定義

名前空間:

System.IO.MemoryMappedFiles

アセンブリ:

System.IO.MemoryMappedFiles.dll

システム メモリ内でメモリ マップト ファイルを作成するか、または開きます。

オーバーロード

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)	新しい空のメモリ マップト ファイルを作成するか、同じ名前のファイルが存在する場合は既存のメモリ マップト ファイルを開きます。 既存のファイルを開く場合、容量、オプション、およびメモリ引数は無視されます。
CreateOrOpen(String, Int64)	名前と容量が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。
CreateOrOpen(String, Int64, MemoryMappedFileAccess)	名前、容量、アクセスの種類が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。

CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)

ソース:

MemoryMappedFile.cs

新しい空のメモリ マップト ファイルを作成するか、同じ名前のファイルが存在する場合は既存のメモリ マップト ファイルを開きます。 既存のファイルを開く場合、容量、オプション、およびメモリ引数は無視されます。

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access, System::IO::MemoryMappedFiles::MemoryMappedFileOptions options, System::IO::HandleInheritability inheritability);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access, System.IO.MemoryMappedFiles.MemoryMappedFileOptions options, System.IO.HandleInheritability inheritability);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess, options As MemoryMappedFileOptions, inheritability As HandleInheritability) As MemoryMappedFile

パラメーター

mapName

String

メモリ マップト ファイルの名前。

capacity

Int64

メモリ マップト ファイルに割り当てる最大サイズ (バイト単位)。

access

MemoryMappedFileAccess

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

options

MemoryMappedFileOptions

ファイルに適用するメモリ割り当てオプションを示す値のビットごとの組み合わせ。

inheritability

HandleInheritability

メモリ マップト ファイルへのハンドルを子プロセスが継承できるかどうかを指定する値。 既定値は、None です。

戻り値

MemoryMappedFile

指定された特性を持つメモリ マップト ファイル。

属性

SupportedOSPlatformAttribute

例外

ArgumentNullException

mapName は null です。

ArgumentException

mapName が空の文字列です。

- または -

access が Write 列挙値で書き込み専用に設定されます。

ArgumentOutOfRangeException

capacity が論理アドレス空間のサイズを超えています。

- または -

capacity が 0 以下です。

- または -

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

- または -

inheritability が有効な HandleInheritability 列挙値ではありません。

UnauthorizedAccessException

オペレーティング システムが、ファイルに指定したアクセスを拒否しました。たとえば、アクセスが Write または ReadWrite に設定されていますが、ファイルまたはディレクトリが読み取り専用です。

CreateOrOpen(String, Int64)

ソース:

MemoryMappedFile.cs

名前と容量が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateOrOpen : string * int64 -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function CreateOrOpen (mapName As String, capacity As Long) As MemoryMappedFile

パラメーター

mapName

String

メモリ マップト ファイルの名前。

capacity

Int64

メモリ マップト ファイルに割り当てる最大サイズ (バイト単位)。

戻り値

MemoryMappedFile

指定された名前およびサイズのメモリ マップト ファイル。

属性

SupportedOSPlatformAttribute

例外

ArgumentException

mapName が空の文字列です。

ArgumentOutOfRangeException

capacity が論理アドレス空間のサイズを超えています。

- または -

capacity が 0 以下です。

注釈

永続化されていない (つまり、ディスク上のファイルに関連付けられていない) メモリ マップト ファイルを作成または開くには、このメソッドを使用します。これは、プロセス間でデータを共有するために使用できます。

こちらもご覧ください

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

CreateOrOpen(String, Int64, MemoryMappedFileAccess)

ソース:

MemoryMappedFile.cs

名前、容量、アクセスの種類が指定されたメモリ マップト ファイルをシステム メモリ内で作成するか、開きます。

public:
 static System::IO::MemoryMappedFiles::MemoryMappedFile ^ CreateOrOpen(System::String ^ mapName, long capacity, System::IO::MemoryMappedFiles::MemoryMappedFileAccess access);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen (string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess -> System.IO.MemoryMappedFiles.MemoryMappedFile

Public Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess) As MemoryMappedFile

パラメーター

mapName

String

メモリ マップト ファイルの名前。

capacity

Int64

メモリ マップト ファイルに割り当てる最大サイズ (バイト単位)。

access

MemoryMappedFileAccess

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

戻り値

MemoryMappedFile

指定された特性を持つメモリ マップト ファイル。

属性

SupportedOSPlatformAttribute

例外

ArgumentNullException

mapName は null です。

ArgumentException

mapName が空の文字列です。

- または -

access が Write 列挙値で書き込み専用に設定されます。

ArgumentOutOfRangeException

capacity が論理アドレス空間のサイズを超えています。

- または -

capacity が 0 以下です。

- または -

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

UnauthorizedAccessException

オペレーティング システムが、ファイルに指定したアクセスを拒否しました。たとえば、アクセスが Write または ReadWrite に設定されていますが、ファイルまたはディレクトリが読み取り専用です。

注釈

永続化されていない (つまり、ディスク上のファイルに関連付けられていない) メモリ マップト ファイルを作成または開くには、このメソッドを使用します。これは、プロセス間でデータを共有するために使用できます。

こちらもご覧ください

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