FileStream Constructeurs

Définition

Initialise une nouvelle instance de la classe FileStream.Initializes a new instance of the FileStream class.

Surcharges

FileStream(SafeFileHandle, FileAccess)

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture spécifiée.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission.

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès, le mode de création, l'autorisation de droits d'accès, l'autorisation de partage, la taille de mémoire tampon, les options de fichiers supplémentaires et la sécurité de contrôle d'accès et d'audit spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, access rights and sharing permission, the buffer size, additional file options, access control and audit security.

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)

Initialise une nouvelle instance de la classe FileStream avec le chemin d’accès, le mode de création, l’autorisation de droits d’accès, l’autorisation de partage, la taille de mémoire tampon et les options de fichiers supplémentaires spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, access rights and sharing permission, the buffer size, and additional file options.

FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès, le mode de création, l'autorisation de lecture/écriture, l'autorisation de partage, la taille de mémoire tampon et l'état synchrone ou asynchrone spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, buffer size, and synchronous or asynchronous state.

FileStream(String, FileMode, FileAccess, FileShare, Int32)

Initialise une nouvelle instance de la classe FileStream avec le chemin d’accès, le mode de création, l’autorisation de lecture/écriture, l’autorisation de partage et la taille de mémoire tampon spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, and buffer size.

FileStream(IntPtr, FileAccess, Boolean, Int32, Boolean)
Obsolète.
Obsolète.
Obsolète.

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture, la propriété de l'instance FileStream, la taille de mémoire tampon et l'état synchrone ou asynchrone spécifiés.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, FileStream instance ownership, buffer size, and synchronous or asynchronous state.

FileStream(String, FileMode, FileAccess, FileShare)

Initialise une nouvelle instance de la classe FileStream avec le chemin d’accès, le mode de création, l’autorisation de lecture/écriture et l’autorisation de partage spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write permission, and sharing permission.

FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès, le mode de création, l'autorisation d'accès en lecture/écriture et de partage, l'accès que d'autres flux de fichiers peuvent avoir au même fichier, la taille de mémoire tampon et les options de fichiers supplémentaires spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, the access other FileStreams can have to the same file, the buffer size, and additional file options.

FileStream(SafeFileHandle, FileAccess, Int32, Boolean)

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture, la taille de mémoire tampon et l'état synchrone ou asynchrone spécifiés.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, buffer size, and synchronous or asynchronous state.

FileStream(String, FileMode, FileAccess)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès, le mode de création et les autorisations de lecture/écriture spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, and read/write permission.

FileStream(IntPtr, FileAccess, Boolean)
Obsolète.
Obsolète.
Obsolète.

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture et la propriété d'instance FileStream spécifiées.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission and FileStream instance ownership.

FileStream(SafeFileHandle, FileAccess, Int32)

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture et la taille de mémoire tampon spécifiées.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, and buffer size.

FileStream(IntPtr, FileAccess, Boolean, Int32)
Obsolète.
Obsolète.
Obsolète.

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture, la propriété de l'instance FileStream et la taille de mémoire tampon spécifiées.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, FileStream instance ownership, and buffer size.

FileStream(String, FileMode)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès et le mode de création spécifiés.Initializes a new instance of the FileStream class with the specified path and creation mode.

FileStream(IntPtr, FileAccess)
Obsolète.
Obsolète.
Obsolète.

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture spécifiée.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission.

FileStream(SafeFileHandle, FileAccess)

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture spécifiée.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission.

public:
 FileStream(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::IO::FileAccess access);
public FileStream (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.IO.FileAccess access);
new System.IO.FileStream : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAccess -> System.IO.FileStream
Public Sub New (handle As SafeFileHandle, access As FileAccess)

Paramètres

handle
SafeFileHandle

Handle de fichier pour le fichier que l'objet FileStream actuel doit encapsuler.A file handle for the file that the current FileStream object will encapsulate.

access
FileAccess

Combinaison d’opérations de bits des valeurs d’énumération qui définit les propriétés CanRead et CanWrite de l’objet FileStream.A bitwise combination of the enumeration values that sets the CanRead and CanWrite properties of the FileStream object.

Exceptions

access n’est pas un champ de FileAccess.access is not a field of FileAccess.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Une erreur d’E/S, telle qu’une erreur de disque, s’est produite.An I/O error, such as a disk error, occurred.

- ou --or-

Le flux a été fermé.The stream has been closed.

Le access demandé n’est pas autorisé par le système d’exploitation pour le handle de fichier spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le handle de fichier est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access.

Remarques

Lorsque Close est appelé, le handle est également fermé et le nombre de handles du fichier est décrémenté.When Close is called, the handle is also closed and the file's handle count is decremented.

FileStream suppose qu’il a un contrôle exclusif sur le handle.FileStream assumes that it has exclusive control over the handle. La lecture, l’écriture ou la recherche d’un FileStream est également un handle qui peut entraîner une altération des données.Reading, writing, or seeking while a FileStream is also holding a handle could result in data corruption. Pour la sécurité des données, appelez Flush avant d’utiliser le handle et évitez d’appeler des méthodes autres que Close lorsque vous avez fini d’utiliser le handle.For data safety, call Flush before using the handle, and avoid calling any methods other than Close after you are done using the handle.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

FileShare.Read est la valeur par défaut pour ces FileStream constructeurs sans FileShare paramètre.FileShare.Read is the default for those FileStream constructors without a FileShare parameter.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès, le mode de création, l'autorisation de droits d'accès, l'autorisation de partage, la taille de mémoire tampon, les options de fichiers supplémentaires et la sécurité de contrôle d'accès et d'audit spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, access rights and sharing permission, the buffer size, additional file options, access control and audit security.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::Security::AccessControl::FileSystemRights rights, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public FileStream (string path, System.IO.FileMode mode, System.Security.AccessControl.FileSystemRights rights, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);
new System.IO.FileStream : string * System.IO.FileMode * System.Security.AccessControl.FileSystemRights * System.IO.FileShare * int * System.IO.FileOptions * System.Security.AccessControl.FileSecurity -> System.IO.FileStream
Public Sub New (path As String, mode As FileMode, rights As FileSystemRights, share As FileShare, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity)

Paramètres

path
String

Chemin d'accès relatif ou absolu pour le fichier que l'objet FileStream actuel doit encapsuler.A relative or absolute path for the file that the current FileStream object will encapsulate.

mode
FileMode

Une des valeurs d’énumération déterminant le mode d’ouverture ou de création du fichier.One of the enumeration values that determines how to open or create the file.

rights
FileSystemRights

Combinaison de bits des valeurs d’énumération qui détermine les droits d’accès à utiliser lors de la création de règles d'accès et d'audit pour le fichier.A bitwise combination of the enumeration values that determines the access rights to use when creating access and audit rules for the file.

share
FileShare

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier sera partagé par les processus.A bitwise combination of the enumeration values that determines how the file will be shared by processes.

bufferSize
Int32

Valeur Int32 positive supérieure à 0 indiquant la taille de la mémoire tampon.A positive Int32 value greater than 0 indicating the buffer size. La taille par défaut de la mémoire tampon est 4096.The default buffer size is 4096.

options
FileOptions

Combinaison de bits des valeurs d’énumération qui spécifie des options de fichier supplémentaires.A bitwise combination of the enumeration values that specifies additional file options.

fileSecurity
FileSecurity

Objet qui détermine la sécurité de contrôle d’accès et d’audit du fichier.An object that determines the access control and audit security for the file.

Exceptions

path a la valeur null.path is null.

path est une chaîne vide (""), contient seulement un espace blanc ou contient un ou plusieurs caractères non valides.path is an empty string (""), contains only white space, or contains one or more invalid characters.

- ou --or- path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in an NTFS environment.

path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement autre que NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in a non-NTFS environment.

bufferSize est négatif ou égal à zéro.bufferSize is negative or zero.

- ou --or- mode, access ou share contient une valeur non valide.mode, access, or share contain an invalid value.

Le fichier est introuvable, comme quand mode a pour valeur FileMode.Truncate ou FileMode.Open, et que le fichier spécifié par path n’existe pas.The file cannot be found, such as when mode is FileMode.Truncate or FileMode.Open, and the file specified by path does not exist. Le fichier doit déjà exister dans ces modes.The file must already exist in these modes.

Une erreur d’E/S s’est produite, par exemple la spécification de FileMode.CreateNew quand le fichier spécifié par path existe déjà.An I/O error, such as specifying FileMode.CreateNew when the file specified by path already exists, occurred.

- ou --or- Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le access demandé n’est pas autorisé par le système d’exploitation pour le path spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le fichier ou le répertoire est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified path, such as when access is Write or ReadWrite and the file or directory is set for read-only access.

- ou --or- Encrypted est spécifié pour options, mais le chiffrement des fichiers n’est pas pris en charge sur la plateforme actuelle.Encrypted is specified for options, but file encryption is not supported on the current platform.

path ou le nom de fichier spécifiés, ou les deux, dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

Le système d’exploitation actuel n’est pas Windows NT ou version ultérieure.The current operating system is not Windows NT or later.

Exemples

L’exemple suivant écrit des données dans un fichier, puis lit les données à l’aide de l' FileStream objet.The following example writes data to a file and then reads the data using the FileStream object.

using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::AccessControl;
using namespace System::Security::Principal;

int main()
{
    try
    {
        // Create a file and write data to it.

        // Create an array of bytes.
        array<Byte>^ messageByte =
            Encoding::ASCII->GetBytes("Here is some data.");

        // Specify an access control list (ACL)
        FileSecurity^ fs = gcnew FileSecurity();

        fs->AddAccessRule(
            gcnew FileSystemAccessRule("MYDOMAIN\\MyAccount",
            FileSystemRights::Modify, AccessControlType::Allow));

        // Create a file using the FileStream class.
        FileStream^ fWrite = gcnew FileStream("test.txt",
            FileMode::Create, FileSystemRights::Modify,
            FileShare::None, 8, FileOptions::None, fs);

        // 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 = 
            gcnew 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.
        array<Byte>^ readBytes = gcnew array<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 (IdentityNotMappedException^)
    {
        Console::WriteLine("You need to use your own credentials " +
            " 'MYDOMAIN\\MyAccount'.");
    }

    catch (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}

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.");

                // Specify an access control list (ACL)
                FileSecurity fs = new FileSecurity();

                fs.AddAccessRule(new FileSystemAccessRule(@"DOMAINNAME\AccountName",
                                                            FileSystemRights.ReadData,
                                                            AccessControlType.Allow));

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

                // 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();
        }
    }
}

