File.AppendAllText Metod

Definition

Namnområde:: System.IO

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättningar:: mscorlib.dll, System.IO.FileSystem.dll

Sammansättningar:: netstandard.dll, System.IO.FileSystem.dll

Sammansättningar:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

Sammansättning:: System.IO.FileSystem.dll

Sammansättning:: mscorlib.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Lägger till den angivna strängen i filen och skapar filen om den inte redan finns.

Överlagringar

Name	Description
AppendAllText(String, ReadOnlySpan<Char>)	Lägger till den angivna strängen i filen och skapar filen om den inte redan finns.
AppendAllText(String, String)	Öppnar en fil, lägger till den angivna strängen i filen och stänger sedan filen. Om filen inte finns skapar den här metoden en fil, skriver den angivna strängen till filen och stänger sedan filen.
AppendAllText(String, ReadOnlySpan<Char>, Encoding)	Lägger till den angivna strängen i filen och skapar filen om den inte redan finns.
AppendAllText(String, String, Encoding)	Lägger till den angivna strängen i filen med den angivna kodningen och skapar filen om den inte redan finns.

AppendAllText(String, ReadOnlySpan<Char>)

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Lägger till den angivna strängen i filen och skapar filen om den inte redan finns.

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

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

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

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

Parametrar

path: String

Filen som ska läggas till i.

contents: ReadOnlySpan<Char>

De tecken som ska skrivas till filen.

Undantag

ArgumentNullException

path är null.

ArgumentException

path är tom.

PathTooLongException

Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).

IOException

Ett I/O-fel uppstod när filen öppnades.

UnauthorizedAccessException

path har angett en fil som är skrivskyddad.

-eller-

path har angett en fil som är dold.

-eller-

path har angett en katalog.

-eller-

Anroparen har inte den behörighet som krävs.

-eller-

Den här åtgärden stöds inte på den aktuella plattformen.

NotSupportedException

path är i ett ogiltigt format.

Kommentarer

Med en sträng och en filsökväg öppnar den här metoden den angivna filen, lägger till strängen i slutet av filen med den angivna kodningen.

och stänger sedan filen. Filhandtaget kommer garanterat att stängas med den här metoden, även om undantag aktiveras. Metoden skapar filen

om den inte finns, men den inte skapar nya kataloger. Därför måste värdet för sökvägsparametern innehålla befintliga kataloger.

Gäller för

AppendAllText(String, String)

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Öppnar en fil, lägger till den angivna strängen i filen och stänger sedan filen. Om filen inte finns skapar den här metoden en fil, skriver den angivna strängen till filen och stänger sedan filen.

public:
 static void AppendAllText(System::String ^ path, System::String ^ contents);

public static void AppendAllText(string path, string contents);

public static void AppendAllText(string path, string? contents);

static member AppendAllText : string * string -> unit

Public Shared Sub AppendAllText (path As String, contents As String)

Parametrar

path: String

Filen som den angivna strängen ska läggas till i.

contents: String

Strängen som ska läggas till i filen.

Undantag

ArgumentException

.NET Framework- och .NET Core-versioner som är äldre än 2.1: path är en sträng med noll längd, innehåller endast tomt utrymme eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp GetInvalidPathChars() av metoden .

ArgumentNullException

path är null.

PathTooLongException

Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig (till exempel finns inte katalogen eller finns på en ommappad enhet).

IOException

Ett I/O-fel uppstod när filen öppnades.

UnauthorizedAccessException

path har angett en fil som är skrivskyddad.

-eller-

Den här åtgärden stöds inte på den aktuella plattformen.

-eller-

path har angett en katalog.

-eller-

Anroparen har inte den behörighet som krävs.

NotSupportedException

path är i ett ogiltigt format.

SecurityException

Anroparen har inte den behörighet som krävs.

Exempel

Följande kodexempel visar hur metoden används AppendAllText för att lägga till extra text i slutet av en fil. I det här exemplet skapas en fil om den inte redan finns och text läggs till i den. Katalogen med namnet temp på enhet C måste dock finnas för att exemplet ska kunna slutföras.

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

