File.CreateText(String) Metoda

Definice

Obor názvů:
System.IO
Sestavení:
mscorlib.dll, System.IO.FileSystem.dll
Sestavení:
netstandard.dll, System.Runtime.dll
Sestavení:
netstandard.dll, System.IO.FileSystem.dll
Sestavení:
netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll
Sestavení:
System.IO.FileSystem.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
File.cs
Zdroj:
File.cs
Zdroj:
File.cs
Zdroj:
File.cs
Zdroj:
File.cs

Vytvoří nebo otevře soubor pro zápis zakódovaného textu UTF-8. Pokud soubor již existuje, jeho obsah se nahradí.

public:
 static System::IO::StreamWriter ^ CreateText(System::String ^ path);
public static System.IO.StreamWriter CreateText(string path);
static member CreateText : string -> System.IO.StreamWriter
Public Shared Function CreateText (path As String) As StreamWriter

Parametry

path
String

Soubor, který se má otevřít pro zápis.

Návraty

StreamWriter

A StreamWriter , který zapíše do zadaného souboru pomocí kódování UTF-8.

Výjimky

UnauthorizedAccessException

Volající nemá požadované oprávnění.

nebo

path zadal soubor, který je jen pro čtení.

nebo

path zadal soubor, který je skrytý.

ArgumentException

Verze .NET Framework a .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars() .

ArgumentNullException

path je null.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

DirectoryNotFoundException

Zadaná cesta je neplatná (například je na nemapované jednotce).

NotSupportedException

path je v neplatném formátu.

Příklady

Následující příklad vytvoří soubor pro zápis a čtení textu.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }	
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"

if File.Exists path |> not then
    // Create a file to write to.
    use sw = File.CreateText path
    sw.WriteLine "Hello"
    sw.WriteLine "Welcome"

// Open the file to read from.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    If Not File.Exists(path) Then
      ' Create a file to write to. 
      Using sw As StreamWriter = File.CreateText(path)
        sw.WriteLine("Hello")
        sw.WriteLine("And")
        sw.WriteLine("Welcome")
      End Using
    End If

    ' Open the file to read from. 
    Using sr As StreamReader = File.OpenText(path)
      Do While sr.Peek() >= 0
        Console.WriteLine(sr.ReadLine())
      Loop
    End Using

  End Sub
End Class

Poznámky

Tato metoda je ekvivalentní StreamWriter(String, Boolean) konstruktor přetížení s append parametrem nastaveným na false. Pokud soubor zadaný path pomocí neexistuje, vytvoří se. Pokud soubor existuje, jeho obsah se nahradí. Další vlákna jsou povolena ke čtení souboru, když je otevřená.

Parametr path má povoleno zadat relativní nebo absolutní informace o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři. Aktuální pracovní adresář získáte v tématu GetCurrentDirectory.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Platí pro

Viz také