Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
StreamReader, constructeur (String, Boolean)
Initialise une nouvelle instance de la classe StreamReader pour le nom de fichier spécifié, avec l'option de détection de la marque d'ordre d'octet.
Assembly : mscorlib (dans mscorlib.dll)
Paramètres
- path
- Type : System.String
Chemin d'accès complet au fichier à lire.
- detectEncodingFromByteOrderMarks
- Type : System.Boolean
Indique s'il faut rechercher les marques d'ordre d'octet au début du fichier.
| Exception | Condition |
|---|---|
| ArgumentException |
path est une chaîne vide (""). |
| ArgumentNullException |
path est null. |
| FileNotFoundException |
Le fichier est introuvable. |
| DirectoryNotFoundException |
Le chemin d'accès spécifié n'est pas valide, il se trouve par exemple sur un lecteur non mappé. |
| IOException |
path comprend une syntaxe incorrecte ou non valide pour les noms de fichiers, les noms de répertoires ou les noms de volumes. |
Ce constructeur rétablit la taille par défaut pour l'encodage en UTF8Encoding, la propriété BaseStream utilisant le paramètre stream et affecte à la mémoire tampon interne 1 024 octets.
Le paramètre path peut être un nom de fichier, notamment un fichier sur un partage de convention d'affectation de noms (UNC).
Le paramètre path n'est pas nécessairement un fichier enregistré sur disque, mais peut également être n'importe quelle partie d'un système qui prend en charge l'accès via des flux.
Le paramètre detectEncodingFromByteOrderMarks détecte l'encodage en examinant les trois premiers octets du flux. Il reconnaît automatiquement UTF-8, le texte Unicode little-endian et big-endian si le fichier démarre avec les marques d'ordre d'octet appropriées. Sinon, le UTF8Encoding est utilisé. Pour plus d'informations, consultez la méthode Encoding.GetPreamble.
Pour obtenir la liste des tâches d'E/S courantes, consultez Tâches d'E/S courantes.
L'exemple de code suivant illustre ce constructeur StreamReader.
private void getNewStreamReader() { //Get a new StreamReader in ASCII format from a //file using a buffer and byte order mark detection StreamReader srAsciiFromFileFalse512 = new StreamReader("C:\\Temp\\Test.txt", System.Text.Encoding.ASCII, false, 512); //Get a new StreamReader in ASCII format from a //file with byte order mark detection = false StreamReader srAsciiFromFileFalse = new StreamReader("C:\\Temp\\Test.txt", System.Text.Encoding.ASCII, false); //Get a new StreamReader in ASCII format from a file StreamReader srAsciiFromFile = new StreamReader("C:\\Temp\\Test.txt", System.Text.Encoding.ASCII); //Get a new StreamReader from a //file with byte order mark detection = false StreamReader srFromFileFalse = new StreamReader("C:\\Temp\\Test.txt", false); //Get a new StreamReader from a file StreamReader srFromFile = new StreamReader("C:\\Temp\\Test.txt"); //Get a new StreamReader in ASCII format from a //FileStream with byte order mark detection = false and a buffer StreamReader srAsciiFromStreamFalse512 = new StreamReader( (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"), System.Text.Encoding.ASCII, false, 512); //Get a new StreamReader in ASCII format from a //FileStream with byte order mark detection = false StreamReader srAsciiFromStreamFalse = new StreamReader( (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"), System.Text.Encoding.ASCII, false); //Get a new StreamReader in ASCII format from a FileStream StreamReader srAsciiFromStream = new StreamReader( (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"), System.Text.Encoding.ASCII); //Get a new StreamReader from a //FileStream with byte order mark detection = false StreamReader srFromStreamFalse = new StreamReader( (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"), false); //Get a new StreamReader from a FileStream StreamReader srFromStream = new StreamReader( (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt")); }
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
