MemoryMappedFile.CreateOrOpen Metodo

Definizione

Spazio dei nomi:: System.IO.MemoryMappedFiles

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea o apre un file mappato alla memoria in memoria.

Overload

Nome	Descrizione
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)	Crea un nuovo file mappato alla memoria vuota o apre un file mappato alla memoria esistente, se presente con lo stesso nome. Se si apre un file esistente, la capacità, le opzioni e gli argomenti di memoria verranno ignorati.
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)	Crea o apre un file mappato alla memoria con il nome, la capacità, il tipo di accesso, l'allocazione della memoria, le autorizzazioni di sicurezza e l'ereditarietà specificati nella memoria di sistema.
CreateOrOpen(String, Int64)	Crea o apre un file mappato alla memoria con il nome e la capacità specificati nella memoria di sistema.
CreateOrOpen(String, Int64, MemoryMappedFileAccess)	Crea o apre un file mappato alla memoria con il nome, la capacità e il tipo di accesso specificati nella memoria di sistema.

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

Crea un nuovo file mappato alla memoria vuota o apre un file mappato alla memoria esistente, se presente con lo stesso nome. Se si apre un file esistente, la capacità, le opzioni e gli argomenti di memoria verranno ignorati.

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);

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);

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

Parametri

mapName: String

Nome del file mappato alla memoria.

capacity: Int64

Dimensione massima, in byte, da allocare al file mappato alla memoria.

access: MemoryMappedFileAccess

Uno dei valori di enumerazione che specifica il tipo di accesso consentito al file mappato alla memoria. Il valore predefinito è ReadWrite.

options: MemoryMappedFileOptions

Combinazione bit per bit di valori che indicano le opzioni di allocazione della memoria da applicare al file.

inheritability: HandleInheritability

Valore che specifica se un handle per il file mappato alla memoria può essere ereditato da un processo figlio. Il valore predefinito è None.

Valori restituiti

MemoryMappedFile

File mappato alla memoria con le caratteristiche specificate.

Eccezioni

ArgumentNullException

mapName è null.

ArgumentException

mapName è una stringa vuota.

oppure

access è impostato su write-only con il valore di Write enumerazione .

ArgumentOutOfRangeException

capacity è maggiore delle dimensioni dello spazio indirizzi logico.

oppure

capacity è minore o uguale a zero.

oppure

access non è un valore di enumerazione valido MemoryMappedFileAccess .

oppure

inheritability non è un valore di enumerazione valido HandleInheritability .

UnauthorizedAccessException

Il sistema operativo ha negato l'accesso specificato al file; Ad esempio, l'accesso è impostato su Write o ReadWrite, ma il file o la directory è di sola lettura.

Si applica a

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

Crea o apre un file mappato alla memoria con il nome, la capacità, il tipo di accesso, l'allocazione della memoria, le autorizzazioni di sicurezza e l'ereditarietà specificati nella memoria di sistema.

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

[System.Security.SecurityCritical]
public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen(string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access, System.IO.MemoryMappedFiles.MemoryMappedFileOptions options, System.IO.MemoryMappedFiles.MemoryMappedFileSecurity memoryMappedFileSecurity, System.IO.HandleInheritability inheritability);

[<System.Security.SecurityCritical>]
static member CreateOrOpen : string * int64 * System.IO.MemoryMappedFiles.MemoryMappedFileAccess * System.IO.MemoryMappedFiles.MemoryMappedFileOptions * System.IO.MemoryMappedFiles.MemoryMappedFileSecurity * System.IO.HandleInheritability -> System.IO.MemoryMappedFiles.MemoryMappedFile

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

Parametri

mapName: String

Nome del file mappato alla memoria.

capacity: Int64

Dimensione massima, in byte, da allocare al file mappato alla memoria.

access: MemoryMappedFileAccess

Uno dei valori di enumerazione che specifica il tipo di accesso consentito al file mappato alla memoria. Il valore predefinito è ReadWrite.

options: MemoryMappedFileOptions

Combinazione bit per bit di valori di enumerazione che specifica le opzioni di allocazione della memoria per il file mappato alla memoria.

