File.ReadAllText Metod

Definition

Namnområde:: System.IO

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

Sammansättningar:: netstandard.dll, System.Runtime.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.

Öppnar en textfil, läser all text i filen i en sträng och stänger sedan filen.

Överlagringar

Name	Description
ReadAllText(String)	Öppnar en textfil, läser all text i filen och stänger sedan filen.
ReadAllText(String, Encoding)	Öppnar en fil, läser all text i filen med den angivna kodningen och stänger sedan filen.

ReadAllText(String)

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Öppnar en textfil, läser all text i filen och stänger sedan filen.

public:
 static System::String ^ ReadAllText(System::String ^ path);

public static string ReadAllText(string path);

static member ReadAllText : string -> string

Public Shared Function ReadAllText (path As String) As String

Parametrar

path: String

Filen som ska öppnas för läsning.

Returer

String

En sträng som innehåller all text 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 (den finns till exempel på en ommappad enhet).

IOException

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

UnauthorizedAccessException

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.

FileNotFoundException

Filen som angavs i path hittades inte.

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 ReadAllText för att visa innehållet i en fil. I det här exemplet skapas en fil, om den inte redan finns, och text läggs till i den.

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

Den här metoden öppnar en fil, läser all text i filen och returnerar den som en sträng. Sedan stängs filen.

Den här metoden försöker automatiskt identifiera kodningen av en fil baserat på förekomsten av byteordningsmärken. Den identifierar automatiskt UTF-8, little-endian UTF-16, big-endian UTF-16, little-endian UTF-32 och big-endian UTF-32 text om filen börjar med lämpliga byteordningsmarkeringar.

ReadAllText(String, Encoding) Använd metodens överlagring när du läser filer som kan innehålla importerad text, eftersom okända tecken kanske inte läss korrekt.

Filhandtaget kommer garanterat att stängas med den här metoden, även om undantag aktiveras.

Se även

Gäller för

ReadAllText(String, Encoding)

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Källa:: File.cs

Öppnar en fil, läser all text i filen med den angivna kodningen och stänger sedan filen.

public:
 static System::String ^ ReadAllText(System::String ^ path, System::Text::Encoding ^ encoding);

public static string ReadAllText(string path, System.Text.Encoding encoding);

static member ReadAllText : string * System.Text.Encoding -> string

Public Shared Function ReadAllText (path As String, encoding As Encoding) As String

Parametrar

path: String

Filen som ska öppnas för läsning.

encoding: Encoding

Kodningen som tillämpas på innehållet i filen.

Returer

String

En sträng som innehåller all text i filen.

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 (den finns till exempel på en ommappad enhet).

IOException

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

UnauthorizedAccessException

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.

FileNotFoundException

Filen som angavs i path hittades inte.

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 ReadAllText för att visa innehållet i en fil. I det här exemplet skapas en fil, om den inte redan finns, och text läggs till i den.

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

Den här metoden öppnar en fil, läser all text i filen och returnerar den som en sträng. Sedan stängs filen.

Filhandtaget kommer garanterat att stängas med den här metoden, även om undantag aktiveras.

Om du vill använda kodningsinställningarna som konfigurerats för operativsystemet anger du Encoding.Default egenskapen för parametern encoding .

Se även

Gäller för

Feedback

Var den här sidan till hjälp?