FileMode Enum

  • Referensi

Definisi

Ruang nama:
System.IO
Rakitan:
mscorlib.dll, System.IO.FileSystem.Primitives.dll
Rakitan:
System.Runtime.dll
Rakitan:
System.IO.FileSystem.Primitives.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll

Menentukan bagaimana sistem operasi harus membuka file.

public enum class FileMode
public enum FileMode
[System.Serializable]
public enum FileMode
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum FileMode
type FileMode = 
[<System.Serializable>]
type FileMode = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FileMode = 
Public Enum FileMode
Warisan
Object
ValueType
Enum
FileMode
Atribut
SerializableAttribute ComVisibleAttribute

Bidang

Append 6

Membuka file jika ada dan mencari ke akhir file, atau membuat file baru. Ini memerlukan Append izin. FileMode.Append hanya dapat digunakan bersama dengan FileAccess.Write. Mencoba mencari posisi sebelum akhir file melemparkan IOException pengecualian, dan setiap upaya untuk membaca gagal dan melempar NotSupportedException pengecualian.
Create 2

Menentukan bahwa sistem operasi harus membuat file baru. Jika file sudah ada, itu akan ditimpa. Ini memerlukan Write izin. FileMode.Create setara dengan meminta bahwa jika file tidak ada, gunakan CreateNew; jika tidak, gunakan Truncate. Jika file sudah ada tetapi merupakan file tersembunyi, UnauthorizedAccessException pengecualian akan dilemparkan.
CreateNew 1

Menentukan bahwa sistem operasi harus membuat file baru. Ini memerlukan Write izin. Jika file sudah ada, IOException pengecualian akan dilemparkan.
Open 3

Menentukan bahwa sistem operasi harus membuka file yang ada. Kemampuan untuk membuka file tergantung pada nilai yang ditentukan oleh FileAccess enumerasi. Pengecualian FileNotFoundException dilemparkan jika file tidak ada.
OpenOrCreate 4

Menentukan bahwa sistem operasi harus membuka file jika ada; jika tidak, file baru harus dibuat. Jika file dibuka dengan FileAccess.Read, Read izin diperlukan. Jika akses file adalah FileAccess.Write, Write izin diperlukan. Jika file dibuka dengan FileAccess.ReadWrite, izin dan ReadWrite diperlukan.
Truncate 5

Menentukan bahwa sistem operasi harus membuka file yang ada. Ketika file dibuka, file harus dipotok sehingga ukurannya nol byte. Ini memerlukan Write izin. Upaya untuk membaca dari file yang dibuka dengan FileMode.Truncate menyebabkan ArgumentException pengecualian.

Contoh

Konstruktor berikut FileStream membuka file yang ada (FileMode.Open).

FileStream^ s2 = gcnew FileStream( name, FileMode::Open, FileAccess::Read, FileShare::Read );

FileStream s2 = new FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read);

Dim s2 As New FileStream(name, FileMode.Open, FileAccess.Read, FileShare.Read)

Keterangan

Untuk contoh membuat file dan menulis teks ke file, lihat Cara: Menulis Teks ke File. Untuk contoh membaca teks dari file, lihat Cara: Membaca Teks dari File. Untuk contoh membaca dari dan menulis ke file biner, lihat Cara: Membaca dan Menulis ke File Data yang Baru Dibuat.

Parameter FileMode ditentukan di banyak konstruktor untuk FileStream, , IsolatedStorageFileStreamdan dalam Open metode File dan FileInfo untuk mengontrol bagaimana file dibuka.

FileMode parameter mengontrol apakah file ditimpa, dibuat, dibuka, atau beberapa kombinasinya. Gunakan Open untuk membuka file yang sudah ada. Untuk menambahkan ke file, gunakan Append. Untuk memotong file atau membuat file jika tidak ada, gunakan Create.

Berlaku untuk

Lihat juga