File.CreateText(String) 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
Källa:
File.cs
Källa:
File.cs
Källa:
File.cs
Källa:
File.cs
Källa:
File.cs

Skapar eller öppnar en fil för att skriva UTF-8-kodad text. Om filen redan finns ersätts dess innehåll.

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

Parametrar

path
String

Filen som ska öppnas för skrivning.

Returer

StreamWriter

En StreamWriter som skriver till den angivna filen med UTF-8-kodning.

Undantag

UnauthorizedAccessException

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

-eller-

path har angett en fil som är skrivskyddad.

-eller-

path har angett en fil som är dold.

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

NotSupportedException

path är i ett ogiltigt format.

Exempel

I följande exempel skapas en fil för textskrivning och läsning.

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

Kommentarer

Den här metoden motsvarar StreamWriter(String, Boolean) konstruktorns överlagring med parametern inställd på appendfalse. Om filen som anges av path inte finns skapas den. Om filen finns ersätts dess innehåll. Ytterligare trådar kan läsa filen medan den är öppen.

Parametern path tillåts ange relativ eller absolut sökvägsinformation. Relativ sökvägsinformation tolkas som relativ till den aktuella arbetskatalogen. Information om hur du hämtar den aktuella arbetskatalogen finns i GetCurrentDirectory.

En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.

Gäller för

Se även