File.Create Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Membuat, atau memotong dan menimpa, file di jalur yang ditentukan.

Overload

Create(String)	Membuat, atau memotong dan menimpa, file di jalur yang ditentukan.
Create(String, Int32)	Membuat, atau memotong dan menimpa, file di jalur yang ditentukan, menentukan ukuran buffer.
Create(String, Int32, FileOptions)	Membuat atau menimpa file di jalur yang ditentukan, menentukan ukuran dan opsi buffer yang menjelaskan cara membuat atau menimpa file.

Create(String)

Sumber:

File.cs

Membuat, atau memotong dan menimpa, file di jalur yang ditentukan.

public:
 static System::IO::FileStream ^ Create(System::String ^ path);

public static System.IO.FileStream Create (string path);

static member Create : string -> System.IO.FileStream

Public Shared Function Create (path As String) As FileStream

Parameter

path

String

Jalur dan nama file yang akan dibuat.

Mengembalikan

FileStream

FileStream yang menyediakan akses baca/tulis ke file yang ditentukan dalam path.

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

IOException

Terjadi kesalahan I/O saat membuat file.

NotSupportedException

path dalam format yang tidak valid.

Contoh

Contoh berikut membuat file di jalur yang ditentukan, menulis beberapa informasi ke file, dan membaca dari file.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   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;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            // Create the file, or overwrite if the file exists.
            using (FileStream fs = File.Create(path))
            {
                byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                // Add some information to the file.
                fs.Write(info, 0, info.Length);
            }

            // Open the stream and read it back.
            using (StreamReader sr = File.OpenText(path))
            {
                string s = "";
                while ((s = sr.ReadLine()) != null)
                {
                    Console.WriteLine(s);
                }
            }
        }

        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

open System.IO
open System.Text

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

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create path

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
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"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Keterangan

Objek FileStream yang dibuat oleh metode ini memiliki nilai Nonedefault FileShare ; tidak ada proses atau kode lain yang dapat mengakses file yang dibuat sampai handel file asli ditutup.

Metode ini setara dengan Create(String, Int32) metode kelebihan beban menggunakan ukuran buffer default 4.096 byte.

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.

Jika file yang ditentukan tidak ada, file tersebut dibuat; jika memang ada dan tidak baca-saja, konten dihapus dan ditimpa.

Secara default, akses baca/tulis penuh ke file baru diberikan kepada semua pengguna. File dibuka dengan akses baca/tulis dan harus ditutup sebelum dapat dibuka oleh aplikasi lain.

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

Create(String, Int32)

Sumber:

File.cs

Membuat, atau memotong dan menimpa, file di jalur yang ditentukan, menentukan ukuran buffer.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize);

public static System.IO.FileStream Create (string path, int bufferSize);

static member Create : string * int -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer) As FileStream

Parameter

path

String

Jalur dan nama file yang akan dibuat.

bufferSize

Int32

Jumlah byte yang di-buffer untuk dibaca dan ditulis ke file.

Mengembalikan

FileStream

FileStream dengan ukuran buffer yang ditentukan yang menyediakan akses baca/tulis ke file yang ditentukan dalam path.

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

IOException

Terjadi kesalahan I/O saat membuat file.

NotSupportedException

path dalam format yang tidak valid.

Contoh

Contoh berikut membuat file dengan ukuran buffer yang ditentukan.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path, 1024 );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

   // Open the stream and read it back.
   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;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Create the file, or overwrite if the file exists.
        using (FileStream fs = File.Create(path, 1024))
        {
            byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO
open System.Text

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

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create(path, 1024)

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
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"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path, 1024)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Keterangan

Objek FileStream yang dibuat oleh metode ini memiliki nilai Nonedefault FileShare ; tidak ada proses atau kode lain yang dapat mengakses file yang dibuat sampai handel file asli ditutup.

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.

Metode ini setara dengan FileStream(String, FileMode, FileAccess, FileShare, Int32) kelebihan beban konstruktor. Jika file yang ditentukan tidak ada, file tersebut dibuat; jika memang ada dan tidak baca-saja, konten diganti.

Secara default, akses baca/tulis penuh ke file baru diberikan kepada semua pengguna. File dibuka dengan akses baca/tulis dan harus ditutup sebelum dapat dibuka oleh aplikasi lain.

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

Create(String, Int32, FileOptions)

Sumber:

File.cs

Membuat atau menimpa file di jalur yang ditentukan, menentukan ukuran dan opsi buffer yang menjelaskan cara membuat atau menimpa file.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options);

public static System.IO.FileStream Create (string path, int bufferSize, System.IO.FileOptions options);

static member Create : string * int * System.IO.FileOptions -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions) As FileStream

Parameter

path

String

Jalur dan nama file yang akan dibuat.

bufferSize

Int32

Jumlah byte yang di-buffer untuk dibaca dan ditulis ke file.

options

FileOptions

Salah FileOptions satu nilai yang menjelaskan cara membuat atau menimpa file.

Mengembalikan

FileStream

File baru dengan ukuran buffer yang ditentukan.

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, jalur tersebut berada di drive yang tidak dipetakan.

IOException

Terjadi kesalahan I/O saat membuat file.

NotSupportedException

path dalam format yang tidak valid.

Keterangan

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.

Metode ini setara dengan FileStream(String, FileMode, FileAccess, FileShare, Int32) kelebihan beban konstruktor. Jika file yang ditentukan tidak ada, file tersebut dibuat; jika memang ada dan tidak baca-saja, konten diganti.

Secara default, akses baca/tulis penuh ke file baru diberikan kepada semua pengguna. File dibuka dengan akses baca/tulis dan harus ditutup sebelum dapat dibuka oleh aplikasi lain.

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