File.WriteAllText Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Crée un nouveau fichier, écrit le contenu dans le fichier, puis ferme le fichier. Si le fichier cible existe déjà, il est tronqué et remplacé.
Surcharges
WriteAllText(String, String) |
Crée un nouveau fichier, écrit la chaîne spécifiée dans le fichier, puis ferme le fichier. Si le fichier cible existe déjà, il est tronqué et remplacé. |
WriteAllText(String, String, Encoding) |
Crée un nouveau fichier, écrit la chaîne spécifiée dans le fichier en utilisant l'encodage spécifié, puis ferme le fichier. Si le fichier cible existe déjà, il est tronqué et remplacé. |
WriteAllText(String, String)
- Source:
- File.cs
- Source:
- File.cs
- Source:
- File.cs
Crée un nouveau fichier, écrit la chaîne spécifiée dans le fichier, puis ferme le fichier. Si le fichier cible existe déjà, il est tronqué et remplacé.
public:
static void WriteAllText(System::String ^ path, System::String ^ contents);
public static void WriteAllText (string path, string contents);
public static void WriteAllText (string path, string? contents);
static member WriteAllText : string * string -> unit
Public Shared Sub WriteAllText (path As String, contents As String)
Paramètres
- path
- String
Fichier dans lequel écrire.
- contents
- String
Chaîne à écrire dans le fichier.
Exceptions
.NET Framework et .NET Core versions antérieures à 2.1 : path
est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().
path
a la valeur null
.
Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.
Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
path
a spécifié un fichier en lecture seule.
- ou -
path
a spécifié un fichier qui est masqué.
- ou -
Cette opération n'est pas prise en charge sur la plateforme actuelle.
- ou -
path
a spécifié un répertoire.
- ou -
L'appelant n'a pas l'autorisation requise.
path
est dans un format non valide.
L'appelant n'a pas l'autorisation requise.
Exemples
L’exemple de code suivant illustre l’utilisation de la WriteAllText méthode pour écrire du texte dans un fichier. Dans cet exemple, un fichier est créé, s’il n’existe pas déjà, et du texte y est ajouté.
using System;
using System.IO;
using System.Text;
class Test
{
public static void Main()
{
string path = @"c:\temp\MyTest.txt";
// This text is added only once to the file.
if (!File.Exists(path))
{
// Create a file to write to.
string createText = "Hello and Welcome" + Environment.NewLine;
File.WriteAllText(path, createText);
}
// This text is always added, making the file longer over time
// if it is not deleted.
string appendText = "This is extra text" + Environment.NewLine;
File.AppendAllText(path, appendText);
// Open the file to read from.
string readText = File.ReadAllText(path);
Console.WriteLine(readText);
}
}
open System
open System.IO
let path = @"c:\temp\MyTest.txt"
// This text is added only once to the file.
if File.Exists path |> not then
// Create a file to write to.
let createText =
"Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText)
// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
"This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText)
// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{readText}"
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
' This text is added only once to the file.
If File.Exists(path) = False Then
' Create a file to write to.
Dim createText As String = "Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText)
End If
' This text is always added, making the file longer over time
' if it is not deleted.
Dim appendText As String = "This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText)
' Open the file to read from.
Dim readText As String = File.ReadAllText(path)
Console.WriteLine(readText)
End Sub
End Class
Remarques
Cette méthode utilise l’encodage UTF-8 sans marque Byte-Order (BOM). L’utilisation de la GetPreamble méthode renvoie donc un tableau d’octets vide. S’il est nécessaire d’inclure un identificateur UTF-8, tel qu’une marque d’ordre d’octet, au début d’un fichier, utilisez la surcharge de méthode WriteAllText(String, String, Encoding) avec UTF8 encodage.
Avec une chaîne et un chemin d’accès au fichier, cette méthode ouvre le fichier spécifié, écrit la chaîne dans le fichier, puis ferme le fichier.
S’applique à
WriteAllText(String, String, Encoding)
- Source:
- File.cs
- Source:
- File.cs
- Source:
- File.cs
Crée un nouveau fichier, écrit la chaîne spécifiée dans le fichier en utilisant l'encodage spécifié, puis ferme le fichier. Si le fichier cible existe déjà, il est tronqué et remplacé.
public:
static void WriteAllText(System::String ^ path, System::String ^ contents, System::Text::Encoding ^ encoding);
public static void WriteAllText (string path, string contents, System.Text.Encoding encoding);
public static void WriteAllText (string path, string? contents, System.Text.Encoding encoding);
static member WriteAllText : string * string * System.Text.Encoding -> unit
Public Shared Sub WriteAllText (path As String, contents As String, encoding As Encoding)
Paramètres
- path
- String
Fichier dans lequel écrire.
- contents
- String
Chaîne à écrire dans le fichier.
- encoding
- Encoding
Encodage à appliquer à la chaîne.
Exceptions
.NET Framework et .NET Core versions antérieures à 2.1 : path
est une chaîne de longueur nulle, contient uniquement des espaces blancs ou contient un ou plusieurs caractères non valides. Vous pouvez rechercher les caractères non valides à l’aide de la méthode GetInvalidPathChars().
path
a la valeur null
.
Le chemin et/ou le nom de fichier spécifiés dépassent la longueur maximale définie par le système.
Le chemin spécifié n’est pas valide (par exemple, il est sur un lecteur non mappé).
Une erreur d’E/S s’est produite lors de l’ouverture du fichier.
path
a spécifié un fichier en lecture seule.
- ou -
path
a spécifié un fichier qui est masqué.
- ou -
Cette opération n'est pas prise en charge sur la plateforme actuelle.
- ou -
path
a spécifié un répertoire.
- ou -
L'appelant n'a pas l'autorisation requise.
path
est dans un format non valide.
L'appelant n'a pas l'autorisation requise.
Exemples
L’exemple de code suivant illustre l’utilisation de la WriteAllText méthode pour écrire du texte dans un fichier. Dans cet exemple, un fichier est créé, s’il n’existe pas déjà, et du texte y est ajouté.
using System;
using System.IO;
using System.Text;
class Test
{
public static void Main()
{
string path = @"c:\temp\MyTest.txt";
// This text is added only once to the file.
if (!File.Exists(path))
{
// Create a file to write to.
string createText = "Hello and Welcome" + Environment.NewLine;
File.WriteAllText(path, createText, Encoding.UTF8);
}
// This text is always added, making the file longer over time
// if it is not deleted.
string appendText = "This is extra text" + Environment.NewLine;
File.AppendAllText(path, appendText, Encoding.UTF8);
// Open the file to read from.
string readText = File.ReadAllText(path);
Console.WriteLine(readText);
}
}
open System
open System.IO
open System.Text
let path = @"c:\temp\MyTest.txt"
// This text is added only once to the file.
if File.Exists path |> not then
// Create a file to write to.
let createText =
"Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText, Encoding.UTF8)
// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
"This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText, Encoding.UTF8)
// Open the file to read from.
let readText = File.ReadAllText path
printfn $"{readText}"
Imports System.IO
Imports System.Text
Public Class Test
Public Shared Sub Main()
Dim path As String = "c:\temp\MyTest.txt"
Dim sw As StreamWriter
' This text is added only once to the file.
If File.Exists(path) = False Then
' Create a file to write to.
Dim createText As String = "Hello and Welcome" + Environment.NewLine
File.WriteAllText(path, createText, Encoding.UTF8)
End If
' This text is always added, making the file longer over time
' if it is not deleted.
Dim appendText As String = "This is extra text" + Environment.NewLine
File.AppendAllText(path, appendText, Encoding.UTF8)
' Open the file to read from.
Dim readText As String = File.ReadAllText(path)
Console.WriteLine(readText)
End Sub
End Class
Remarques
Avec une chaîne et un chemin d’accès, cette méthode ouvre le fichier spécifié, écrit la chaîne dans le fichier à l’aide de l’encodage spécifié, puis ferme le fichier. Cette méthode garantit la fermeture du handle de fichier, même si des exceptions sont levées.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour