File.CreateText(String) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee maakt of opent u een bestand voor het schrijven van gecodeerde UTF-8-tekst. Als het bestand al bestaat, wordt de inhoud ervan vervangen.
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 StreamWriterParameters
- path
- String
Het bestand dat moet worden geopend voor schrijven.
Retouren
Een StreamWriter die naar het opgegeven bestand schrijft met behulp van UTF-8-codering.
Uitzonderingen
De beller heeft niet de vereiste machtiging.
– of –
path een bestand opgegeven dat het kenmerk Alleen-lezen heeft.
– of –
path een bestand opgegeven dat verborgen is.
.NET Framework en .NET Core-versies ouder dan 2.1: path is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met behulp van de GetInvalidPathChars() methode.
path is null.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
Het opgegeven pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
path heeft een ongeldige indeling.
Voorbeelden
In het volgende voorbeeld wordt een bestand gemaakt voor het schrijven en lezen van tekst.
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
Opmerkingen
Deze methode is gelijk aan de overbelasting van de StreamWriter(String, Boolean) constructor met de append parameter die is ingesteld op false. Als het bestand dat is opgegeven path niet bestaat, wordt het gemaakt. Als het bestand wel bestaat, wordt de inhoud ervan vervangen. Aanvullende threads mogen het bestand lezen terwijl het is geopend.
De path parameter mag relatieve of absolute padgegevens opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap. Als u de huidige werkmap wilt ophalen, raadpleegt GetCurrentDirectoryu .
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