Kommentarer

Med en sträng och en filsökväg öppnar den här metoden den angivna filen, lägger till strängen i slutet av filen och stänger sedan filen. Filhandtaget kommer garanterat att stängas med den här metoden, även om undantag aktiveras.

Metoden skapar filen om den inte finns, men den skapar inte nya kataloger. Därför måste värdet för parametern path innehålla befintliga kataloger.

Gäller för

AppendAllText(String, ReadOnlySpan<Char>, Encoding)

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Lägger till den angivna strängen i filen och skapar filen om den inte redan finns.

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

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

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

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

Parametrar

path: String

Filen som ska läggas till i.

contents: ReadOnlySpan<Char>

De tecken som ska skrivas till filen.

encoding: Encoding

Kodningen som ska tillämpas på strängen.

Undantag

ArgumentNullException

path eller encoding är null.

ArgumentException

path är tom.

PathTooLongException

Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig (den finns till exempel på en ommappad enhet).

IOException

Ett I/O-fel uppstod när filen öppnades.

UnauthorizedAccessException

path har angett en fil som är skrivskyddad.

-eller-

path har angett en fil som är dold.

-eller-

path har angett en katalog.

-eller-

Anroparen har inte den behörighet som krävs.

-eller-

Den här åtgärden stöds inte på den aktuella plattformen.

NotSupportedException

path är i ett ogiltigt format.

Kommentarer

Med en sträng och en filsökväg öppnar den här metoden den angivna filen, lägger till strängen i slutet av filen med den angivna kodningen.

och stänger sedan filen. Filhandtaget kommer garanterat att stängas med den här metoden, även om undantag aktiveras. Metoden skapar filen

om den inte finns, men den inte skapar nya kataloger. Därför måste värdet för sökvägsparametern innehålla befintliga kataloger.

Gäller för

AppendAllText(String, String, Encoding)

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Lägger till den angivna strängen i filen med den angivna kodningen och skapar filen om den inte redan finns.

public:
 static void AppendAllText(System::String ^ path, System::String ^ contents, System::Text::Encoding ^ encoding);

public static void AppendAllText(string path, string contents, System.Text.Encoding encoding);

public static void AppendAllText(string path, string? contents, System.Text.Encoding encoding);

static member AppendAllText : string * string * System.Text.Encoding -> unit

Public Shared Sub AppendAllText (path As String, contents As String, encoding As Encoding)

Parametrar

path: String

Filen som den angivna strängen ska läggas till i.

contents: String

Strängen som ska läggas till i filen.

encoding: Encoding

Teckenkodningen som ska användas.

Undantag

ArgumentException

ArgumentNullException

path är null.

PathTooLongException

Den angivna sökvägen, filnamnet eller båda överskrider den systemdefinierade maximala längden.

DirectoryNotFoundException

Den angivna sökvägen är ogiltig (till exempel finns inte katalogen eller finns på en ommappad enhet).

IOException

Ett I/O-fel uppstod när filen öppnades.

UnauthorizedAccessException

path har angett en fil som är skrivskyddad.

-eller-

Den här åtgärden stöds inte på den aktuella plattformen.

-eller-

path har angett en katalog.

-eller-

Anroparen har inte den behörighet som krävs.

NotSupportedException

path är i ett ogiltigt format.

SecurityException

Anroparen har inte den behörighet som krävs.

Exempel

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

Kommentarer

Med en sträng och en filsökväg öppnar den här metoden den angivna filen, lägger till strängen i slutet av filen med den angivna kodningen och stänger sedan filen. Filhandtaget kommer garanterat att stängas med den här metoden, även om undantag aktiveras.

Metoden skapar filen om den inte finns, men den skapar inte nya kataloger. Därför måste värdet för parametern path innehålla befintliga kataloger.

Gäller för

Feedback

Var den här sidan till hjälp?