File.SetAccessControl(String, FileSecurity) Metode

Definisi

Ruang nama:

System.IO

Rakitan:

mscorlib.dll

Menerapkan entri daftar kontrol akses (ACL) yang dijelaskan oleh objek FileSecurity ke file yang ditentukan.

public:
 static void SetAccessControl(System::String ^ path, System::Security::AccessControl::FileSecurity ^ fileSecurity);

public static void SetAccessControl (string path, System.Security.AccessControl.FileSecurity fileSecurity);

static member SetAccessControl : string * System.Security.AccessControl.FileSecurity -> unit

Public Shared Sub SetAccessControl (path As String, fileSecurity As FileSecurity)

Parameter

path

String

File untuk menambahkan atau menghapus entri daftar kontrol akses (ACL).

fileSecurity

FileSecurity

Objek FileSecurity yang menjelaskan entri ACL untuk diterapkan ke file yang dijelaskan oleh parameter path.

Pengecualian

IOException

Terjadi kesalahan I/O saat membuka file.

SEHException

Parameter pathnull.

SystemException

File tidak dapat ditemukan.

UnauthorizedAccessException

Parameter path menentukan file yang bersifat baca-saja.

-atau-

Operasi ini tidak didukung pada platform saat ini.

-atau-

Parameter path menentukan direktori.

-atau-

Pemanggil tidak memiliki izin yang diperlukan.

ArgumentNullException

Parameter fileSecuritynull.

Keterangan

Metode SetAccessControl menerapkan entri daftar kontrol akses (ACL) ke file yang mewakili daftar ACL yang tidak diwariskan.

Hati

ACL yang ditentukan untuk parameter fileSecurity menggantikan ACL yang ada untuk file tersebut. Untuk menambahkan izin bagi pengguna baru, gunakan metode GetAccessControl untuk mendapatkan ACL yang ada, ubah, lalu gunakan SetAccessControl untuk menerapkannya kembali ke file.

ACL menjelaskan individu dan grup yang memiliki, atau tidak memiliki, hak atas tindakan tertentu pada file yang diberikan. Untuk informasi selengkapnya, lihat Cara: Menambahkan atau Menghapus Entri Daftar Kontrol Akses.

Metode SetAccessControl hanya bertahan FileSecurity objek yang telah dimodifikasi setelah pembuatan objek. Jika objek FileSecurity belum dimodifikasi, objek tidak akan dipertahankan ke file. Oleh karena itu, tidak dimungkinkan untuk mengambil objek FileSecurity dari satu file dan menerapkan kembali objek yang sama ke file lain.

Untuk menyalin informasi ACL dari satu file ke file lainnya:

1. Gunakan metode GetAccessControl untuk mengambil objek FileSecurity dari file sumber.

2. Buat objek FileSecurity baru untuk file tujuan.

3. Gunakan metode GetSecurityDescriptorBinaryForm atau GetSecurityDescriptorSddlForm objek FileSecurity sumber untuk mengambil informasi ACL.

4. Gunakan metode SetSecurityDescriptorBinaryForm atau SetSecurityDescriptorSddlForm untuk menyalin informasi yang diambil di langkah 3 ke objek FileSecurity tujuan.

5. Atur objek FileSecurity tujuan ke file tujuan menggunakan metode SetAccessControl.

Di lingkungan NTFS, ReadAttributes dan ReadExtendedAttributes diberikan kepada pengguna jika pengguna memiliki hak ListDirectory pada folder induk. Untuk menolak ReadAttributes dan ReadExtendedAttributes, tolak ListDirectory pada direktori induk.

Lihat juga

• FileSystemWatcher