Imports System.IO
Imports System.Text
Imports System.Security.AccessControl



Module FileStreamExample

    Sub Main()
        Try
            ' Create a file and write data to it.
            ' Create an array of bytes.
            Dim messageByte As Byte() = Encoding.ASCII.GetBytes("Here is some data.")

            ' Specify an access control list (ACL)
            Dim fs As New FileSecurity()

            fs.AddAccessRule(New FileSystemAccessRule("DOMAINNAME\AccountName", FileSystemRights.ReadData, AccessControlType.Allow))

            ' Create a file using the FileStream class.
            Dim fWrite As New FileStream("test.txt", FileMode.Create, FileSystemRights.Modify, FileShare.None, 8, FileOptions.None, fs)

            ' Write the number of bytes to the file.
            fWrite.WriteByte(System.Convert.ToByte(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.
            Dim fRead As New FileStream("test.txt", FileMode.Open)

            ' The first byte is the string length.
            Dim length As Integer = Fix(fRead.ReadByte())

            ' Create a new byte array for the data.
            Dim readBytes(length) As Byte

            ' 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 e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub
End Module

Remarques

Le .NET Framework ne prend pas en charge l’accès direct aux disques physiques par le biais de chemins d’accès qui sont des noms d’appareils, tels que « \ \ .\PHYSICALDRIVE0 ».The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".

Utilisez ce FileStream constructeur pour appliquer des droits d’accès au moment de la création d’un fichier.Use this FileStream constructor to apply access rights at the point of creation of a file. Pour accéder ou modifier des droits sur un fichier existant, envisagez d’utiliser les GetAccessControl SetAccessControl méthodes et.To access or modify rights on an existing file, consider using the GetAccessControl and SetAccessControl methods.

Le fileOptions paramètre est utilisé pour fournir l’accès à des opérations plus avancées qui peuvent être exploitées lors de la création d’un FileStream objet.The fileOptions parameter is used to provide access to more advanced operations that can be leveraged when creating a FileStream object.

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Notes

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.path is not required to be a file stored on disk; it can be any part of a system that supports access through streams. Par exemple, selon le système, cette classe peut accéder à un appareil physique.For example, depending on the system, this class can access a physical device.

CanSeek est true pour tous les FileStream objets qui encapsulent des fichiers.CanSeek is true for all FileStream objects that encapsulate files. Si path indique un appareil qui ne prend pas en charge la recherche, la CanSeek propriété sur le résultant FileStream est false .If path indicates a device that does not support seeking, the CanSeek property on the resulting FileStream is false. Pour plus d'informations, consultez CanSeek.For additional information, see CanSeek.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

Important

Ce constructeur n’existe pas dans .NET Core.This constructor does not exist in .NET Core. Au lieu de cela, à compter de .NET Core 3,1, vous pouvez utiliser la méthode d’extension suivante de la FileSystemAclExtensions classe à l’intérieur de l' System.Security.AccessControl assembly : Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity) .Instead, starting in .NET Core 3.1, you can use the following extension method of the FileSystemAclExtensions class inside the System.Security.AccessControl assembly: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

S’applique à

FileStream(String, FileMode, FileSystemRights, FileShare, Int32, FileOptions)

Initialise une nouvelle instance de la classe FileStream avec le chemin d’accès, le mode de création, l’autorisation de droits d’accès, l’autorisation de partage, la taille de mémoire tampon et les options de fichiers supplémentaires spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, access rights and sharing permission, the buffer size, and additional file options.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::Security::AccessControl::FileSystemRights rights, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options);
public FileStream (string path, System.IO.FileMode mode, System.Security.AccessControl.FileSystemRights rights, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options);
new System.IO.FileStream : string * System.IO.FileMode * System.Security.AccessControl.FileSystemRights * System.IO.FileShare * int * System.IO.FileOptions -> System.IO.FileStream
Public Sub New (path As String, mode As FileMode, rights As FileSystemRights, share As FileShare, bufferSize As Integer, options As FileOptions)

Paramètres

path
String

Chemin d'accès relatif ou absolu pour le fichier que l'objet FileStream actuel doit encapsuler.A relative or absolute path for the file that the current FileStream object will encapsulate.

mode
FileMode

Une des valeurs d’énumération déterminant le mode d’ouverture ou de création du fichier.One of the enumeration values that determines how to open or create the file.

rights
FileSystemRights

Combinaison de bits des valeurs d’énumération qui détermine les droits d’accès à utiliser lors de la création de règles d'accès et d'audit pour le fichier.A bitwise combination of the enumeration values that determines the access rights to use when creating access and audit rules for the file.

share
FileShare

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier sera partagé par les processus.A bitwise combination of the enumeration values that determines how the file will be shared by processes.

bufferSize
Int32

Valeur Int32 positive supérieure à 0 indiquant la taille de la mémoire tampon.A positive Int32 value greater than 0 indicating the buffer size. La taille par défaut de la mémoire tampon est 4096.The default buffer size is 4096.

options
FileOptions

Combinaison de bits des valeurs d’énumération qui spécifie des options de fichier supplémentaires.A bitwise combination of the enumeration values that specifies additional file options.

Exceptions

path a la valeur null.path is null.

path est une chaîne vide (""), contient seulement un espace blanc ou contient un ou plusieurs caractères non valides.path is an empty string (""), contains only white space, or contains one or more invalid characters.

- ou --or- path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in an NTFS environment.

path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement autre que NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in a non-NTFS environment.

bufferSize est négatif ou égal à zéro.bufferSize is negative or zero.

- ou --or- mode, access ou share contient une valeur non valide.mode, access, or share contain an invalid value.

Le fichier est introuvable, comme quand mode a pour valeur FileMode.Truncate ou FileMode.Open, et que le fichier spécifié par path n’existe pas.The file cannot be found, such as when mode is FileMode.Truncate or FileMode.Open, and the file specified by path does not exist. Le fichier doit déjà exister dans ces modes.The file must already exist in these modes.

Le système d’exploitation actuel n’est pas Windows NT ou version ultérieure.The current operating system is not Windows NT or later.

Une erreur d’E/S s’est produite, par exemple la spécification de FileMode.CreateNew quand le fichier spécifié par path existe déjà.An I/O error, such as specifying FileMode.CreateNew when the file specified by path already exists, occurred.

- ou --or- Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le access demandé n’est pas autorisé par le système d’exploitation pour le path spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le fichier ou le répertoire est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified path, such as when access is Write or ReadWrite and the file or directory is set for read-only access.

- ou --or- Encrypted est spécifié pour options, mais le chiffrement des fichiers n’est pas pris en charge sur la plateforme actuelle.Encrypted is specified for options, but file encryption is not supported on the current platform.

path ou le nom de fichier spécifiés, ou les deux, dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

Remarques

Le .NET Framework ne prend pas en charge l’accès direct aux disques physiques par le biais de chemins d’accès qui sont des noms d’appareils, tels que « \ \ .\PHYSICALDRIVE0 ».The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".

Utilisez ce FileStream constructeur pour appliquer des droits d’accès au moment de la création d’un fichier.Use this FileStream constructor to apply access rights at the point of creation of a file. Pour accéder ou modifier des droits sur un fichier existant, envisagez d’utiliser les GetAccessControl SetAccessControl méthodes et.To access or modify rights on an existing file, consider using the GetAccessControl and SetAccessControl methods.

Le fileOptions paramètre est utilisé pour fournir l’accès à des opérations plus avancées qui peuvent être exploitées lors de la création d’un FileStream objet.The fileOptions parameter is used to provide access to more advanced operations that can be leveraged when creating a FileStream object.

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Notes

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.path is not required to be a file stored on disk; it can be any part of a system that supports access through streams. Par exemple, selon le système, cette classe peut accéder à un appareil physique.For example, depending on the system, this class can access a physical device.

CanSeek est true pour tous les FileStream objets qui encapsulent des fichiers.CanSeek is true for all FileStream objects that encapsulate files. Si path indique un appareil qui ne prend pas en charge la recherche, la CanSeek propriété sur le résultant FileStream est false .If path indicates a device that does not support seeking, the CanSeek property on the resulting FileStream is false. Pour plus d'informations, consultez CanSeek.For additional information, see CanSeek.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(String, FileMode, FileAccess, FileShare, Int32, Boolean)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès, le mode de création, l'autorisation de lecture/écriture, l'autorisation de partage, la taille de mémoire tampon et l'état synchrone ou asynchrone spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, buffer size, and synchronous or asynchronous state.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, bool useAsync);
public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, bool useAsync);
new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * bool -> System.IO.FileStream
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, useAsync As Boolean)

Paramètres

path
String

Chemin d'accès relatif ou absolu pour le fichier que l'objet FileStream actuel doit encapsuler.A relative or absolute path for the file that the current FileStream object will encapsulate.

mode
FileMode

Une des valeurs d’énumération déterminant le mode d’ouverture ou de création du fichier.One of the enumeration values that determines how to open or create the file.

access
FileAccess

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier peut être accessible par l’objet FileStream.A bitwise combination of the enumeration values that determines how the file can be accessed by the FileStream object. Détermine aussi les valeurs retournées par les propriétés CanRead et CanWrite de l'objet FileStream.This also determines the values returned by the CanRead and CanWrite properties of the FileStream object. CanSeek a la valeur true si path spécifie un fichier sur disque.CanSeek is true if path specifies a disk file.

share
FileShare

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier sera partagé par les processus.A bitwise combination of the enumeration values that determines how the file will be shared by processes.

bufferSize
Int32

Valeur Int32 positive supérieure à 0 indiquant la taille de la mémoire tampon.A positive Int32 value greater than 0 indicating the buffer size. La taille par défaut de la mémoire tampon est 4096.The default buffer size is 4096.

useAsync
Boolean

