MemoryMappedFile.CreateOrOpen Método

Definición

Espacio de nombres:: System.IO.MemoryMappedFiles

Ensamblado:: System.Core.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Crea o abre un archivo asignado a memoria en la memoria del sistema.

Sobrecargas

Nombre	Description
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, HandleInheritability)	Crea un nuevo archivo asignado a memoria vacía o abre un archivo asignado a memoria existente si existe uno con el mismo nombre. Si se abre un archivo existente, se omitirán la capacidad, las opciones y los argumentos de memoria.
CreateOrOpen(String, Int64, MemoryMappedFileAccess, MemoryMappedFileOptions, MemoryMappedFileSecurity, HandleInheritability)	Crea o abre un archivo asignado a memoria que tiene el nombre, la capacidad, el tipo de acceso, la asignación de memoria, los permisos de seguridad y la herencia en la memoria del sistema.
CreateOrOpen(String, Int64)	Crea o abre un archivo asignado a memoria que tiene el nombre y la capacidad especificados en la memoria del sistema.
CreateOrOpen(String, Int64, MemoryMappedFileAccess)	Crea o abre un archivo asignado a memoria que tiene el nombre, la capacidad y el tipo de acceso especificados en la memoria del sistema.

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

Crea un nuevo archivo asignado a memoria vacía o abre un archivo asignado a memoria existente si existe uno con el mismo nombre. Si se abre un archivo existente, se omitirán la capacidad, las opciones y los argumentos de memoria.

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

Parámetros

mapName: String

Nombre del archivo asignado a memoria.

capacity: Int64

Tamaño máximo, en bytes, que se va a asignar al archivo asignado a memoria.

access: MemoryMappedFileAccess

Uno de los valores de enumeración que especifica el tipo de acceso permitido al archivo asignado a memoria. El valor predeterminado es ReadWrite.

options: MemoryMappedFileOptions

Combinación bit a bit de valores que indican las opciones de asignación de memoria que se aplicarán al archivo.

inheritability: HandleInheritability

Valor que especifica si un identificador del archivo asignado a memoria puede ser heredado por un proceso secundario. El valor predeterminado es None.

Devoluciones

MemoryMappedFile

Un archivo asignado a memoria que tiene las características especificadas.

Excepciones

ArgumentNullException

mapName es null.

ArgumentException

mapName es una cadena vacía.

O bien

access se establece en solo escritura con el Write valor de enumeración.

ArgumentOutOfRangeException

capacity es mayor que el tamaño del espacio de direcciones lógico.

O bien

capacity es menor o igual que cero.

O bien

access no es un valor de enumeración válido MemoryMappedFileAccess .

O bien

inheritability no es un valor de enumeración válido HandleInheritability .

UnauthorizedAccessException

El sistema operativo denegó el acceso especificado al archivo; por ejemplo, el acceso se establece Write en o ReadWrite, pero el archivo o directorio es de solo lectura.

Se aplica a

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

Crea o abre un archivo asignado a memoria que tiene el nombre, la capacidad, el tipo de acceso, la asignación de memoria, los permisos de seguridad y la herencia en la memoria del 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

Nombre del archivo asignado a memoria.

capacity: Int64

Tamaño máximo, en bytes, que se va a asignar al archivo asignado a memoria.

access: MemoryMappedFileAccess

Uno de los valores de enumeración que especifica el tipo de acceso permitido al archivo asignado a memoria. El valor predeterminado es ReadWrite.

options: MemoryMappedFileOptions

Combinación bit a bit de valores de enumeración que especifica las opciones de asignación de memoria para el archivo asignado a memoria.

memoryMappedFileSecurity: MemoryMappedFileSecurity

Los permisos que se pueden conceder para el acceso a archivos y las operaciones en archivos asignados a memoria.

Este parámetro puede ser null.

inheritability: HandleInheritability

Uno de los valores de enumeración que especifica si un identificador del archivo asignado a memoria puede heredarlo un proceso secundario. El valor predeterminado es None.

Devoluciones

MemoryMappedFile

Un archivo asignado a memoria que tiene las características especificadas.

Atributos: SecurityCriticalAttribute

Excepciones

ArgumentNullException

mapName es null.

ArgumentException

mapName es una cadena vacía.

O bien

access se establece en solo escritura con el Write valor de enumeración.

ArgumentOutOfRangeException

capacity es mayor que el tamaño del espacio de direcciones lógico.

O bien

capacity es menor o igual que cero.

O bien

access no es un valor de enumeración válido MemoryMappedFileAccess .

O bien

inheritability no es un valor de enumeración válido HandleInheritability .

UnauthorizedAccessException

El sistema operativo denegó el especificado access en el archivo; por ejemplo, access se establece Write en o ReadWrite, pero el archivo o directorio es de solo lectura.

Comentarios

Use este método para crear o abrir un archivo asignado a memoria que no se conserve (es decir, no asociado a un archivo en disco), que puede usar para compartir datos entre procesos.

Consulte también

Archivos asignados a memoria

Se aplica a

CreateOrOpen(String, Int64)

Crea o abre un archivo asignado a memoria que tiene el nombre y la capacidad especificados en la memoria del 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

Parámetros

mapName: String

Nombre del archivo asignado a memoria.

capacity: Int64

Tamaño máximo, en bytes, que se va a asignar al archivo asignado a memoria.

Devoluciones

MemoryMappedFile

Archivo asignado a memoria que tiene el nombre y el tamaño especificados.

Excepciones

ArgumentException

mapName es una cadena vacía.

ArgumentOutOfRangeException

capacity es mayor que el tamaño del espacio de direcciones lógico.

O bien

capacity es menor o igual que cero.

Comentarios

Use este método para crear o abrir un archivo asignado a memoria que no se conserve (es decir, no asociado a un archivo en disco), que puede usar para compartir datos entre procesos.

Consulte también

Archivos asignados a memoria

Se aplica a

CreateOrOpen(String, Int64, MemoryMappedFileAccess)

Crea o abre un archivo asignado a memoria que tiene el nombre, la capacidad y el tipo de acceso especificados en la memoria del 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

Parámetros

mapName: String

Nombre del archivo asignado a memoria.

capacity: Int64

Tamaño máximo, en bytes, que se va a asignar al archivo asignado a memoria.

access: MemoryMappedFileAccess

Uno de los valores de enumeración que especifica el tipo de acceso permitido al archivo asignado a memoria. El valor predeterminado es ReadWrite.

Devoluciones

MemoryMappedFile

Un archivo asignado a memoria que tiene las características especificadas.

Excepciones

ArgumentNullException

mapName es null.

ArgumentException

mapName es una cadena vacía.

O bien

access se establece en solo escritura con el Write valor de enumeración.

ArgumentOutOfRangeException

capacity es mayor que el tamaño del espacio de direcciones lógico.

O bien

capacity es menor o igual que cero.

O bien

access no es un valor de enumeración válido MemoryMappedFileAccess .

UnauthorizedAccessException

El sistema operativo denegó el acceso especificado al archivo; por ejemplo, el acceso se establece Write en o ReadWrite, pero el archivo o directorio es de solo lectura.

Comentarios

Use este método para crear o abrir un archivo asignado a memoria que no se conserve (es decir, no asociado a un archivo en disco), que puede usar para compartir datos entre procesos.

Consulte también

Archivos asignados a memoria

Se aplica a

Comentarios

¿Le ha resultado útil esta página?