File.CreateText(String) Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Sumber:

File.cs

Membuat atau membuka file untuk menulis teks yang dikodekan UTF-8. Jika file sudah ada, isinya akan diganti.

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

Parameter

path

String

File yang akan dibuka untuk ditulis.

Mengembalikan

StreamWriter

StreamWriter yang menulis ke file yang ditentukan menggunakan pengodean UTF-8.

Pengecualian

UnauthorizedAccessException

Pemanggil tidak memiliki izin yang diperlukan.

-atau-

path menentukan file yang bersifat baca-saja.

-atau-

path menentukan file yang disembunyikan.

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars()

ArgumentNullException

pathadalah null.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid (misalnya, ada di drive yang tidak dipetakan).

NotSupportedException

path dalam format yang tidak valid.

Contoh

Contoh berikut membuat file untuk penulisan dan pembacaan teks.

using namespace System;
using namespace System::IO;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   if ( !File::Exists( path ) )
   {
      
      // Create a file to write to.
      StreamWriter^ sw = File::CreateText( path );
      try
      {
         sw->WriteLine( "Hello" );
         sw->WriteLine( "And" );
         sw->WriteLine( "Welcome" );
      }
      finally
      {
         if ( sw )
                  delete (IDisposable^)sw;
      }
   }
   
   // Open the file to read from.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)sr;
   }
}

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

Keterangan

Metode ini setara dengan StreamWriter(String, Boolean) kelebihan beban konstruktor dengan parameter yang append diatur ke false. Jika file yang ditentukan oleh path tidak ada, file akan dibuat. Jika file memang ada, isinya akan diganti. Utas tambahan diizinkan untuk membaca file saat dibuka.

Parameter path diizinkan untuk menentukan informasi jalur relatif atau absolut. Informasi jalur relatif ditafsirkan relatif terhadap direktori kerja saat ini. Untuk mendapatkan direktori kerja saat ini, lihat GetCurrentDirectory.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• I/O File dan Aliran
• Membaca teks dari file
• Cara: Menulis Teks ke File
• Cara: Membaca dan Menulis ke File Data yang Baru Dibuat