MemoryMappedFile.CreateOrOpen Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria ou abre um ficheiro mapeado em memória na memória do sistema.
Sobrecargas
| Name | Description |
|---|---|
| CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability) |
Cria um novo ficheiro mapeado de memória vazio ou abre um ficheiro mapeado de memória existente, se existir um com o mesmo nome. Se abrir um ficheiro existente, os argumentos de capacidade, opções e memória serão ignorados. |
| CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability) |
Cria ou abre um ficheiro mapeado em memória que tem o nome especificado, capacidade, tipo de acesso, alocação de memória, permissões de segurança e herdabilidade na memória do sistema. |
| CreateOrOpen(String, Int64) |
Cria ou abre um ficheiro mapeado à memória que tem o nome e capacidade especificados na memória do sistema. |
| CreateOrOpen(String, Int64, MemoryMappedFileAccess) |
Cria ou abre um ficheiro mapeado em memória que tem o nome, capacidade e tipo de acesso especificados na memória do sistema. |
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)
Cria um novo ficheiro mapeado de memória vazio ou abre um ficheiro mapeado de memória existente, se existir um com o mesmo nome. Se abrir um ficheiro existente, os argumentos de capacidade, opções e 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 ficheiro mapeado em memória.
- capacity
- Int64
O tamanho máximo, em bytes, a alocar ao ficheiro mapeado em memória.
- access
- MemoryMappedFileAccess
Um dos valores de enumeração que especifica o tipo de acesso permitido ao ficheiro mapeado em memória. A predefinição é ReadWrite.
- options
- MemoryMappedFileOptions
Uma combinação bit a bit de valores que indica as opções de alocação de memória a aplicar ao ficheiro.
- inheritability
- HandleInheritability
Um valor que especifica se um handle do ficheiro mapeado em memória pode ser herdado por um processo filho. A predefinição é None.
Devoluções
Um ficheiro mapeado em memória que tem as características especificadas.
Exceções
mapName é null.
mapName é uma corda vazia.
-ou-
access está definido para apenas escrita com o Write valor de enumeração.
capacity é maior do que o tamanho do espaço de endereçamento 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 operativo negou o acesso especificado ao ficheiro; por exemplo, o acesso está definido como Write ou ReadWrite, mas o ficheiro ou diretório é só de leitura.
Aplica-se a
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)
Cria ou abre um ficheiro mapeado em memória que tem o nome especificado, capacidade, tipo de acesso, alocação de memória, permissões de segurança e herdabilidade 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 ficheiro mapeado em memória.
- capacity
- Int64
O tamanho máximo, em bytes, a alocar ao ficheiro mapeado em memória.
- access
- MemoryMappedFileAccess
Um dos valores de enumeração que especifica o tipo de acesso permitido ao ficheiro mapeado em memória. A predefiniçã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 ficheiro mapeado em memória.
- memoryMappedFileSecurity
- MemoryMappedFileSecurity
As permissões que podem ser concedidas para acesso a ficheiros e operações em ficheiros mapeados em memória.
Este parâmetro pode ser null.
- inheritability
- HandleInheritability
Um dos valores de enumeração que especifica se um handle do ficheiro mapeado em memória pode ser herdado por um processo filho. A predefinição é None.
Devoluções
Um ficheiro mapeado em memória que tem as características especificadas.
- Atributos
Exceções
mapName é null.
mapName é uma corda vazia.
-ou-
access está definido para apenas escrita com o Write valor de enumeração.
capacity é maior do que o tamanho do espaço de endereçamento 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 operativo negou o especificado access ao ficheiro; por exemplo, access está definido como Write ou ReadWrite, mas o ficheiro ou diretório é apenas de leitura.
Observações
Use este método para criar ou abrir um ficheiro mapeado em memória que não seja persistido (ou seja, não esteja associado a um ficheiro no disco), que pode usar para partilhar dados entre processos.
Ver também
Aplica-se a
CreateOrOpen(String, Int64)
Cria ou abre um ficheiro mapeado à memória que tem o nome e 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 ficheiro mapeado em memória.
- capacity
- Int64
O tamanho máximo, em bytes, a alocar ao ficheiro mapeado em memória.
Devoluções
Um ficheiro mapeado em memória que tem o nome e tamanho especificados.
Exceções
mapName é uma corda vazia.
capacity é maior do que o tamanho do espaço de endereçamento lógico.
-ou-
capacity é menor ou igual a zero.
Observações
Use este método para criar ou abrir um ficheiro mapeado em memória que não seja persistido (ou seja, não esteja associado a um ficheiro no disco), que pode usar para partilhar dados entre processos.
Ver também
Aplica-se a
CreateOrOpen(String, Int64, MemoryMappedFileAccess)
Cria ou abre um ficheiro mapeado em memória que tem o nome, capacidade e 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 ficheiro mapeado em memória.
- capacity
- Int64
O tamanho máximo, em bytes, a alocar ao ficheiro mapeado em memória.
- access
- MemoryMappedFileAccess
Um dos valores de enumeração que especifica o tipo de acesso permitido ao ficheiro mapeado em memória. A predefinição é ReadWrite.
Devoluções
Um ficheiro mapeado em memória que tem as características especificadas.
Exceções
mapName é null.
mapName é uma corda vazia.
-ou-
access está definido para apenas escrita com o Write valor de enumeração.
capacity é maior do que o tamanho do espaço de endereçamento lógico.
-ou-
capacity é menor ou igual a zero.
-ou-
access não é um valor de enumeração válido MemoryMappedFileAccess .
O sistema operativo negou o acesso especificado ao ficheiro; por exemplo, o acesso está definido como Write ou ReadWrite, mas o ficheiro ou diretório é só de leitura.
Observações
Use este método para criar ou abrir um ficheiro mapeado em memória que não seja persistido (ou seja, não esteja associado a um ficheiro no disco), que pode usar para partilhar dados entre processos.