memoryMappedFileSecurity: MemoryMappedFileSecurity

Autorizzazioni che possono essere concesse per l'accesso ai file e le operazioni sui file mappati alla memoria.

Questo parametro può essere null.

inheritability: HandleInheritability

Uno dei valori di enumerazione che specifica se un handle per il file mappato alla memoria può essere ereditato da un processo figlio. Il valore predefinito è None.

Valori restituiti

MemoryMappedFile

File mappato alla memoria con le caratteristiche specificate.

Attributi: SecurityCriticalAttribute

Eccezioni

ArgumentNullException

mapName è null.

ArgumentException

mapName è una stringa vuota.

oppure

access è impostato su write-only con il valore di Write enumerazione .

ArgumentOutOfRangeException

capacity è maggiore delle dimensioni dello spazio indirizzi logico.

oppure

capacity è minore o uguale a zero.

oppure

access non è un valore di enumerazione valido MemoryMappedFileAccess .

oppure

inheritability non è un valore di enumerazione valido HandleInheritability .

UnauthorizedAccessException

Il sistema operativo ha negato l'oggetto specificato access al file, access ad esempio è impostato su Write o ReadWrite, ma il file o la directory è di sola lettura.

Commenti

Usare questo metodo per creare o aprire un file mappato alla memoria che non è persistente (ovvero non associato a un file su disco), che è possibile usare per condividere i dati tra processi.

Vedi anche

Memory-Mapped File

Si applica a

CreateOrOpen(String, Int64)

Crea o apre un file mappato alla memoria con il nome e la capacità specificati nella memoria di sistema.

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

public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen(string mapName, long capacity);

static member CreateOrOpen : string * int64 -> System.IO.MemoryMappedFiles.MemoryMappedFile

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

Parametri

mapName: String

Nome del file mappato alla memoria.

capacity: Int64

Dimensione massima, in byte, da allocare al file mappato alla memoria.

Valori restituiti

MemoryMappedFile

File mappato alla memoria con il nome e le dimensioni specificati.

Eccezioni

ArgumentException

mapName è una stringa vuota.

ArgumentOutOfRangeException

capacity è maggiore delle dimensioni dello spazio indirizzi logico.

oppure

capacity è minore o uguale a zero.

Commenti

Usare questo metodo per creare o aprire un file mappato alla memoria che non è persistente (ovvero non associato a un file su disco), che è possibile usare per condividere i dati tra processi.

Vedi anche

Memory-Mapped File

Si applica a

CreateOrOpen(String, Int64, MemoryMappedFileAccess)

Crea o apre un file mappato alla memoria con il nome, la capacità e il tipo di accesso specificati nella memoria di sistema.

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

public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen(string mapName, long capacity, System.IO.MemoryMappedFiles.MemoryMappedFileAccess access);

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

Parametri

mapName: String

Nome del file mappato alla memoria.

capacity: Int64

Dimensione massima, in byte, da allocare al file mappato alla memoria.

access: MemoryMappedFileAccess

Uno dei valori di enumerazione che specifica il tipo di accesso consentito al file mappato alla memoria. Il valore predefinito è ReadWrite.

Valori restituiti

MemoryMappedFile

File mappato alla memoria con le caratteristiche specificate.

Eccezioni

ArgumentNullException

mapName è null.

ArgumentException

mapName è una stringa vuota.

oppure

access è impostato su write-only con il valore di Write enumerazione .

ArgumentOutOfRangeException

capacity è maggiore delle dimensioni dello spazio indirizzi logico.

oppure

capacity è minore o uguale a zero.

oppure

access non è un valore di enumerazione valido MemoryMappedFileAccess .

UnauthorizedAccessException

Il sistema operativo ha negato l'accesso specificato al file; Ad esempio, l'accesso è impostato su Write o ReadWrite, ma il file o la directory è di sola lettura.

Commenti

Usare questo metodo per creare o aprire un file mappato alla memoria che non è persistente (ovvero non associato a un file su disco), che è possibile usare per condividere i dati tra processi.

Vedi anche

Memory-Mapped File

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?