File.WriteAllText Methode

Definitie

Naamruimte:: System.IO

Assembly's:: netstandard.dll, System.Runtime.dll

Assembly's:: mscorlib.dll, System.IO.FileSystem.dll

Assembly's:: netstandard.dll, System.IO.FileSystem.dll

Assembly's:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

Assembly:: System.IO.FileSystem.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee maakt u een nieuw bestand, schrijft u de inhoud naar het bestand en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.

Overloads

Name	Description
WriteAllText(String, ReadOnlySpan<Char>)	Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
WriteAllText(String, String)	Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
WriteAllText(String, ReadOnlySpan<Char>, Encoding)	Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand met behulp van de opgegeven codering en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.
WriteAllText(String, String, Encoding)	Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand met behulp van de opgegeven codering en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.

WriteAllText(String, ReadOnlySpan<Char>)

Bron:: File.cs

Bron:: File.cs

Bron:: File.cs

Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand en sluit u het bestand.

Als het doelbestand al bestaat, wordt het afgekapt en overschreven.

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))

Parameters

path: String

Het bestand waar naar moet worden geschreven.

contents: ReadOnlySpan<Char>

De tekens die naar het bestand moeten worden geschreven.

Uitzonderingen

ArgumentNullException

path is null.

ArgumentException

path is leeg.

PathTooLongException

Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.

DirectoryNotFoundException

Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).

IOException

Er is een I/O-fout opgetreden tijdens het openen van het bestand.

UnauthorizedAccessException

path een bestand opgegeven dat het kenmerk Alleen-lezen heeft.

– of –

path een bestand opgegeven dat verborgen is.

– of –

path een map opgegeven.

– of –

Deze bewerking wordt niet ondersteund op het huidige platform.

De beller heeft niet de vereiste machtiging.

NotSupportedException

path heeft een ongeldige indeling.

Opmerkingen

Deze methode maakt gebruik van UTF-8-codering zonder een Byte-Order Mark (BOM), dus met behulp van de GetPreamble() methode wordt een lege bytematrix geretourneerd. Als het nodig is om een UTF-8-id, zoals een bytevolgordemarkering, aan het begin van een bestand op te nemen, gebruikt u de WriteAllText(String, ReadOnlySpan<Char>, Encoding) methode.

Van toepassing op

WriteAllText(String, String)

Bron:: File.cs

Bron:: File.cs

Bron:: File.cs

Bron:: File.cs

Bron:: File.cs

Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.

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)

Parameters

path: String

Het bestand waar naar moet worden geschreven.

contents: String

De tekenreeks die naar het bestand moet worden geschreven.

Uitzonderingen

ArgumentException

.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.

ArgumentNullException

path is null.

PathTooLongException

Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.

DirectoryNotFoundException

Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).

IOException

Er is een I/O-fout opgetreden tijdens het openen van het bestand.

UnauthorizedAccessException

path een bestand opgegeven dat het kenmerk Alleen-lezen heeft.

– of –

path een bestand opgegeven dat verborgen is.

– of –

Deze bewerking wordt niet ondersteund op het huidige platform.

– of –

path een map opgegeven.

– of –

De beller heeft niet de vereiste machtiging.

NotSupportedException

path heeft een ongeldige indeling.

SecurityException

De beller heeft niet de vereiste machtiging.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe de WriteAllText methode wordt gebruikt om tekst naar een bestand te schrijven. In dit voorbeeld wordt er een bestand gemaakt, als het nog niet bestaat en wordt er tekst aan toegevoegd.

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

Opmerkingen

Deze methode maakt gebruik van UTF-8-codering zonder een Byte-Order Mark (BOM), dus met behulp van de GetPreamble methode wordt een lege bytematrix geretourneerd. Als het nodig is om een UTF-8-id, zoals een bytevolgordemarkering, aan het begin van een bestand op te nemen, gebruikt u de WriteAllText(String, String, Encoding) methode overbelast met UTF8 codering.

Met een tekenreeks en een bestandspad opent deze methode het opgegeven bestand, schrijft de tekenreeks naar het bestand en sluit het bestand.

Van toepassing op

WriteAllText(String, ReadOnlySpan<Char>, Encoding)

Bron:: File.cs

Bron:: File.cs

Bron:: File.cs

Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand met behulp van de opgegeven codering en sluit u het bestand.

Als het doelbestand al bestaat, wordt het afgekapt en overschreven.

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)

Parameters

path: String

Het bestand waar naar moet worden geschreven.

contents: ReadOnlySpan<Char>

De tekens die naar het bestand moeten worden geschreven.

encoding: Encoding

De codering die moet worden toegepast op de tekenreeks.

Uitzonderingen

ArgumentNullException

path of encoding is null.

ArgumentException

path is leeg.

PathTooLongException

Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.

DirectoryNotFoundException

Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).

IOException

Er is een I/O-fout opgetreden tijdens het openen van het bestand.

UnauthorizedAccessException

path een bestand opgegeven dat het kenmerk Alleen-lezen heeft.

– of –

path een bestand opgegeven dat verborgen is.

– of –

path een map opgegeven.

– of –

De beller heeft niet de vereiste machtiging.

– of –

Deze bewerking wordt niet ondersteund op het huidige platform.

NotSupportedException

path heeft een ongeldige indeling.

Van toepassing op

WriteAllText(String, String, Encoding)

Bron:: File.cs

Bron:: File.cs

Bron:: File.cs

Bron:: File.cs

Bron:: File.cs

Hiermee maakt u een nieuw bestand, schrijft u de opgegeven tekenreeks naar het bestand met behulp van de opgegeven codering en sluit u het bestand. Als het doelbestand al bestaat, wordt het afgekapt en overschreven.

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)

Parameters

path: String

Het bestand waar naar moet worden geschreven.

contents: String

De tekenreeks die naar het bestand moet worden geschreven.

encoding: Encoding

De codering die moet worden toegepast op de tekenreeks.

Uitzonderingen

ArgumentException

ArgumentNullException

path is null.

PathTooLongException

Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.

DirectoryNotFoundException

Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).

IOException

Er is een I/O-fout opgetreden tijdens het openen van het bestand.

UnauthorizedAccessException

path een bestand opgegeven dat het kenmerk Alleen-lezen heeft.

– of –

path een bestand opgegeven dat verborgen is.

– of –

Deze bewerking wordt niet ondersteund op het huidige platform.

– of –

path een map opgegeven.

– of –

De beller heeft niet de vereiste machtiging.

NotSupportedException

path heeft een ongeldige indeling.

SecurityException

De beller heeft niet de vereiste machtiging.

Voorbeelden

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

Opmerkingen

Met een tekenreeks en een bestandspad opent deze methode het opgegeven bestand, schrijft de tekenreeks naar het bestand met behulp van de opgegeven codering en sluit het bestand. De bestandsingang wordt gegarandeerd door deze methode gesloten, zelfs als er uitzonderingen worden gegenereerd.

Van toepassing op

Feedback

Is deze pagina nuttig?