MemoryMappedFile.CreateOrOpen Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria ou abre um arquivo mapeado em memória do sistema.
Sobrecargas
| Nome | Description |
|---|---|
| CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) |
Cria um novo arquivo mapeado de memória vazia ou abre um arquivo mapeado de memória existente se houver um com o mesmo nome. Se abrir um arquivo existente, a capacidade, as opções e os argumentos de memória serão ignorados. |
| 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) |
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, HandleInheritability)
Cria um novo arquivo mapeado de memória vazia ou abre um arquivo mapeado de memória existente se houver um com o mesmo nome. Se abrir um arquivo existente, a capacidade, as opções e os argumentos de memória 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);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.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess, options As MemoryMappedFileOptions, inheritability As HandleInheritability) As MemoryMappedFileParâmetros
- mapName
- String
O nome do arquivo mapeado pela memória.
- capacity
- Int64
O tamanho máximo, em bytes, para alocar ao arquivo mapeado pela memória.
- access
- MemoryMappedFileAccess
Um dos valores de enumeração que especifica o tipo de acesso permitido ao arquivo mapeado pela 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 serem aplicadas ao arquivo.
- inheritability
- HandleInheritability
Um valor que especifica se um identificador para o arquivo mapeado pela memória pode ser herdado por um processo filho. O padrão é None.
Retornos
Um arquivo mapeado em memória que tem as características especificadas.
Exceções
mapName é null.
mapName é uma cadeia de caracteres vazia.
-ou-
access é definido como somente gravação com o valor de Write enumeração.
capacity é maior que o tamanho do espaço de endereço lógico.
-ou-
capacity é menor ou igual a zero.
-ou-
access não é um valor de enumeração válido MemoryMappedFileAccess .
-ou-
inheritability não é um valor de enumeração válido HandleInheritability .
O sistema operacional negou o acesso especificado ao arquivo; por exemplo, o acesso é definido Write como ou ReadWrite, mas o arquivo ou diretório é somente leitura.
Aplica-se a
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.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess, options As MemoryMappedFileOptions, memoryMappedFileSecurity As MemoryMappedFileSecurity, inheritability As HandleInheritability) As MemoryMappedFileParâmetros
- mapName
- String
O nome do arquivo mapeado pela memória.
- capacity
- Int64
O tamanho máximo, em bytes, para alocar ao arquivo mapeado pela memória.
- access
- MemoryMappedFileAccess
Um dos valores de enumeração que especifica o tipo de acesso permitido ao arquivo mapeado pela memória. O padrão é ReadWrite.
- options
- MemoryMappedFileOptions
Uma combinação bit a bit de valores de enumeração que especifica opções de alocação de memória para o arquivo mapeado em 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 na memória pode ser herdado por um processo filho. O padrão é None.
Retornos
Um arquivo mapeado em 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 Write enumeração.
capacity é maior que o tamanho do espaço de endereço lógico.
-ou-
capacity é menor ou igual a zero.
-ou-
access não é um valor de enumeração válido MemoryMappedFileAccess .
-ou-
inheritability não é um valor de enumeração válido HandleInheritability .
O sistema operacional negou o especificado access para o arquivo; por exemplo, access é definido Write como ou ReadWrite, mas o arquivo ou diretório é somente leitura.
Comentários
Use esse método para criar ou abrir um arquivo mapeado por 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)
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);public static System.IO.MemoryMappedFiles.MemoryMappedFile CreateOrOpen(string mapName, long capacity);static member CreateOrOpen : string * int64 -> System.IO.MemoryMappedFiles.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long) As MemoryMappedFileParâmetros
- mapName
- String
O nome do arquivo mapeado pela memória.
- capacity
- Int64
O tamanho máximo, em bytes, para alocar ao arquivo mapeado pela memória.
Retornos
Um arquivo mapeado em memória que tem o nome e o tamanho especificados.
Exceções
mapName é uma cadeia de caracteres vazia.
capacity é maior que o tamanho do espaço de endereço lógico.
-ou-
capacity é menor ou igual a zero.
Comentários
Use esse método para criar ou abrir um arquivo mapeado por 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)
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);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.MemoryMappedFilePublic Shared Function CreateOrOpen (mapName As String, capacity As Long, access As MemoryMappedFileAccess) As MemoryMappedFileParâmetros
- mapName
- String
O nome do arquivo mapeado pela memória.
- capacity
- Int64
O tamanho máximo, em bytes, para alocar ao arquivo mapeado pela memória.
- access
- MemoryMappedFileAccess
Um dos valores de enumeração que especifica o tipo de acesso permitido ao arquivo mapeado pela memória. O padrão é ReadWrite.
Retornos
Um arquivo mapeado em memória que tem as características especificadas.
Exceções
mapName é null.
mapName é uma cadeia de caracteres vazia.
-ou-
access é definido como somente gravação com o valor de Write enumeração.
capacity é maior que o tamanho do espaço de endereço lógico.
-ou-
capacity é menor ou igual a zero.
-ou-
access não é um valor de enumeração válido MemoryMappedFileAccess .
O sistema operacional negou o acesso especificado ao arquivo; por exemplo, o acesso é definido Write como ou ReadWrite, mas o arquivo ou diretório é somente leitura.
Comentários
Use esse método para criar ou abrir um arquivo mapeado por 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.