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 (String, FileMode, FileAccess, FileShare, Int32, FileOptions)

 

Data di pubblicazione: ottobre 2016

Inizializza una nuova istanza della classe FileStream con il percorso, la modalità di creazione, l'autorizzazione di lettura/scrittura e condivisione, l'accesso consentito ad altri FileStream allo stesso file, la dimensione del buffer e le opzioni aggiuntive del file specificati.

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

public FileStream(
	string path,
	FileMode mode,
	FileAccess access,
	FileShare share,
	int bufferSize,
	FileOptions options
)

Parametri

path
Type: System.String

Percorso relativo o assoluto per il file che sarà incapsulato dall'oggetto FileStream corrente.

mode
Type: System.IO.FileMode

Costante che determina la modalità di apertura o di creazione del file.

access
Type: System.IO.FileAccess

Costante che determina la modalità di accesso al file da parte dell'oggetto FileStream. Determina anche i valori restituiti dalle proprietà CanRead e CanWrite dell'oggetto FileStream. CanSeek è true se path specifica un file su disco.

share
Type: System.IO.FileShare

Costante che determina la modalità di condivisione del file da parte dei processi.

bufferSize
Type: System.Int32

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

options
Type: System.IO.FileOptions

Valore che specifica le opzioni aggiuntive del file.

Exception Condition
ArgumentNullException

path è null.

ArgumentException

path è una stringa vuota (""), contiene solo spazi vuoti oppure contiene uno o più caratteri non validi.

-oppure-

path fa riferimento a dispositivi non basati su file come "con:", "com1:", "lpt1:" e così via in un ambiente NTFS.

NotSupportedException

path fa riferimento a dispositivi non basati su file come "con:", "com1:", "lpt1:" e così via in un ambiente non NTFS.

ArgumentOutOfRangeException

bufferSize è un valore negativo o zero.

-oppure-

mode, access o share contiene un valore non valido.

FileNotFoundException

Il file non è stato trovato, ad esempio se mode è FileMode.Truncate o FileMode.Open e il file specificato da path non esiste. È necessario che il file sia già disponibile in queste modalità.

IOException

Si è verificato un errore di I/O, come nel caso in cui si specifica FileMode.CreateNew e il file specificato da path è già presente.

-oppure-

Il flusso è stato chiuso.

SecurityException

Il chiamante non dispone dell'autorizzazione richiesta.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio si trova in un'unità non mappata.

UnauthorizedAccessException

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

-oppure-

Encrypted è specificato per options, ma la crittografia del file non è supportata sulla piattaforma corrente.

PathTooLongException

Il percorso specificato, il nome file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle piattaforme basate su Windows i percorsi devono contenere meno di 248 caratteri e i nomi file meno di 260 caratteri.

.NET Framework non supporta l'accesso diretto ai dischi fisici attraverso percorsi costituiti da nomi di dispositivo, ad esempio "\\.\PHYSICALDRIVE0".

Il fileOptions parametro viene utilizzato per fornire accesso alle operazioni più avanzate che possono essere sfruttati durante la creazione di un FileStream oggetto.

Il path parametro può essere un nome di file, incluso un file in una condivisione UNC Universal Naming Convention ().

System_CAPS_noteNota

path non è necessario essere un file archiviato su disco. può trattarsi di qualsiasi parte di un sistema che supporta l'accesso attraverso i flussi. Ad esempio, a seconda del sistema, questa classe può accedere a un dispositivo fisico.

CanSeek è true per tutti FileStream gli oggetti che incapsulano i file. Se path indica un dispositivo che non supporta la ricerca, la CanSeek proprietà dell'oggetto risultante FileStream è false. Per altre informazioni, vedere CanSeek.

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.

Nell'esempio seguente scrive i dati in un file e quindi legge i dati utilizzando il FileStream oggetto.

using System;
using System.IO;
using System.Text;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileStreamExample
    {
        public static void Main()
        {
            try
            {
                // Create a file and write data to it.

                // Create an array of bytes.
                byte[] messageByte = Encoding.ASCII.GetBytes("Here is some data.");

                // Create a file using the FileStream class.
                FileStream fWrite = new FileStream("test.txt", FileMode.Create, FileAccess.ReadWrite, FileShare.None, 8, FileOptions.None);

                // Write the number of bytes to the file.
                fWrite.WriteByte((byte)messageByte.Length);

                // Write the bytes to the file.
                fWrite.Write(messageByte, 0, messageByte.Length);

                // Close the stream.
                fWrite.Close();


                // Open a file and read the number of bytes.

                FileStream fRead = new FileStream("test.txt", FileMode.Open);

                // The first byte is the string length.
                int length = (int)fRead.ReadByte();

                // Create a new byte array for the data.
                byte[] readBytes = new byte[length];

                // Read the data from the file.
                fRead.Read(readBytes, 0, readBytes.Length);

                // Close the stream.
                fRead.Close();

                // Display the data.
                Console.WriteLine(Encoding.ASCII.GetString(readBytes));

                Console.WriteLine("Done writing and reading data.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }

            Console.ReadLine();
        }
    }
}

FileIOPermission

for reading, writing, and appending to files. Associated enumerations: F:System.Security.Permissions.FileIOPermissionAccess.Read, F:System.Security.Permissions.FileIOPermissionAccess.Write, and F:System.Security.Permissions.FileIOPermissionAccess.Append.

Universal Windows Platform
Disponibile da 10
.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: