Partilhar via


MemoryMappedFile.CreateOrOpen Método

Definição

Cria ou abre um arquivo mapeado em memória na memória do sistema.

Sobrecargas

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

Cria ou abre um arquivo mapeado em memória que tem o nome, a capacidade, o tipo de acesso, a alocação de memória, as permissões de segurança e a herdabilidade especificados na memória do sistema.

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

Cria um novo arquivo mapeado em memória vazio ou abre um arquivo mapeado em memória existente se existir um com o mesmo nome. Se estiver abrindo um arquivo existente, os argumentos de memória, opções e capacidades serão ignorados.

CreateOrOpen(String, Int64)

Cria ou abre um arquivo mapeado em memória que tem o nome e a capacidade especificados na memória do sistema.

CreateOrOpen(String, Int64, MemoryMappedFileAccess)

Cria ou abre um arquivo mapeado em memória que tem o nome, a capacidade e o tipo de acesso especificados na memória do sistema.

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

Cria ou abre um arquivo mapeado em memória que tem o nome, a capacidade, o tipo de acesso, a alocação de memória, as permissões de segurança e a herdabilidade especificados na memória do 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

Parâmetros

mapName
String

O nome do arquivo mapeado em memória.

capacity
Int64

O tamanho máximo, em bytes, a ser alocado para o arquivo mapeado em memória.

access
MemoryMappedFileAccess

Um dos valores de enumeração que especifica o tipo de acesso permitido para o arquivo mapeado na memória. O padrão é ReadWrite.

options
MemoryMappedFileOptions

Uma combinação bit a bit dos valores de enumeração que especifica opções de alocação de memória para o arquivo mapeado na memória.

memoryMappedFileSecurity
MemoryMappedFileSecurity

As permissões que podem ser concedidas para acesso a arquivos e operações em arquivos mapeados em memória.

Esse parâmetro pode ser null.

inheritability
HandleInheritability

Um dos valores de enumeração que especifica se um identificador para o arquivo mapeado em memória pode ser herdado por um processo filho. O padrão é None.

Retornos

Um arquivo mapeado na memória que tem as características especificadas.

Atributos

Exceções

mapName é null.

mapName é uma cadeia de caracteres vazia.

- ou -

access é definido como somente gravação com o valor de enumeração Write.

capacity é maior que o tamanho do espaço de endereçamento lógico.

- ou -

capacity é menor que ou igual a zero.

- ou -

access não é um valor de enumeração MemoryMappedFileAccess válido.

- ou -

inheritability não é um valor de enumeração HandleInheritability válido.

O sistema operacional negou o access especificado para o arquivo, por exemplo, access está definido como Write ou ReadWrite, mas o arquivo ou o diretório é somente leitura.

Comentários

Use esse método para criar ou abrir um arquivo mapeado na memória que não é persistente (ou seja, não associado a um arquivo em disco), que você pode usar para compartilhar dados entre processos.

Confira também

Aplica-se a

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

Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs

Cria um novo arquivo mapeado em memória vazio ou abre um arquivo mapeado em memória existente se existir um com o mesmo nome. Se estiver abrindo um arquivo existente, os argumentos de memória, opções e capacidades serão ignorados.

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

Parâmetros

mapName
String

O nome do arquivo mapeado em memória.

capacity
Int64

O tamanho máximo, em bytes, a ser alocado para o arquivo mapeado em memória.

access
MemoryMappedFileAccess

Um dos valores de enumeração que especifica o tipo de acesso permitido para o arquivo mapeado na memória. O padrão é ReadWrite.

options
MemoryMappedFileOptions

Uma combinação bit a bit de valores que indicam as opções de alocação de memória a aplicar ao arquivo.

inheritability
HandleInheritability

Um valor que especifica se um identificador para o arquivo de mapeamento de memória pode ser herdado por um processo filho. O padrão é None.

Retornos

Um arquivo mapeado na memória que tem as características especificadas.

Atributos

Exceções

mapName é null.

mapName é uma cadeia de caracteres vazia.

- ou -

access é definido como somente gravação com o valor de enumeração Write.

capacity é maior que o tamanho do espaço de endereçamento lógico.

- ou -

capacity é menor que ou igual a zero.

- ou -

access não é um valor de enumeração MemoryMappedFileAccess válido.

- ou -

inheritability não é um valor de enumeração HandleInheritability válido.

O sistema operacional negou o acesso especificado ao arquivo, por exemplo, o acesso está definido como Write ou ReadWrite, mas o arquivo ou diretório é somente leitura.

Aplica-se a

CreateOrOpen(String, Int64)

Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs

Cria ou abre um arquivo mapeado em memória que tem o nome e a capacidade especificados na memória do sistema.

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);
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
static member CreateOrOpen : string * int64 -> System.IO.MemoryMappedFiles.MemoryMappedFile
Public Shared Function CreateOrOpen (mapName As String, capacity As Long) As MemoryMappedFile

Parâmetros

mapName
String

O nome do arquivo mapeado em memória.

capacity
Int64

O tamanho máximo, em bytes, a ser alocado para o arquivo mapeado em memória.

Retornos

Um arquivo mapeado em memória que tem o nome e o tamanho especificados.

Atributos

Exceções

mapName é uma cadeia de caracteres vazia.

capacity é maior que o tamanho do espaço de endereçamento lógico.

- ou -

capacity é menor que ou igual a zero.

Comentários

Use esse método para criar ou abrir um arquivo mapeado na memória que não é persistente (ou seja, não associado a um arquivo em disco), que você pode usar para compartilhar dados entre processos.

Confira também

Aplica-se a

CreateOrOpen(String, Int64, MemoryMappedFileAccess)

Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs
Origem:
MemoryMappedFile.cs

Cria ou abre um arquivo mapeado em memória que tem o nome, a capacidade e o tipo de acesso especificados na memória do sistema.

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

Parâmetros

mapName
String

O nome do arquivo mapeado em memória.

capacity
Int64

O tamanho máximo, em bytes, a ser alocado para o arquivo mapeado em memória.

access
MemoryMappedFileAccess

Um dos valores de enumeração que especifica o tipo de acesso permitido para o arquivo mapeado na memória. O padrão é ReadWrite.

Retornos

Um arquivo mapeado na memória que tem as características especificadas.

Atributos

Exceções

mapName é null.

mapName é uma cadeia de caracteres vazia.

- ou -

access é definido como somente gravação com o valor de enumeração Write.

capacity é maior que o tamanho do espaço de endereçamento lógico.

- ou -

capacity é menor que ou igual a zero.

- ou -

access não é um valor de enumeração MemoryMappedFileAccess válido.

O sistema operacional negou o acesso especificado ao arquivo, por exemplo, o acesso está definido como Write ou ReadWrite, mas o arquivo ou diretório é somente leitura.

Comentários

Use esse método para criar ou abrir um arquivo mapeado na memória que não é persistente (ou seja, não associado a um arquivo em disco), que você pode usar para compartilhar dados entre processos.

Confira também

Aplica-se a