Spécifie s'il faut utiliser des E/S asynchrones ou synchrones.Specifies whether to use asynchronous I/O or synchronous I/O. Notez cependant qu’il est possible que le système d’exploitation sous-jacent ne prenne pas en charge les E/S asynchrones. Par conséquent, si vous spécifiez true, le handle peut être ouvert de façon synchrone en fonction de la plateforme.However, note that the underlying operating system might not support asynchronous I/O, so when specifying true, the handle might be opened synchronously depending on the platform. Quand le mode asynchrone est utilisé, les méthodes BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) et BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) donnent de meilleurs résultats pour des lectures ou des écritures de données volumineuses, mais elles peuvent être beaucoup plus lentes quand il s'agit de lectures et d'écritures de données de petite taille.When opened asynchronously, the BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) and BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) methods perform better on large reads or writes, but they might be much slower for small reads or writes. Si l'application est conçue pour tirer parti des E/S asynchrones, affectez au paramètre useAsync la valeur true.If the application is designed to take advantage of asynchronous I/O, set the useAsync parameter to true. Quand les E/S asynchrones sont utilisées correctement, elles peuvent rendre les applications jusqu'à 10 fois plus rapides. Toutefois, si vous les utilisez dans une application qui n'a pas été reconfigurée pour les E/S asynchrones, l'application peut être jusqu'à 10 fois moins performante.Using asynchronous I/O correctly can speed up applications by as much as a factor of 10, but using it without redesigning the application for asynchronous I/O can decrease performance by as much as a factor of 10.

Exceptions

path a la valeur null.path is null.

path est une chaîne vide (""), contient seulement un espace blanc ou contient un ou plusieurs caractères non valides.path is an empty string (""), contains only white space, or contains one or more invalid characters.

- ou --or- path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in an NTFS environment.

path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement autre que NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in a non-NTFS environment.

bufferSize est négatif ou égal à zéro.bufferSize is negative or zero.

- ou --or- mode, access ou share contient une valeur non valide.mode, access, or share contain an invalid value.

Le fichier est introuvable, comme quand mode a pour valeur FileMode.Truncate ou FileMode.Open, et que le fichier spécifié par path n’existe pas.The file cannot be found, such as when mode is FileMode.Truncate or FileMode.Open, and the file specified by path does not exist. Le fichier doit déjà exister dans ces modes.The file must already exist in these modes.

Une erreur d’E/S s’est produite, par exemple la spécification de FileMode.CreateNew quand le fichier spécifié par path existe déjà.An I/O error, such as specifying FileMode.CreateNew when the file specified by path already exists, occurred.

- ou --or- Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le access demandé n’est pas autorisé par le système d’exploitation pour le path spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le fichier ou le répertoire est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified path, such as when access is Write or ReadWrite and the file or directory is set for read-only access.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

Exemples

L’exemple de code suivant montre comment écrire des données de façon asynchrone dans un fichier, puis vérifier que les données ont été correctement écrites.The following code example shows how to asynchronously write data to a file and then verify that the data was written correctly. Un State objet est créé pour passer des informations du thread principal aux EndReadCallback méthodes et EndWriteCallback .A State object is created to pass information from the main thread to the EndReadCallback and EndWriteCallback methods.

using namespace System;
using namespace System::IO;
using namespace System::Threading;

// Maintain state information to be passed to 
// EndWriteCallback and EndReadCallback.
ref class State
{
private:

   // fStream is used to read and write to the file.
   FileStream^ fStream;

   // writeArray stores data that is written to the file.
   array<Byte>^writeArray;

   // readArray stores data that is read from the file.
   array<Byte>^readArray;

   // manualEvent signals the main thread 
   // when verification is complete.
   ManualResetEvent^ manualEvent;

public:
   State( FileStream^ fStream, array<Byte>^writeArray, ManualResetEvent^ manualEvent )
   {
      this->fStream = fStream;
      this->writeArray = writeArray;
      this->manualEvent = manualEvent;
      readArray = gcnew array<Byte>(writeArray->Length);
   }


   property FileStream^ FStream 
   {
      FileStream^ get()
      {
         return fStream;
      }

   }

   property array<Byte>^ WriteArray 
   {
      array<Byte>^ get()
      {
         return writeArray;
      }

   }

   property array<Byte>^ ReadArray 
   {
      array<Byte>^ get()
      {
         return readArray;
      }

   }

   property ManualResetEvent^ ManualEvent 
   {
      ManualResetEvent^ get()
      {
         return manualEvent;
      }

   }

};

ref class FStream
{
private:

   // When BeginRead is finished reading data from the file, the 
   // EndReadCallback method is called to end the asynchronous 
   // read operation and then verify the data.
   static void EndReadCallback( IAsyncResult^ asyncResult )
   {
      State^ tempState = dynamic_cast<State^>(asyncResult->AsyncState);
      int readCount = tempState->FStream->EndRead( asyncResult );
      int i = 0;
      while ( i < readCount )
      {
         if ( tempState->ReadArray[ i ] != tempState->WriteArray[ i++ ] )
         {
            Console::WriteLine( "Error writing data." );
            tempState->FStream->Close();
            return;
         }
      }

      Console::WriteLine( "The data was written to {0} "
      "and verified.", tempState->FStream->Name );
      tempState->FStream->Close();
      
      // Signal the main thread that the verification is finished.
      tempState->ManualEvent->Set();
   }


public:

   // When BeginWrite is finished writing data to the file, the
   // EndWriteCallback method is called to end the asynchronous 
   // write operation and then read back and verify the data.
   static void EndWriteCallback( IAsyncResult^ asyncResult )
   {
      State^ tempState = dynamic_cast<State^>(asyncResult->AsyncState);
      FileStream^ fStream = tempState->FStream;
      fStream->EndWrite( asyncResult );
      
      // Asynchronously read back the written data.
      fStream->Position = 0;
      asyncResult = fStream->BeginRead( tempState->ReadArray, 0, tempState->ReadArray->Length, gcnew AsyncCallback( &FStream::EndReadCallback ), tempState );
      
      // Concurrently do other work, such as 
      // logging the write operation.
   }

};


int main()
{
   
   // Create a synchronization object that gets 
   // signaled when verification is complete.
   ManualResetEvent^ manualEvent = gcnew ManualResetEvent( false );
   
   // Create the data to write to the file.
   array<Byte>^writeArray = gcnew array<Byte>(100000);
   (gcnew Random)->NextBytes( writeArray );
   FileStream^ fStream = gcnew FileStream(  "Test#@@#.dat",FileMode::Create,FileAccess::ReadWrite,FileShare::None,4096,true );
   
   // Check that the FileStream was opened asynchronously.
   Console::WriteLine( "fStream was {0}opened asynchronously.", fStream->IsAsync ? (String^)"" : "not " );
   
   // Asynchronously write to the file.
   IAsyncResult^ asyncResult = fStream->BeginWrite( writeArray, 0, writeArray->Length, gcnew AsyncCallback( &FStream::EndWriteCallback ), gcnew State( fStream,writeArray,manualEvent ) );
   
   // Concurrently do other work and then wait 
   // for the data to be written and verified.
   manualEvent->WaitOne( 5000, false );
}

using System;
using System.IO;
using System.Threading;

class FStream
{
    static void Main()
    {
        // Create a synchronization object that gets
        // signaled when verification is complete.
        ManualResetEvent manualEvent = new ManualResetEvent(false);

        // Create random data to write to the file.
        byte[] writeArray = new byte[100000];
        new Random().NextBytes(writeArray);

        FileStream fStream =
            new FileStream("Test#@@#.dat", FileMode.Create,
            FileAccess.ReadWrite, FileShare.None, 4096, true);

        // Check that the FileStream was opened asynchronously.
        Console.WriteLine("fStream was {0}opened asynchronously.",
            fStream.IsAsync ? "" : "not ");

        // Asynchronously write to the file.
        IAsyncResult asyncResult = fStream.BeginWrite(
            writeArray, 0, writeArray.Length,
            new AsyncCallback(EndWriteCallback),
            new State(fStream, writeArray, manualEvent));

        // Concurrently do other work and then wait
        // for the data to be written and verified.
        manualEvent.WaitOne(5000, false);
    }

    // When BeginWrite is finished writing data to the file, the
    // EndWriteCallback method is called to end the asynchronous
    // write operation and then read back and verify the data.
    static void EndWriteCallback(IAsyncResult asyncResult)
    {
        State tempState = (State)asyncResult.AsyncState;
        FileStream fStream = tempState.FStream;
        fStream.EndWrite(asyncResult);

        // Asynchronously read back the written data.
        fStream.Position = 0;
        asyncResult = fStream.BeginRead(
            tempState.ReadArray, 0 , tempState.ReadArray.Length,
            new AsyncCallback(EndReadCallback), tempState);

        // Concurrently do other work, such as
        // logging the write operation.
    }

    // When BeginRead is finished reading data from the file, the
    // EndReadCallback method is called to end the asynchronous
    // read operation and then verify the data.
    static void EndReadCallback(IAsyncResult asyncResult)
    {
        State tempState = (State)asyncResult.AsyncState;
        int readCount = tempState.FStream.EndRead(asyncResult);

        int i = 0;
        while(i < readCount)
        {
            if(tempState.ReadArray[i] != tempState.WriteArray[i++])
            {
                Console.WriteLine("Error writing data.");
                tempState.FStream.Close();
                return;
            }
        }
        Console.WriteLine("The data was written to {0} and verified.",
            tempState.FStream.Name);
        tempState.FStream.Close();

        // Signal the main thread that the verification is finished.
        tempState.ManualEvent.Set();
    }

    // Maintain state information to be passed to
    // EndWriteCallback and EndReadCallback.
    class State
    {
        // fStream is used to read and write to the file.
        FileStream fStream;

        // writeArray stores data that is written to the file.
        byte[] writeArray;

        // readArray stores data that is read from the file.
        byte[] readArray;

        // manualEvent signals the main thread
        // when verification is complete.
        ManualResetEvent manualEvent;

        public State(FileStream fStream, byte[] writeArray,
            ManualResetEvent manualEvent)
        {
            this.fStream   = fStream;
            this.writeArray = writeArray;
            this.manualEvent = manualEvent;
            readArray = new byte[writeArray.Length];
        }

        public FileStream FStream
        { get{ return fStream; } }

        public byte[] WriteArray
        { get{ return writeArray; } }

        public byte[] ReadArray
        { get{ return readArray; } }

        public ManualResetEvent ManualEvent
        { get{ return manualEvent; } }
    }
}
Imports System.IO
Imports System.Threading

