File.OpenHandle Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Sumber:

File.cs

Menginisialisasi instans SafeFileHandle baru kelas dengan jalur yang ditentukan, mode pembuatan, izin baca/tulis dan berbagi, akses safeFileHandles lainnya dapat memiliki ke file yang sama, opsi file tambahan, dan ukuran alokasi.

public static Microsoft.Win32.SafeHandles.SafeFileHandle OpenHandle (string path, System.IO.FileMode mode = System.IO.FileMode.Open, System.IO.FileAccess access = System.IO.FileAccess.Read, System.IO.FileShare share = System.IO.FileShare.Read, System.IO.FileOptions options = System.IO.FileOptions.None, long preallocationSize = 0);

static member OpenHandle : string * System.IO.FileMode * System.IO.FileAccess * System.IO.FileShare * System.IO.FileOptions * int64 -> Microsoft.Win32.SafeHandles.SafeFileHandle

Public Shared Function OpenHandle (path As String, Optional mode As FileMode = System.IO.FileMode.Open, Optional access As FileAccess = System.IO.FileAccess.Read, Optional share As FileShare = System.IO.FileShare.Read, Optional options As FileOptions = System.IO.FileOptions.None, Optional preallocationSize As Long = 0) As SafeFileHandle

Parameter

path

String

Jalur relatif atau absolut untuk file yang akan dirangkum instans saat ini SafeFileHandle .

mode

FileMode

Salah satu nilai enumerasi yang menentukan cara membuka atau membuat file. Nilai defaultnya adalah Open

access

FileAccess

Kombinasi bitwise dari nilai enumerasi yang menentukan bagaimana file dapat diakses. Nilai defaultnya adalah Read

share

FileShare

Kombinasi bitwise dari nilai enumerasi yang menentukan bagaimana file akan dibagikan oleh proses. Nilai defaultnya adalah Read.

options

FileOptions

Objek yang menjelaskan parameter opsional SafeFileHandle untuk digunakan.

preallocationSize

Int64

Ukuran alokasi awal dalam byte untuk file. Nilai positif hanya efektif ketika file reguler sedang dibuat, ditimpa, atau diganti. Nilai negatif tidak diperbolehkan. Dalam kasus lain (termasuk nilai default 0), nilai tersebut diabaikan.

Mengembalikan

SafeFileHandle

Instans SafeFileHandle.

Pengecualian

ArgumentNullException

pathadalah null.

ArgumentException

path adalah string kosong (""), hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid. -or- path mengacu pada perangkat non-file, seperti CON:, , COM1:LPT1:, dll. di lingkungan NTFS.

NotSupportedException

pathmengacu pada perangkat non-file, seperti CON:, , COM1:LPT1:, dll. di lingkungan non-NTFS.

ArgumentOutOfRangeException

preallocationSize negatif. -or- mode, access, atau share berisi nilai yang tidak valid.

FileNotFoundException

File tidak dapat ditemukan, seperti ketika mode adalah Truncate atau Open, dan file yang ditentukan oleh path tidak ada. File harus sudah ada dalam mode ini.

IOException

Kesalahan I/O, seperti menentukan CreateNew kapan file yang ditentukan oleh path sudah ada, terjadi. -or- Disk penuh (ketika preallocationSize disediakan dan path menunjuk ke file biasa). -or- File terlalu besar (ketika preallocationSize disediakan dan path menunjuk ke file biasa).

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid, seperti berada di drive yang tidak dipetakan.

UnauthorizedAccessException

Yang access diminta tidak diizinkan oleh sistem operasi untuk yang ditentukan path, seperti kapan access adalah Write atau ReadWrite dan file atau direktori diatur untuk akses baca-saja. -or- Encrypted ditentukan untuk options, tetapi enkripsi file tidak didukung pada platform saat ini.

PathTooLongException

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