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 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.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 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.MemoryMappedFilestatic 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 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.MemoryMappedFilestatic 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 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.MemoryMappedFilestatic 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 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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de