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

Costruttore FileStream (IntPtr, FileAccess, Boolean, Int32, Boolean)

 

Data di pubblicazione: ottobre 2016

Nota: Questa API è ora obsoleta.

Inizializza una nuova istanza della classe FileStream per l'handle di file specificato, con l'autorizzazione di lettura/scrittura, la proprietà dell'istanza di FileStream, la dimensione del buffer e lo stato sincrono o asincrono specificati.

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

[ObsoleteAttribute("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream(
	IntPtr handle,
	FileAccess access,
	bool ownsHandle,
	int bufferSize,
	bool isAsync
)

Parametri

handle
Type: System.IntPtr

Handle di file relativo al file che sarà incapsulato nell'oggetto FileStream.

access
Type: System.IO.FileAccess

Costante che imposta le proprietà CanRead e CanWrite dell'oggetto FileStream.

ownsHandle
Type: System.Boolean

true se l'handle del file è di proprietà dell'istanza di FileStream; in caso contrario, false.

bufferSize
Type: System.Int32

Valore positivo Int32 maggiore di 0 che indica la dimensione del buffer. La dimensione del buffer predefinita è 4096.

isAsync
Type: System.Boolean

true se l'handle è stato aperto in modalità asincrona, ovvero in modalità I/O sovrapposta; in caso contrario, false.

Exception Condition
ArgumentOutOfRangeException

access è minore di FileAccess.Read o maggiore di FileAccess.ReadWrite oppure bufferSize è minore o uguale a 0.

ArgumentException

Handle non valido.

IOException

Si è verificato un errore di I/O, ad esempio un errore del disco.

-oppure-

Il flusso è stato chiuso.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

UnauthorizedAccessException

L'oggetto access richiesto non è consentito dal sistema operativo per l'handle di file specificato, ad esempio quando access è Write o ReadWrite e l'handle di file è impostato per l'accesso in sola lettura.

Il FileStream oggetto viene assegnato l'accesso specificato nel file. Sarà il proprietario dell'handle specificato. Se questo FileStream proprietario dell'handle, una chiamata al Close metodo verrà chiusa anche l'handle. In particolare, il numero di handle del file viene decrementato. Il FileStream oggetto viene impostato sulla dimensione del buffer specificati.

FileStream si presuppone che controllo esclusivo l'handle. Le operazioni di lettura, scrittura o ricerca durante un FileStream contiene inoltre un handle può provocare il danneggiamento dei dati. Per garantire la protezione dati, chiamare Flush prima di utilizzare l'handle ed evitare di chiamare qualsiasi metodo diverso da Close dopo aver completato usando l'handle. In alternativa, leggere e scrivere l'handle prima di chiamare il FileStream costruttore.

FileShare.Read è il valore predefinito per quelli FileStream costruttori senza un FileShare parametro.

System_CAPS_cautionAttenzione

Quando si compila un set di caratteri con una lingua specifica e si recuperano gli stessi caratteri con una lingua diversa, i caratteri potrebbero non essere interpretati e potrebbero generare un'eccezione viene generata.

Per un elenco di operazioni di directory e file comuni, vedere Attività di I/O comuni.

SecurityPermission

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

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