Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo MemoryMappedFile.CreateFromFile (FileStream, String, Int64, MemoryMappedFileAccess, MemoryMappedFileSecurity, HandleInheritability, Boolean)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Crea un file mappato alla memoria con il nome, la capacità, il tipo di accesso, le autorizzazioni di sicurezza, l'ereditabilità e requisito di eliminazione specificati da un file su disco.

Spazio dei nomi:   System.IO.MemoryMappedFiles
Assembly:  System.Core (in System.Core.dll)

[SecurityCriticalAttribute]
[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.UnmanagedCode)]
public static MemoryMappedFile CreateFromFile(
	FileStream fileStream,
	string mapName,
	long capacity,
	MemoryMappedFileAccess access,
	MemoryMappedFileSecurity memoryMappedFileSecurity,
	HandleInheritability inheritability,
	bool leaveOpen
)

Parametri

fileStream
Type: System.IO.FileStream

Elemento fileStream per il file di cui eseguire il mapping.

mapName
Type: System.String

Nome da assegnare al file mappato alla memoria.

capacity
Type: System.Int64

Dimensioni massime, in byte, da allocare per il file mappato alla memoria. Specificare 0 per impostare la capacità sulla dimensione del file su disco.

access
Type: System.IO.MemoryMappedFiles.MemoryMappedFileAccess

Uno dei valori di enumerazione che specifica il tipo di accesso consentito al file mappato alla memoria.

Non è possibile impostare questo parametro su Write.

memoryMappedFileSecurity
Type: System.IO.MemoryMappedFiles.MemoryMappedFileSecurity

Autorizzazioni che è possibile concedere per l'accesso ai file e le operazioni sui file mappati alla memoria.

Questo parametro può essere null.

inheritability
Type: System.IO.HandleInheritability

Uno dei valori di enumerazione che specifica se un handle al file mappato alla memoria può essere ereditato da un processo figlio. Il valore predefinito è None.

leaveOpen
Type: System.Boolean

true Per non eliminare fileStream dopo il MemoryMappedFile è chiuso; false a dispose fileStream.

Valore restituito

Type: System.IO.MemoryMappedFiles.MemoryMappedFile

File mappato alla memoria con le caratteristiche specificate.

Exception Condition
ArgumentException

Il parametro mapName è una stringa vuota.

-oppure-

capacity e la lunghezza del file sono pari a zero.

-oppure-

access è stata impostata la Read o Write valore di enumerazione, non è consentito.

ArgumentNullException

fileStream o mapname è null.

ArgumentOutOfRangeException

capacity è minore di zero.

-oppure-

capacity è minore della dimensione del file.

-oppure-

access non è un valore di enumerazione MemoryMappedFileAccess valido.

-oppure-

inheritability non è un valore di enumerazione HandleInheritability valido.

ObjectDisposedException

fileStream è stata chiusa.

UnauthorizedAccessException

access è impostato su MemoryMappedFileAccess.ReadWrite quando fileStreamdell'accesso è impostato su FileAccess.Read o FileAccess.Write.

IOException

mapName esiste già.

Se capacity è maggiore di quanto la dimensione del file su disco, il file su disco viene aumentata in base alla capacità specificata anche se non vengono scritti dati al file mappato alla memoria. Per evitare questo problema, specificare 0 (zero) per la capacità predefinita che verrà impostato internamente capacity alla dimensione del file su disco.

SecurityPermission

for access to unmanaged code. Associated enumeration: F:System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode.

.NET Framework
Disponibile da 4.0
Torna all'inizio
Mostra: