File.WriteAllText Méthode

public:
 static void WriteAllText(System::String ^ path, ReadOnlySpan<char> contents);

public static void WriteAllText (string path, ReadOnlySpan<char> contents);

static member WriteAllText : string * ReadOnlySpan<char> -> unit

Public Shared Sub WriteAllText (path As String, contents As ReadOnlySpan(Of Char))

Paramètres

Exceptions

Remarques

Cette méthode utilise l’encodage UTF-8 sans Byte-Order Mark (BOM), de sorte que l’utilisation de la méthode GetPreamble() retourne 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 méthode WriteAllText(String, ReadOnlySpan<Char>, Encoding).

Source:

File.cs

Source:

File.cs

Source:

File.cs

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

Exceptions

Exemples

L’exemple de code suivant illustre l’utilisation de la méthode WriteAllText pour écrire du texte dans un fichier. Dans cet exemple, un fichier est créé, s’il n’existe pas déjà, et le texte est ajouté à celui-ci.

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 Byte-Order Mark (BOM), de sorte que l’utilisation de la méthode GetPreamble retourne 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 l’encodage UTF8.

Étant donné une chaîne et un chemin d’accès de fichier, cette méthode ouvre le fichier spécifié, écrit la chaîne dans le fichier, puis ferme le fichier.

public:
 static void WriteAllText(System::String ^ path, ReadOnlySpan<char> contents, System::Text::Encoding ^ encoding);

public static void WriteAllText (string path, ReadOnlySpan<char> contents, System.Text.Encoding encoding);

static member WriteAllText : string * ReadOnlySpan<char> * System.Text.Encoding -> unit

Public Shared Sub WriteAllText (path As String, contents As ReadOnlySpan(Of Char), encoding As Encoding)

Paramètres

Exceptions

Source:

File.cs

Source:

File.cs

Source:

File.cs

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

Exceptions

Exemples

L’exemple de code suivant illustre l’utilisation de la méthode WriteAllText pour écrire du texte dans un fichier. Dans cet exemple, un fichier est créé, s’il n’existe pas déjà, et le texte est ajouté à celui-ci.

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

Étant donné une chaîne et un chemin d’accès de fichier, 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. Le handle de fichier est garanti être fermé par cette méthode, même si des exceptions sont levées.