File.CreateText(String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Tworzy lub otwiera plik do zapisywania zakodowanego tekstu UTF-8. Jeśli plik już istnieje, jego zawartość zostanie zastąpiona.
public:
static System::IO::StreamWriter ^ CreateText(System::String ^ path);public static System.IO.StreamWriter CreateText(string path);static member CreateText : string -> System.IO.StreamWriterPublic Shared Function CreateText (path As String) As StreamWriterParametry
- path
- String
Plik, który ma zostać otwarty do zapisu.
Zwraca
Element StreamWriter , który zapisuje w określonym pliku przy użyciu kodowania UTF-8.
Wyjątki
Obiekt wywołujący nie ma wymaganych uprawnień.
— lub —
path określony plik, który jest tylko do odczytu.
— lub —
path określony plik, który jest ukryty.
Wersje .NET Framework i .NET Core starsze niż 2.1: path to ciąg o zerowej długości, zawiera tylko biały znak lub zawiera jeden lub więcej nieprawidłowych znaków. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .
Parametr path ma wartość null.
Określona ścieżka, nazwa pliku lub obie metody przekraczają maksymalną długość zdefiniowaną przez system.
Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).
path jest w nieprawidłowym formacie.
Przykłady
Poniższy przykład tworzy plik do zapisywania i odczytywania tekstu.
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
Uwagi
Ta metoda jest równoważna przeciążeniu konstruktora StreamWriter(String, Boolean) z parametrem ustawionym append na false. Jeśli plik określony przez path program nie istnieje, zostanie utworzony. Jeśli plik istnieje, jego zawartość zostanie zastąpiona. Dodatkowe wątki mogą odczytywać plik, gdy jest otwarty.
Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względem bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
