File.GetAccessControl Metode

Definisi

Ruang nama:

System.IO

Rakitan:

mscorlib.dll

Mendapatkan objek FileSecurity yang merangkum entri daftar kontrol akses (ACL) untuk file tertentu.

Overload

GetAccessControl(String)	Mendapatkan objek FileSecurity yang merangkum entri daftar kontrol akses (ACL) untuk file tertentu.
GetAccessControl(String, AccessControlSections)	Mendapatkan objek FileSecurity yang merangkum jenis entri daftar kontrol akses (ACL) yang ditentukan untuk file tertentu.

GetAccessControl(String)

Mendapatkan objek FileSecurity yang merangkum entri daftar kontrol akses (ACL) untuk file tertentu.

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path);

static member GetAccessControl : string -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String) As FileSecurity

Parameter

path

String

Jalur ke file yang berisi objek FileSecurity yang menjelaskan informasi daftar kontrol akses (ACL) file.

Mengembalikan

FileSecurity

Objek FileSecurity yang merangkum aturan kontrol akses untuk 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.

Keterangan

Gunakan metode GetAccessControl untuk mengambil entri daftar kontrol akses (ACL) untuk 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.

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.

GetAccessControl(String, AccessControlSections)

Mendapatkan objek FileSecurity yang merangkum jenis entri daftar kontrol akses (ACL) yang ditentukan untuk file tertentu.

public:
 static System::Security::AccessControl::FileSecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);

public static System.Security.AccessControl.FileSecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);

static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As FileSecurity

Parameter

path

String

Jalur ke file yang berisi objek FileSecurity yang menjelaskan informasi daftar kontrol akses (ACL) file.

includeSections

AccessControlSections

Salah satu nilai AccessControlSections yang menentukan jenis informasi daftar kontrol akses (ACL) yang akan diterima.

Mengembalikan

FileSecurity

Objek FileSecurity yang merangkum aturan kontrol akses untuk 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.

Keterangan

Gunakan metode GetAccessControl untuk mengambil entri daftar kontrol akses (ACL) untuk 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.

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.