Class FStream

    Shared Sub Main()

        ' Create a synchronization object that gets 
        ' signaled when verification is complete.
        Dim manualEvent As New ManualResetEvent(False)

        ' Create random data to write to the file.
        Dim writeArray(100000) As Byte
        Dim randomGenerator As New Random()
        randomGenerator.NextBytes(writeArray)

        Dim fStream As New FileStream("Test#@@#.dat", _
            FileMode.Create, FileAccess.ReadWrite, _
            FileShare.None, 4096, True)

        ' Check that the FileStream was opened asynchronously.
        If fStream.IsAsync = True
            Console.WriteLine("fStream was opened asynchronously.")
        Else
            Console.WriteLine("fStream was not opened asynchronously.")
        End If

        ' Asynchronously write to the file.
        Dim asyncResult As IAsyncResult = fStream.BeginWrite( _
            writeArray, 0, writeArray.Length, _
            AddressOf EndWriteCallback , _
            New State(fStream, writeArray, manualEvent))

        ' Concurrently do other work and then wait
        ' for the data to be written and verified.
        manualEvent.WaitOne(5000, False)
    End Sub

    ' When BeginWrite is finished writing data to the file, the
    ' EndWriteCallback method is called to end the asynchronous 
    ' write operation and then read back and verify the data.
    Private Shared Sub EndWriteCallback(asyncResult As IAsyncResult)
        Dim tempState As State = _
            DirectCast(asyncResult.AsyncState, State)
        Dim fStream As FileStream = tempState.FStream
        fStream.EndWrite(asyncResult)

        ' Asynchronously read back the written data.
        fStream.Position = 0
        asyncResult = fStream.BeginRead( _ 
            tempState.ReadArray, 0 , tempState.ReadArray.Length, _
            AddressOf EndReadCallback, tempState)

        ' Concurrently do other work, such as 
        ' logging the write operation.
    End Sub

    ' When BeginRead is finished reading data from the file, the 
    ' EndReadCallback method is called to end the asynchronous 
    ' read operation and then verify the data.
   Private Shared Sub EndReadCallback(asyncResult As IAsyncResult)
        Dim tempState As State = _
            DirectCast(asyncResult.AsyncState, State)
        Dim readCount As Integer = _
            tempState.FStream.EndRead(asyncResult)

        Dim i As Integer = 0
        While(i < readCount)
            If(tempState.ReadArray(i) <> tempState.WriteArray(i))
                Console.WriteLine("Error writing data.")
                tempState.FStream.Close()
                Return
            End If
            i += 1
        End While

        Console.WriteLine("The data was written to {0} and " & _
            "verified.", tempState.FStream.Name)
        tempState.FStream.Close()

        ' Signal the main thread that the verification is finished.
        tempState.ManualEvent.Set()
    End Sub

    ' Maintain state information to be passed to 
    ' EndWriteCallback and EndReadCallback.
    Private Class State

        ' fStreamValue is used to read and write to the file.
        Dim fStreamValue As FileStream

        ' writeArrayValue stores data that is written to the file.
        Dim writeArrayValue As Byte()

        ' readArrayValue stores data that is read from the file.
        Dim readArrayValue As Byte()

        ' manualEvent signals the main thread 
        ' when verification is complete.
        Dim manualEventValue As ManualResetEvent 

        Sub New(aStream As FileStream, anArray As Byte(), _
            manualEvent As ManualResetEvent)

            fStreamValue     = aStream
            writeArrayValue  = anArray
            manualEventValue = manualEvent
            readArrayValue   = New Byte(anArray.Length - 1){}
        End Sub    

            Public ReadOnly Property FStream() As FileStream
                Get
                    Return fStreamValue
                End Get
            End Property

            Public ReadOnly Property WriteArray() As Byte()
                Get
                    Return writeArrayValue
                End Get
            End Property

            Public ReadOnly Property ReadArray() As Byte()
                Get
                    Return readArrayValue
                End Get
            End Property

            Public ReadOnly Property ManualEvent() As ManualResetEvent
                Get
                    Return manualEventValue
                End Get
            End Property
    End Class 
   
End Class

Remarques

Le .NET Framework ne prend pas en charge l’accès direct aux disques physiques par le biais de chemins d’accès qui sont des noms d’appareils, tels que « \ \ .\PHYSICALDRIVE0 ».The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Notes

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.path is not required to be a file stored on disk; it can be any part of a system that supports access through streams. Par exemple, selon le système, cette classe peut accéder à un appareil physique.For example, depending on the system, this class can access a physical device.

CanSeek est true pour tous les FileStream objets qui encapsulent des fichiers.CanSeek is true for all FileStream objects that encapsulate files. Si path indique un appareil qui ne prend pas en charge la recherche, la CanSeek propriété sur le résultant FileStream est false .If path indicates a device that does not support seeking, the CanSeek property on the resulting FileStream is false. Pour plus d'informations, consultez CanSeek.For additional information, see CanSeek.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

Voir aussi

S’applique à

FileStream(String, FileMode, FileAccess, FileShare, Int32)

Initialise une nouvelle instance de la classe FileStream avec le chemin d’accès, le mode de création, l’autorisation de lecture/écriture, l’autorisation de partage et la taille de mémoire tampon spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, and buffer size.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize);
public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize);
new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int -> System.IO.FileStream
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer)

Paramètres

path
String

Chemin d'accès relatif ou absolu pour le fichier que l'objet FileStream actuel doit encapsuler.A relative or absolute path for the file that the current FileStream object will encapsulate.

mode
FileMode

Une des valeurs d’énumération déterminant le mode d’ouverture ou de création du fichier.One of the enumeration values that determines how to open or create the file.

access
FileAccess

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier peut être accessible par l’objet FileStream.A bitwise combination of the enumeration values that determines how the file can be accessed by the FileStream object. Détermine aussi les valeurs retournées par les propriétés CanRead et CanWrite de l'objet FileStream.This also determines the values returned by the CanRead and CanWrite properties of the FileStream object. CanSeek a la valeur true si path spécifie un fichier sur disque.CanSeek is true if path specifies a disk file.

share
FileShare

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier sera partagé par les processus.A bitwise combination of the enumeration values that determines how the file will be shared by processes.

bufferSize
Int32

Valeur Int32 positive supérieure à 0 indiquant la taille de la mémoire tampon.A positive Int32 value greater than 0 indicating the buffer size. La taille par défaut de la mémoire tampon est 4096.The default buffer size is 4096.

Exceptions

path a la valeur null.path is null.

path est une chaîne vide (""), contient seulement un espace blanc ou contient un ou plusieurs caractères non valides.path is an empty string (""), contains only white space, or contains one or more invalid characters.

- ou --or- path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in an NTFS environment.

path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement autre que NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in a non-NTFS environment.

bufferSize est négatif ou égal à zéro.bufferSize is negative or zero.

- ou --or- mode, access ou share contient une valeur non valide.mode, access, or share contain an invalid value.

Le fichier est introuvable, comme quand mode a pour valeur FileMode.Truncate ou FileMode.Open, et que le fichier spécifié par path n’existe pas.The file cannot be found, such as when mode is FileMode.Truncate or FileMode.Open, and the file specified by path does not exist. Le fichier doit déjà exister dans ces modes.The file must already exist in these modes.

Une erreur d’E/S s’est produite, par exemple la spécification de FileMode.CreateNew quand le fichier spécifié par path existe déjà.An I/O error, such as specifying FileMode.CreateNew when the file specified by path already exists, occurred.

- ou --or- Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le access demandé n’est pas autorisé par le système d’exploitation pour le path spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le fichier ou le répertoire est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified path, such as when access is Write or ReadWrite and the file or directory is set for read-only access.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

Remarques

Le .NET Framework ne prend pas en charge l’accès direct aux disques physiques par le biais de chemins d’accès qui sont des noms d’appareils, tels que « \ \ .\PHYSICALDRIVE0 ».The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Notes

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.path is not required to be a file stored on disk; it can be any part of a system that supports access through streams. Par exemple, selon le système, cette classe peut accéder à un appareil physique.For example, depending on the system, this class can access a physical device.

CanSeek est true pour tous les FileStream objets qui encapsulent des fichiers.CanSeek is true for all FileStream objects that encapsulate files. Si path indique un appareil qui ne prend pas en charge la recherche, la CanSeek propriété sur le résultant FileStream est false .If path indicates a device that does not support seeking, the CanSeek property on the resulting FileStream is false. Pour plus d'informations, consultez CanSeek.For additional information, see CanSeek.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

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

Attention

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. https://go.microsoft.com/fwlink/?linkid=14202

Attention

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

Attention

Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture, la propriété de l'instance FileStream, la taille de mémoire tampon et l'état synchrone ou asynchrone spécifiés.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, FileStream instance ownership, buffer size, and synchronous or asynchronous state.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);
[System.Obsolete("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.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);
[System.Obsolete("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, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);
[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize, bool isAsync);
[<System.Obsolete("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.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream
[<System.Obsolete("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")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream
[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize, bool isAsync) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int * bool -> System.IO.FileStream
Public Sub New (handle As IntPtr, access As FileAccess, ownsHandle As Boolean, bufferSize As Integer, isAsync As Boolean)

Paramètres

handle
IntPtr

Handle de fichier pour le fichier que cet objet FileStream encapsulera.A file handle for the file that this FileStream object will encapsulate.

access
FileAccess

Combinaison d’opérations de bits des valeurs d’énumération qui définit les propriétés CanRead et CanWrite de l’objet FileStream.A bitwise combination of the enumeration values that sets the CanRead and CanWrite properties of the FileStream object.

ownsHandle
Boolean

true si le handle de fichier appartiendra à cette instance de FileStream ; sinon, false.true if the file handle will be owned by this FileStream instance; otherwise, false.

bufferSize
Int32

Valeur Int32 positive supérieure à 0 indiquant la taille de la mémoire tampon.A positive Int32 value greater than 0 indicating the buffer size. La taille par défaut de la mémoire tampon est 4096.The default buffer size is 4096.

isAsync
Boolean

true si le handle a été ouvert de façon asynchrone (c'est-à-dire en mode E/S avec chevauchement) ; sinon, false.true if the handle was opened asynchronously (that is, in overlapped I/O mode); otherwise, false.

Attributs

Exceptions

access est inférieur à FileAccess.Read ou supérieur à FileAccess.ReadWrite ou bufferSize est inférieur ou égal à 0.access is less than FileAccess.Read or greater than FileAccess.ReadWrite or bufferSize is less than or equal to 0.

Le handle n'est pas valide.The handle is invalid.

Une erreur d’E/S, telle qu’une erreur de disque, s’est produite.An I/O error, such as a disk error, occurred.

- ou --or-

Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le access demandé n’est pas autorisé par le système d’exploitation pour le handle de fichier spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le handle de fichier est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access.

Remarques

L' FileStream accès au fichier est attribué à l’objet.The FileStream object is given the specified access to the file. La propriété du descripteur sera la même que celle spécifiée.The ownership of the handle will be as specified. Si ce FileStream est le propriétaire du handle, un appel à la Close méthode ferme également le handle.If this FileStream owns the handle, a call to the Close method will also close the handle. En particulier, le nombre de handles du fichier est décrémenté.In particular, the file's handle count is decremented. La FileStream taille de la mémoire tampon spécifiée est affectée à l’objet.The FileStream object is given the specified buffer size.

FileStream suppose qu’il a un contrôle exclusif sur le handle.FileStream assumes that it has exclusive control over the handle. La lecture, l’écriture ou la recherche d’un FileStream est également un handle qui peut entraîner une altération des données.Reading, writing, or seeking while a FileStream is also holding a handle could result in data corruption. Pour la sécurité des données, appelez Flush avant d’utiliser le handle et évitez d’appeler des méthodes autres que Close lorsque vous avez fini d’utiliser le handle.For data safety, call Flush before using the handle, and avoid calling any methods other than Close after you are done using the handle. Vous pouvez également lire et écrire dans le handle avant d’appeler ce FileStream constructeur.Alternately, read and write to the handle before calling this FileStream constructor.

FileShare.Read est la valeur par défaut pour ces FileStream constructeurs sans FileShare paramètre.FileShare.Read is the default for those FileStream constructors without a FileShare parameter.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(String, FileMode, FileAccess, FileShare)

Initialise une nouvelle instance de la classe FileStream avec le chemin d’accès, le mode de création, l’autorisation de lecture/écriture et l’autorisation de partage spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write permission, and sharing permission.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share);
public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share);
new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare -> System.IO.FileStream
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare)

Paramètres

path
String

Chemin d'accès relatif ou absolu pour le fichier que l'objet FileStream actuel doit encapsuler.A relative or absolute path for the file that the current FileStream object will encapsulate.

mode
FileMode

Une des valeurs d’énumération déterminant le mode d’ouverture ou de création du fichier.One of the enumeration values that determines how to open or create the file.

access
FileAccess

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier peut être accessible par l’objet FileStream.A bitwise combination of the enumeration values that determines how the file can be accessed by the FileStream object. Détermine aussi les valeurs retournées par les propriétés CanRead et CanWrite de l'objet FileStream.This also determines the values returned by the CanRead and CanWrite properties of the FileStream object. CanSeek a la valeur true si path spécifie un fichier sur disque.CanSeek is true if path specifies a disk file.

share
FileShare

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier sera partagé par les processus.A bitwise combination of the enumeration values that determines how the file will be shared by processes.

Exceptions

path a la valeur null.path is null.

path est une chaîne vide (""), contient seulement un espace blanc ou contient un ou plusieurs caractères non valides.path is an empty string (""), contains only white space, or contains one or more invalid characters.

- ou --or- path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in an NTFS environment.

path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement autre que NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in a non-NTFS environment.

Le fichier est introuvable, comme quand mode a pour valeur FileMode.Truncate ou FileMode.Open, et que le fichier spécifié par path n’existe pas.The file cannot be found, such as when mode is FileMode.Truncate or FileMode.Open, and the file specified by path does not exist. Le fichier doit déjà exister dans ces modes.The file must already exist in these modes.

Une erreur d’E/S s’est produite, par exemple la spécification de FileMode.CreateNew quand le fichier spécifié par path existe déjà.An I/O error, such as specifying FileMode.CreateNew when the file specified by path already exists, occurred.

- ou --or- Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le access demandé n’est pas autorisé par le système d’exploitation pour le path spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le fichier ou le répertoire est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified path, such as when access is Write or ReadWrite and the file or directory is set for read-only access.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

mode contient une valeur non valide.mode contains an invalid value.

Exemples

Cet exemple de code fait partie d’un exemple plus complet fourni pour la Lock méthode.This code example is part of a larger example provided for the Lock method.

FileStream^ fileStream = gcnew FileStream( "Test#@@#.dat",FileMode::OpenOrCreate,FileAccess::ReadWrite,FileShare::ReadWrite );

using(FileStream fileStream = new FileStream(
    "Test#@@#.dat", FileMode.OpenOrCreate,
    FileAccess.ReadWrite, FileShare.ReadWrite))
Dim aFileStream As New FileStream( _
    "Test#@@#.dat", FileMode.OpenOrCreate, _
    FileAccess.ReadWrite, FileShare.ReadWrite)

Remarques

Le .NET Framework ne prend pas en charge l’accès direct aux disques physiques par le biais de chemins d’accès qui sont des noms d’appareils, tels que « \ \ .\PHYSICALDRIVE0 ».The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Le constructeur reçoit un accès en lecture/écriture au fichier, et il est ouvert en partageant l’accès en lecture (autrement dit, les demandes d’ouverture du fichier en écriture par ce processus ou un autre processus échouent tant que l' FileStream objet n’a pas été fermé, mais les tentatives de lecture réussissent).The constructor is given read/write access to the file, and it is opened sharing Read access (that is, requests to open the file for writing by this or another process will fail until the FileStream object has been closed, but read attempts will succeed). La taille de la mémoire tampon est définie sur la taille par défaut de 4096 octets (4 Ko).The buffer size is set to the default size of 4096 bytes (4 KB).

Notes

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.path is not required to be a file stored on disk; it can be any part of a system that supports access through streams. Par exemple, selon le système, cette classe peut accéder à un appareil physique.For example, depending on the system, this class can access a physical device.

CanSeek est true pour tous les FileStream objets qui encapsulent des fichiers.CanSeek is true for all FileStream objects that encapsulate files. Si path indique un appareil qui ne prend pas en charge la recherche, la CanSeek propriété sur le résultant FileStream est false .If path indicates a device that does not support seeking, the CanSeek property on the resulting FileStream is false. Pour plus d'informations, consultez CanSeek.For additional information, see CanSeek.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(String, FileMode, FileAccess, FileShare, Int32, FileOptions)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès, le mode de création, l'autorisation d'accès en lecture/écriture et de partage, l'accès que d'autres flux de fichiers peuvent avoir au même fichier, la taille de mémoire tampon et les options de fichiers supplémentaires spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, read/write and sharing permission, the access other FileStreams can have to the same file, the buffer size, and additional file options.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access, System::IO::FileShare share, int bufferSize, System::IO::FileOptions options);
public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access, System.IO.FileShare share, int bufferSize, System.IO.FileOptions options);
new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * int * System.IO.FileOptions -> System.IO.FileStream
Public Sub New (path As String, mode As FileMode, access As FileAccess, share As FileShare, bufferSize As Integer, options As FileOptions)

Paramètres

path
String

Chemin d'accès relatif ou absolu pour le fichier que l'objet FileStream actuel doit encapsuler.A relative or absolute path for the file that the current FileStream object will encapsulate.

mode
FileMode

Une des valeurs d’énumération déterminant le mode d’ouverture ou de création du fichier.One of the enumeration values that determines how to open or create the file.

access
FileAccess

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier peut être accessible par l’objet FileStream.A bitwise combination of the enumeration values that determines how the file can be accessed by the FileStream object. Détermine aussi les valeurs retournées par les propriétés CanRead et CanWrite de l'objet FileStream.This also determines the values returned by the CanRead and CanWrite properties of the FileStream object. CanSeek a la valeur true si path spécifie un fichier sur disque.CanSeek is true if path specifies a disk file.

share
FileShare

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier sera partagé par les processus.A bitwise combination of the enumeration values that determines how the file will be shared by processes.

bufferSize
Int32

Valeur Int32 positive supérieure à 0 indiquant la taille de la mémoire tampon.A positive Int32 value greater than 0 indicating the buffer size. La taille par défaut de la mémoire tampon est 4096.The default buffer size is 4096.

options
FileOptions

Combinaison de bits des valeurs d’énumération qui spécifie des options de fichier supplémentaires.A bitwise combination of the enumeration values that specifies additional file options.

Exceptions

path a la valeur null.path is null.

path est une chaîne vide (""), contient seulement un espace blanc ou contient un ou plusieurs caractères non valides.path is an empty string (""), contains only white space, or contains one or more invalid characters.

- ou --or- path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in an NTFS environment.

path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement autre que NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in a non-NTFS environment.

bufferSize est négatif ou égal à zéro.bufferSize is negative or zero.

- ou --or- mode, access ou share contient une valeur non valide.mode, access, or share contain an invalid value.

Le fichier est introuvable, comme quand mode a pour valeur FileMode.Truncate ou FileMode.Open, et que le fichier spécifié par path n’existe pas.The file cannot be found, such as when mode is FileMode.Truncate or FileMode.Open, and the file specified by path does not exist. Le fichier doit déjà exister dans ces modes.The file must already exist in these modes.

Une erreur d’E/S s’est produite, par exemple la spécification de FileMode.CreateNew quand le fichier spécifié par path existe déjà.An I/O error, such as specifying FileMode.CreateNew when the file specified by path already exists, occurred.

- ou --or- Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le access demandé n’est pas autorisé par le système d’exploitation pour le path spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le fichier ou le répertoire est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified path, such as when access is Write or ReadWrite and the file or directory is set for read-only access.

- ou --or- Encrypted est spécifié pour options, mais le chiffrement des fichiers n’est pas pris en charge sur la plateforme actuelle.Encrypted is specified for options, but file encryption is not supported on the current platform.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

Exemples

L’exemple suivant écrit des données dans un fichier, puis lit les données à l’aide de l' FileStream objet.The following example writes data to a file and then reads the data using the FileStream object.

#using <System.dll>

using namespace System;
using namespace System::IO;
using namespace System::Text;
using namespace System::Security::AccessControl;

int main()
{
    try
    {
        // Create a file and write data to it.

        // Create an array of bytes.
        array<Byte>^ messageByte =
            Encoding::ASCII->GetBytes("Here is some data.");

        // Create a file using the FileStream class.
        FileStream^ fWrite = gcnew 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 = gcnew 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.
        array<Byte>^ readBytes = gcnew array<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 (IOException^ ex)
    {
        Console::WriteLine(ex->Message);
    }
}
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();
        }
    }
}

Imports System.IO
Imports System.Text
Imports System.Security.AccessControl



Module FileStreamExample

    Sub Main()
        Try
            ' Create a file and write data to it.
            ' Create an array of bytes.
            Dim messageByte As Byte() = Encoding.ASCII.GetBytes("Here is some data.")

            ' Create a file using the FileStream class.
            Dim fWrite As New FileStream("test.txt", FileMode.Create, FileAccess.ReadWrite, FileShare.None, 8, FileOptions.None)

            ' Write the number of bytes to the file.
            fWrite.WriteByte(System.Convert.ToByte(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.
            Dim fRead As New FileStream("test.txt", FileMode.Open)

            ' The first byte is the string length.
            Dim length As Integer = Fix(fRead.ReadByte())

            ' Create a new byte array for the data.
            Dim readBytes(length) As Byte

            ' 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 e As Exception
            Console.WriteLine(e)
        End Try

        Console.ReadLine()

    End Sub
End Module

Remarques

Le .NET Framework ne prend pas en charge l’accès direct aux disques physiques par le biais de chemins d’accès qui sont des noms d’appareils, tels que « \ \ .\PHYSICALDRIVE0 ».The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".

Le fileOptions paramètre est utilisé pour fournir l’accès à des opérations plus avancées qui peuvent être exploitées lors de la création d’un FileStream objet.The fileOptions parameter is used to provide access to more advanced operations that can be leveraged when creating a FileStream object.

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Notes

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.path is not required to be a file stored on disk; it can be any part of a system that supports access through streams. Par exemple, selon le système, cette classe peut accéder à un appareil physique.For example, depending on the system, this class can access a physical device.

CanSeek est true pour tous les FileStream objets qui encapsulent des fichiers.CanSeek is true for all FileStream objects that encapsulate files. Si path indique un appareil qui ne prend pas en charge la recherche, la CanSeek propriété sur le résultant FileStream est false .If path indicates a device that does not support seeking, the CanSeek property on the resulting FileStream is false. Pour plus d'informations, consultez CanSeek.For additional information, see CanSeek.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(SafeFileHandle, FileAccess, Int32, Boolean)

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture, la taille de mémoire tampon et l'état synchrone ou asynchrone spécifiés.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, buffer size, and synchronous or asynchronous state.

public:
 FileStream(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::IO::FileAccess access, int bufferSize, bool isAsync);
public FileStream (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.IO.FileAccess access, int bufferSize, bool isAsync);
new System.IO.FileStream : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAccess * int * bool -> System.IO.FileStream
Public Sub New (handle As SafeFileHandle, access As FileAccess, bufferSize As Integer, isAsync As Boolean)

Paramètres

handle
SafeFileHandle

Handle de fichier pour le fichier que cet objet FileStream encapsulera.A file handle for the file that this FileStream object will encapsulate.

access
FileAccess

Combinaison d’opérations de bits des valeurs d’énumération qui définit les propriétés CanRead et CanWrite de l’objet FileStream.A bitwise combination of the enumeration values that sets the CanRead and CanWrite properties of the FileStream object.

bufferSize
Int32

Valeur Int32 positive supérieure à 0 indiquant la taille de la mémoire tampon.A positive Int32 value greater than 0 indicating the buffer size. La taille par défaut de la mémoire tampon est 4096.The default buffer size is 4096.

isAsync
Boolean

true si le handle a été ouvert de façon asynchrone (c'est-à-dire en mode E/S avec chevauchement) ; sinon, false.true if the handle was opened asynchronously (that is, in overlapped I/O mode); otherwise, false.

Exceptions

Le paramètre handle est un handle non valide.The handle parameter is an invalid handle.

- ou --or- Le paramètre handle est un handle synchrone et il a été utilisé de façon asynchrone.The handle parameter is a synchronous handle and it was used asynchronously.

Le paramètre bufferSize est négatif.The bufferSize parameter is negative.

Une erreur d’E/S, telle qu’une erreur de disque, s’est produite.An I/O error, such as a disk error, occurred.

- ou --or-

Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le access demandé n’est pas autorisé par le système d’exploitation pour le handle de fichier spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le handle de fichier est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access.

Remarques

Vous définissez le isAsync paramètre sur true pour ouvrir le descripteur de fichier de façon asynchrone.You set the isAsync parameter to true to open the file handle asynchronously. Lorsque le paramètre a la valeur true , le flux utilise des e/s avec chevauchement pour effectuer des opérations de fichier de façon asynchrone.When the parameter is true, the stream utilizes overlapped I/O to perform file operations asynchronously. Toutefois, il n’est pas nécessaire que le paramètre true appelle la ReadAsync WriteAsync méthode, ou CopyToAsync .However, the parameter does not have to be true to call the ReadAsync, WriteAsync, or CopyToAsync method. Lorsque le isAsync paramètre est false et que vous appelez les opérations de lecture et d’écriture asynchrones, le thread d’interface utilisateur n’est toujours pas bloqué, mais l’opération d’e/s réelle est exécutée de façon synchrone.When the isAsync parameter is false and you call the asynchronous read and write operations, the UI thread is still not blocked, but the actual I/O operation is performed synchronously.

FileStream suppose qu’il a un contrôle exclusif sur le handle.FileStream assumes that it has exclusive control over the handle. La lecture, l’écriture ou la recherche d’un FileStream est également un handle qui peut entraîner une altération des données.Reading, writing, or seeking while a FileStream is also holding a handle could result in data corruption. Pour la sécurité des données, appelez Flush avant d’utiliser le handle et évitez d’appeler des méthodes autres que Close lorsque vous avez fini d’utiliser le handle.For data safety, call Flush before using the handle, and avoid calling any methods other than Close after you are done using the handle. Vous pouvez également lire et écrire dans le handle avant d’appeler ce FileStream constructeur.Alternately, read and write to the handle before calling this FileStream constructor.

FileShare.Read est la valeur par défaut pour ces FileStream constructeurs sans FileShare paramètre.FileShare.Read is the default for those FileStream constructors without a FileShare parameter.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(String, FileMode, FileAccess)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès, le mode de création et les autorisations de lecture/écriture spécifiés.Initializes a new instance of the FileStream class with the specified path, creation mode, and read/write permission.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode, System::IO::FileAccess access);
public FileStream (string path, System.IO.FileMode mode, System.IO.FileAccess access);
new System.IO.FileStream : string * System.IO.FileMode * System.IO.FileAccess -> System.IO.FileStream
Public Sub New (path As String, mode As FileMode, access As FileAccess)

Paramètres

path
String

Chemin d'accès relatif ou absolu pour le fichier que l'objet FileStream actuel doit encapsuler.A relative or absolute path for the file that the current FileStream object will encapsulate.

mode
FileMode

Une des valeurs d’énumération déterminant le mode d’ouverture ou de création du fichier.One of the enumeration values that determines how to open or create the file.

access
FileAccess

Combinaison de bits des valeurs d’énumération qui détermine comment le fichier peut être accessible par l’objet FileStream.A bitwise combination of the enumeration values that determines how the file can be accessed by the FileStream object. Détermine aussi les valeurs retournées par les propriétés CanRead et CanWrite de l'objet FileStream.This also determines the values returned by the CanRead and CanWrite properties of the FileStream object. CanSeek a la valeur true si path spécifie un fichier sur disque.CanSeek is true if path specifies a disk file.

Exceptions

path a la valeur null.path is null.

path est une chaîne vide (""), contient seulement un espace blanc ou contient un ou plusieurs caractères non valides.path is an empty string (""), contains only white space, or contains one or more invalid characters.

- ou --or- path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in an NTFS environment.

path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement autre que NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in a non-NTFS environment.

Le fichier est introuvable, comme quand mode a pour valeur FileMode.Truncate ou FileMode.Open, et que le fichier spécifié par path n’existe pas.The file cannot be found, such as when mode is FileMode.Truncate or FileMode.Open, and the file specified by path does not exist. Le fichier doit déjà exister dans ces modes.The file must already exist in these modes.

Une erreur d’E/S s’est produite, par exemple la spécification de FileMode.CreateNew quand le fichier spécifié par path existe déjà.An I/O error, such as specifying FileMode.CreateNew when the file specified by path already exists, occurred.

- ou --or- Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le access demandé n’est pas autorisé par le système d’exploitation pour le path spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le fichier ou le répertoire est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified path, such as when access is Write or ReadWrite and the file or directory is set for read-only access.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

mode contient une valeur non valide.mode contains an invalid value.

Remarques

Le .NET Framework ne prend pas en charge l’accès direct aux disques physiques par le biais de chemins d’accès qui sont des noms d’appareils, tels que « \ \ .\PHYSICALDRIVE0 ».The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Le constructeur reçoit un accès en lecture/écriture au fichier, et il est ouvert en partageant l’accès en lecture (autrement dit, les demandes d’ouverture du fichier en écriture par ce processus ou un autre processus échouent tant que l' FileStream objet n’a pas été fermé, mais les tentatives de lecture réussissent).The constructor is given read/write access to the file, and it is opened sharing Read access (that is, requests to open the file for writing by this or another process will fail until the FileStream object has been closed, but read attempts will succeed). La taille de la mémoire tampon est définie sur la taille par défaut de 4096 octets (4 Ko).The buffer size is set to the default size of 4096 bytes (4 KB).

Notes

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.path is not required to be a file stored on disk; it can be any part of a system that supports access through streams. Par exemple, selon le système, cette classe peut accéder à un appareil physique.For example, depending on the system, this class can access a physical device.

CanSeek est true pour tous les FileStream objets qui encapsulent des fichiers.CanSeek is true for all FileStream objects that encapsulate files. Si path indique un appareil qui ne prend pas en charge la recherche, la CanSeek propriété sur le résultant FileStream est false .If path indicates a device that does not support seeking, the CanSeek property on the resulting FileStream is false. Pour plus d'informations, consultez CanSeek.For additional information, see CanSeek.

FileShare.Read est la valeur par défaut pour ces FileStream constructeurs sans FileShare paramètre.FileShare.Read is the default for those FileStream constructors without a FileShare parameter.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(IntPtr, FileAccess, Boolean)

Attention

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed. https://go.microsoft.com/fwlink/?linkid=14202

Attention

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed. http://go.microsoft.com/fwlink/?linkid=14202

Attention

Use FileStream(SafeFileHandle handle, FileAccess access) instead

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture et la propriété d'instance FileStream spécifiées.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission and FileStream instance ownership.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access, bool ownsHandle);
[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);
[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);
[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle);
[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream
[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream
[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool -> System.IO.FileStream
Public Sub New (handle As IntPtr, access As FileAccess, ownsHandle As Boolean)

Paramètres

handle
IntPtr

Handle de fichier pour le fichier que l'objet FileStream actuel doit encapsuler.A file handle for the file that the current FileStream object will encapsulate.

access
FileAccess

Combinaison d’opérations de bits des valeurs d’énumération qui définit les propriétés CanRead et CanWrite de l’objet FileStream.A bitwise combination of the enumeration values that sets the CanRead and CanWrite properties of the FileStream object.

ownsHandle
Boolean

true si le handle de fichier appartiendra à cette instance de FileStream ; sinon, false.true if the file handle will be owned by this FileStream instance; otherwise, false.

Attributs

Exceptions

access n’est pas un champ de FileAccess.access is not a field of FileAccess.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Une erreur d’E/S, telle qu’une erreur de disque, s’est produite.An I/O error, such as a disk error, occurred.

- ou --or-

Le flux a été fermé.The stream has been closed.

Le access demandé n’est pas autorisé par le système d’exploitation pour le handle de fichier spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le handle de fichier est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access.

Remarques

L' FileStream accès au fichier est attribué à l’objet.The FileStream object is given the specified access to the file. La propriété du descripteur sera la même que celle spécifiée.The ownership of the handle will be as specified. Si ce processus est propriétaire du handle, un appel à la Close méthode ferme également le handle et le nombre de handles du fichier est décrémenté.If this process owns the handle, a call to the Close method will also close the handle and the file's handle count is decremented. La FileStream taille de la mémoire tampon par défaut de 4096 octets est affectée à l’objet.The FileStream object is given the default buffer size of 4096 bytes.

FileStream suppose qu’il a un contrôle exclusif sur le handle.FileStream assumes that it has exclusive control over the handle. La lecture, l’écriture ou la recherche d’un FileStream est également un handle qui peut entraîner une altération des données.Reading, writing, or seeking while a FileStream is also holding a handle could result in data corruption. Pour la sécurité des données, appelez Flush avant d’utiliser le handle et évitez d’appeler des méthodes autres que Close lorsque vous avez fini d’utiliser le descripteur.For data safety, call Flush before using the handle, and avoid calling methods other than Close after you are done using the handle.

FileShare.Read est la valeur par défaut pour ces FileStream constructeurs sans FileShare paramètre.FileShare.Read is the default for those FileStream constructors without a FileShare parameter.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(SafeFileHandle, FileAccess, Int32)

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture et la taille de mémoire tampon spécifiées.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, and buffer size.

public:
 FileStream(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::IO::FileAccess access, int bufferSize);
public FileStream (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.IO.FileAccess access, int bufferSize);
new System.IO.FileStream : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAccess * int -> System.IO.FileStream
Public Sub New (handle As SafeFileHandle, access As FileAccess, bufferSize As Integer)

Paramètres

handle
SafeFileHandle

Handle de fichier pour le fichier que l'objet FileStream actuel doit encapsuler.A file handle for the file that the current FileStream object will encapsulate.

access
FileAccess

Constante FileAccess qui définit les propriétés CanRead et CanWrite de l'objet FileStream.A FileAccess constant that sets the CanRead and CanWrite properties of the FileStream object.

bufferSize
Int32

Valeur Int32 positive supérieure à 0 indiquant la taille de la mémoire tampon.A positive Int32 value greater than 0 indicating the buffer size. La taille par défaut de la mémoire tampon est 4096.The default buffer size is 4096.

Exceptions

Le paramètre handle est un handle non valide.The handle parameter is an invalid handle.

- ou --or- Le paramètre handle est un handle synchrone et il a été utilisé de façon asynchrone.The handle parameter is a synchronous handle and it was used asynchronously.

Le paramètre bufferSize est négatif.The bufferSize parameter is negative.

Une erreur d’E/S, telle qu’une erreur de disque, s’est produite.An I/O error, such as a disk error, occurred.

- ou --or-

Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le access demandé n’est pas autorisé par le système d’exploitation pour le handle de fichier spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le handle de fichier est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access.

Remarques

FileStream suppose qu’il a un contrôle exclusif sur le handle.FileStream assumes that it has exclusive control over the handle. La lecture, l’écriture ou la recherche d’un FileStream est également un handle qui peut entraîner une altération des données.Reading, writing, or seeking while a FileStream is also holding a handle could result in data corruption. Pour la sécurité des données, appelez Flush avant d’utiliser le handle et évitez d’appeler des méthodes autres que Close lorsque vous avez fini d’utiliser le handle.For data safety, call Flush before using the handle, and avoid calling any methods other than Close after you are done using the handle. Vous pouvez également lire et écrire dans le handle avant d’appeler ce FileStream constructeur.Alternately, read and write to the handle before calling this FileStream constructor.

FileShare.Read est la valeur par défaut pour ces FileStream constructeurs sans FileShare paramètre.FileShare.Read is the default for those FileStream constructors without a FileShare parameter.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(IntPtr, FileAccess, Boolean, Int32)

Attention

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed. https://go.microsoft.com/fwlink/?linkid=14202

Attention

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

Attention

Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture, la propriété de l'instance FileStream et la taille de mémoire tampon spécifiées.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission, FileStream instance ownership, and buffer size.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access, bool ownsHandle, int bufferSize);
[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);
[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);
[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access, bool ownsHandle, int bufferSize);
[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream
[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead, and optionally make a new SafeFileHandle with ownsHandle=false if needed.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream
[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access, int bufferSize) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess * bool * int -> System.IO.FileStream
Public Sub New (handle As IntPtr, access As FileAccess, ownsHandle As Boolean, bufferSize As Integer)

Paramètres

handle
IntPtr

Handle de fichier pour le fichier que cet objet FileStream encapsulera.A file handle for the file that this FileStream object will encapsulate.

access
FileAccess

Combinaison d’opérations de bits des valeurs d’énumération qui définit les propriétés CanRead et CanWrite de l’objet FileStream.A bitwise combination of the enumeration values that sets the CanRead and CanWrite properties of the FileStream object.

ownsHandle
Boolean

true si le handle de fichier appartiendra à cette instance de FileStream ; sinon, false.true if the file handle will be owned by this FileStream instance; otherwise, false.

bufferSize
Int32

Valeur Int32 positive supérieure à 0 indiquant la taille de la mémoire tampon.A positive Int32 value greater than 0 indicating the buffer size. La taille par défaut de la mémoire tampon est 4096.The default buffer size is 4096.

Attributs

Exceptions

bufferSize est un nombre négatif.bufferSize is negative.

Une erreur d’E/S, telle qu’une erreur de disque, s’est produite.An I/O error, such as a disk error, occurred.

- ou --or-

Le flux a été fermé.The stream has been closed.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le access demandé n’est pas autorisé par le système d’exploitation pour le handle de fichier spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le handle de fichier est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access.

Remarques

L' FileStream accès au fichier est attribué à l’objet.The FileStream object is given the specified access to the file. La propriété du descripteur sera la même que celle spécifiée.The ownership of the handle will be as specified. Si ce FileStream est le propriétaire du handle, un appel à la Close méthode ferme également le handle.If this FileStream owns the handle, a call to the Close method will also close the handle. En particulier, le nombre de handles du fichier est décrémenté.In particular, the file's handle count is decremented. La FileStream taille de la mémoire tampon spécifiée est affectée à l’objet.The FileStream object is given the specified buffer size.

FileStream suppose qu’il a un contrôle exclusif sur le handle.FileStream assumes that it has exclusive control over the handle. La lecture, l’écriture ou la recherche d’un FileStream est également un handle qui peut entraîner une altération des données.Reading, writing, or seeking while a FileStream is also holding a handle could result in data corruption. Pour la sécurité des données, appelez Flush avant d’utiliser le handle et évitez d’appeler des méthodes autres que Close lorsque vous avez fini d’utiliser le handle.For data safety, call Flush before using the handle, and avoid calling any methods other than Close after you are done using the handle. Vous pouvez également lire et écrire dans le handle avant d’appeler ce FileStream constructeur.Alternately, read and write to the handle before calling this FileStream constructor.

FileShare.Read est la valeur par défaut pour ces FileStream constructeurs sans FileShare paramètre.FileShare.Read is the default for those FileStream constructors without a FileShare parameter.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à

FileStream(String, FileMode)

Initialise une nouvelle instance de la classe FileStream avec le chemin d'accès et le mode de création spécifiés.Initializes a new instance of the FileStream class with the specified path and creation mode.

public:
 FileStream(System::String ^ path, System::IO::FileMode mode);
public FileStream (string path, System.IO.FileMode mode);
new System.IO.FileStream : string * System.IO.FileMode -> System.IO.FileStream
Public Sub New (path As String, mode As FileMode)

Paramètres

path
String

Chemin d'accès relatif ou absolu pour le fichier que l'objet FileStream actuel doit encapsuler.A relative or absolute path for the file that the current FileStream object will encapsulate.

mode
FileMode

Une des valeurs d’énumération déterminant le mode d’ouverture ou de création du fichier.One of the enumeration values that determines how to open or create the file.

Exceptions

path est une chaîne vide (""), contient seulement un espace blanc ou contient un ou plusieurs caractères non valides.path is an empty string (""), contains only white space, or contains one or more invalid characters.

- ou --or- path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in an NTFS environment.

path fait référence à un périphérique qui ne prend pas en charge les fichiers, tel que « con: », « com1: », « lpt1: », etc., dans un environnement autre que NTFS.path refers to a non-file device, such as "con:", "com1:", "lpt1:", etc. in a non-NTFS environment.

path a la valeur null.path is null.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Le fichier est introuvable, comme quand mode a pour valeur FileMode.Truncate ou FileMode.Open, et que le fichier spécifié par path n’existe pas.The file cannot be found, such as when mode is FileMode.Truncate or FileMode.Open, and the file specified by path does not exist. Le fichier doit déjà exister dans ces modes.The file must already exist in these modes.

path spécifie un fichier qui est en lecture seule.path specifies a file that is read-only.

Une erreur d’E/S s’est produite, par exemple la spécification de FileMode.CreateNew quand le fichier spécifié par path existe déjà.An I/O error, such as specifying FileMode.CreateNew when the file specified by path already exists, occurred.

- ou --or- Le flux a été fermé.The stream has been closed.

Le chemin spécifié n’est pas valide, par exemple si l’emplacement est un lecteur non mappé.The specified path is invalid, such as being on an unmapped drive.

Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.The specified path, file name, or both exceed the system-defined maximum length.

mode contient une valeur non valide.mode contains an invalid value.

Exemples

L’exemple de code suivant montre comment écrire des données dans un fichier, octet par octet, puis vérifier que les données ont été correctement écrites.The following code example shows how to write data to a file, byte by byte, and then verify that the data was written correctly.

using namespace System;
using namespace System::IO;
int main()
{
   String^ fileName =  "Test@##@.dat";
   
   // Create random data to write to the file.
   array<Byte>^dataArray = gcnew array<Byte>(100000);
   (gcnew Random)->NextBytes( dataArray );
   FileStream^ fileStream = gcnew FileStream( fileName,FileMode::Create );
   try
   {
      
      // Write the data to the file, byte by byte.
      for ( int i = 0; i < dataArray->Length; i++ )
      {
         fileStream->WriteByte( dataArray[ i ] );

      }
      
      // Set the stream position to the beginning of the file.
      fileStream->Seek( 0, SeekOrigin::Begin );
      
      // Read and verify the data.
      for ( int i = 0; i < fileStream->Length; i++ )
      {
         if ( dataArray[ i ] != fileStream->ReadByte() )
         {
            Console::WriteLine( "Error writing data." );
            return  -1;
         }

      }
      Console::WriteLine( "The data was written to {0} "
      "and verified.", fileStream->Name );
   }
   finally
   {
      fileStream->Close();
   }

}

using System;
using System.IO;

class FStream
{
    static void Main()
    {
        const string fileName = "Test#@@#.dat";

        // Create random data to write to the file.
        byte[] dataArray = new byte[100000];
        new Random().NextBytes(dataArray);

        using(FileStream
            fileStream = new FileStream(fileName, FileMode.Create))
        {
            // Write the data to the file, byte by byte.
            for(int i = 0; i < dataArray.Length; i++)
            {
                fileStream.WriteByte(dataArray[i]);
            }

            // Set the stream position to the beginning of the file.
            fileStream.Seek(0, SeekOrigin.Begin);

            // Read and verify the data.
            for(int i = 0; i < fileStream.Length; i++)
            {
                if(dataArray[i] != fileStream.ReadByte())
                {
                    Console.WriteLine("Error writing data.");
                    return;
                }
            }
            Console.WriteLine("The data was written to {0} " +
                "and verified.", fileStream.Name);
        }
    }
}
Imports System.IO
Imports System.Text

Class FStream

    Shared Sub Main()

        Const fileName As String = "Test#@@#.dat"

        ' Create random data to write to the file.
        Dim dataArray(100000) As Byte
        Dim randomGenerator As New Random()
        randomGenerator.NextBytes(dataArray)

        Dim fileStream As FileStream = _
            new FileStream(fileName, FileMode.Create)
        Try

            ' Write the data to the file, byte by byte.
            For i As Integer = 0 To dataArray.Length - 1
                fileStream.WriteByte(dataArray(i))
            Next i

            ' Set the stream position to the beginning of the stream.
            fileStream.Seek(0, SeekOrigin.Begin)

            ' Read and verify the data.
            For i As Integer = 0 To _
                CType(fileStream.Length, Integer) - 1

                If dataArray(i) <> fileStream.ReadByte() Then
                    Console.WriteLine("Error writing data.")
                    Return
                End If
            Next i
            Console.WriteLine("The data was written to {0} " & _
                "and verified.", fileStream.Name)
        Finally
            fileStream.Close()
        End Try
    
    End Sub
End Class

Remarques

Le .NET Framework ne prend pas en charge l’accès direct aux disques physiques par le biais de chemins d’accès qui sont des noms d’appareils, tels que « \ \ .\PHYSICALDRIVE0 ».The .NET Framework does not support direct access to physical disks through paths that are device names, such as "\\.\PHYSICALDRIVE0 ".

Le path paramètre peut être un nom de fichier, y compris un fichier sur un partage UNC (Universal Naming Convention).The path parameter can be a file name, including a file on a Universal Naming Convention (UNC) share.

Le constructeur reçoit un accès en lecture/écriture au fichier, et il est ouvert en partageant l’accès en lecture (autrement dit, les demandes d’ouverture du fichier en écriture par ce processus ou un autre processus échouent tant que l' FileStream objet n’a pas été fermé, mais les tentatives de lecture réussissent).The constructor is given read/write access to the file, and it is opened sharing Read access (that is, requests to open the file for writing by this or another process will fail until the FileStream object has been closed, but read attempts will succeed).

Vous ne pouvez pas utiliser ce constructeur pour ouvrir des fichiers en lecture seule ; au lieu de cela, vous devez utiliser un constructeur qui accepte un FileAccess paramètre dont la valeur est égale à FileAccess.Read .You cannot use this constructor to open read-only files; instead, you must use a constructor that accepts a FileAccess parameter with the value set to FileAccess.Read.

La taille de la mémoire tampon est définie sur la taille par défaut de 4096 octets (4 Ko).The buffer size is set to the default size of 4096 bytes (4 KB).

Notes

path ne doit pas nécessairement être un fichier stocké sur le disque ; Il peut s’agir de n’importe quelle partie d’un système qui prend en charge l’accès via des flux.path is not required to be a file stored on disk; it can be any part of a system that supports access through streams. Par exemple, selon le système, cette classe peut accéder à un appareil physique.For example, depending on the system, this class can access a physical device.

CanSeek est true pour tous les FileStream objets qui encapsulent des fichiers.CanSeek is true for all FileStream objects that encapsulate files. Si path indique un appareil qui ne prend pas en charge la recherche, la CanSeek propriété sur le résultant FileStream est false .If path indicates a device that does not support seeking, the CanSeek property on the resulting FileStream is false. Pour plus d'informations, consultez CanSeek.For additional information, see CanSeek.

FileShare.Read est la valeur par défaut pour ces FileStream constructeurs sans FileShare paramètre.FileShare.Read is the default for those FileStream constructors without a FileShare parameter.

Pour les constructeurs sans FileAccess paramètre, si le mode paramètre a la valeur Append , Write est l’accès par défaut.For constructors without a FileAccess parameter, if the mode parameter is set to Append, Write is the default access. Dans le cas contraire, l’accès a la valeur ReadWrite .Otherwise, the access is set to ReadWrite.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

Voir aussi

S’applique à

FileStream(IntPtr, FileAccess)

Attention

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead. https://go.microsoft.com/fwlink/?linkid=14202

Attention

This constructor has been deprecated. Please use new FileStream(SafeFileHandle handle, FileAccess access) instead. http://go.microsoft.com/fwlink/?linkid=14202

Attention

Use FileStream(SafeFileHandle handle, FileAccess access) instead

Initialise une nouvelle instance de la classe FileStream pour le handle de fichier spécifié, avec l'autorisation d'accès en lecture/écriture spécifiée.Initializes a new instance of the FileStream class for the specified file handle, with the specified read/write permission.

public:
 FileStream(IntPtr handle, System::IO::FileAccess access);
[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  https://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access);
public FileStream (IntPtr handle, System.IO.FileAccess access);
[System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")]
public FileStream (IntPtr handle, System.IO.FileAccess access);
[System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")]
public FileStream (IntPtr handle, System.IO.FileAccess access);
[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  https://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream
[<System.Obsolete("This constructor has been deprecated.  Please use new FileStream(SafeFileHandle handle, FileAccess access) instead.  http://go.microsoft.com/fwlink/?linkid=14202")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream
[<System.Obsolete("Use FileStream(SafeFileHandle handle, FileAccess access) instead")>]
new System.IO.FileStream : nativeint * System.IO.FileAccess -> System.IO.FileStream
Public Sub New (handle As IntPtr, access As FileAccess)

Paramètres

handle
IntPtr

Handle de fichier pour le fichier que l'objet FileStream actuel doit encapsuler.A file handle for the file that the current FileStream object will encapsulate.

access
FileAccess

Combinaison d’opérations de bits des valeurs d’énumération qui définit les propriétés CanRead et CanWrite de l’objet FileStream.A bitwise combination of the enumeration values that sets the CanRead and CanWrite properties of the FileStream object.

Attributs

Exceptions

access n’est pas un champ de FileAccess.access is not a field of FileAccess.

L'appelant n'a pas l'autorisation requise.The caller does not have the required permission.

Une erreur d’E/S, telle qu’une erreur de disque, s’est produite.An I/O error, such as a disk error, occurred.

- ou --or-

Le flux a été fermé.The stream has been closed.

Le access demandé n’est pas autorisé par le système d’exploitation pour le handle de fichier spécifié, par exemple quand access a la valeur Write ou ReadWrite et que le handle de fichier est défini pour un accès en lecture seule.The access requested is not permitted by the operating system for the specified file handle, such as when access is Write or ReadWrite and the file handle is set for read-only access.

Remarques

Lorsque Close est appelé, le handle est également fermé et le nombre de handles du fichier est décrémenté.When Close is called, the handle is also closed and the file's handle count is decremented.

FileStream suppose qu’il a un contrôle exclusif sur le handle.FileStream assumes that it has exclusive control over the handle. La lecture, l’écriture ou la recherche d’un FileStream est également un handle qui peut entraîner une altération des données.Reading, writing, or seeking while a FileStream is also holding a handle could result in data corruption. Pour la sécurité des données, appelez Flush avant d’utiliser le handle et évitez d’appeler des méthodes autres que Close lorsque vous avez fini d’utiliser le handle.For data safety, call Flush before using the handle, and avoid calling any methods other than Close after you are done using the handle.

Attention

Quand vous compilez un jeu de caractères avec un paramètre culturel particulier et que vous récupérez ces mêmes caractères avec un autre paramètre culturel, les caractères peuvent ne pas être interprétés et peuvent provoquer la levée d’une exception.When you compile a set of characters with a particular cultural setting and retrieve those same characters with a different cultural setting, the characters might not be interpretable, and could cause an exception to be thrown.

FileShare.Read est la valeur par défaut pour ces FileStream constructeurs sans FileShare paramètre.FileShare.Read is the default for those FileStream constructors without a FileShare parameter.

Pour obtenir la liste des opérations courantes relatives aux fichiers et aux répertoires, consultez tâches d’e/s courantes.For a list of common file and directory operations, see Common I/O Tasks.

S’applique à