File.GetAccessControl Metoda

Definice

Obor názvů:

System.IO

Sestavení:

mscorlib.dll

Získá FileSecurity objekt, který zapouzdřuje položky seznamu řízení přístupu (ACL) pro zadaný soubor.

Přetížení

GetAccessControl(String)	Získá FileSecurity objekt, který zapouzdřuje položky seznamu řízení přístupu (ACL) pro zadaný soubor.
GetAccessControl(String, AccessControlSections)	Získá FileSecurity objekt, který zapouzdřuje zadaný typ položek seznamu řízení přístupu (ACL) pro určitý soubor.

GetAccessControl(String)

Získá FileSecurity objekt, který zapouzdřuje položky seznamu řízení přístupu (ACL) pro zadaný soubor.

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

Parametry

path

String

Cesta k souboru obsahujícímu FileSecurity objekt, který popisuje informace o seznamu řízení přístupu (ACL) souboru.

Návraty

FileSecurity

Objekt FileSecurity, který zapouzdřuje pravidla řízení přístupu pro soubor popsaný parametrem path.

Výjimky

IOException

Při otevírání souboru došlo k vstupně-výstupní chybě.

SEHException

Parametr path je null.

SystemException

Soubor nebyl nalezen.

UnauthorizedAccessException

Parametr path zadal soubor, který je jen pro čtení.

-nebo-

Tato operace není na aktuální platformě podporovaná.

-nebo-

Parametr path zadal adresář.

-nebo-

Volající nemá požadované oprávnění.

Poznámky

Pomocí metody GetAccessControl načtěte položky seznamu řízení přístupu (ACL) pro soubor.

Seznam ACL popisuje jednotlivce a skupiny, které mají nebo nemají práva ke konkrétním akcím daného souboru. Další informace naleznete v tématu Postupy: Přidání nebo odebrání položek seznamu řízení přístupu.

V prostředích NTFS se uživateli udělí ReadAttributes a ReadExtendedAttributes, pokud má uživatel ListDirectory práva k nadřazené složce. Pokud chcete odepřít ReadAttributes a ReadExtendedAttributes, odepřete ListDirectory v nadřazené adresáři.

GetAccessControl(String, AccessControlSections)

Získá FileSecurity objekt, který zapouzdřuje zadaný typ položek seznamu řízení přístupu (ACL) pro určitý soubor.

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

Parametry

path

String

Cesta k souboru obsahujícímu FileSecurity objekt, který popisuje informace o seznamu řízení přístupu (ACL) souboru.

includeSections

AccessControlSections

Jedna z AccessControlSections hodnot, které určují typ informací seznamu řízení přístupu (ACL), které se mají přijmout.

Návraty

FileSecurity

Objekt FileSecurity, který zapouzdřuje pravidla řízení přístupu pro soubor popsaný parametrem path.

Výjimky

IOException

Při otevírání souboru došlo k vstupně-výstupní chybě.

SEHException

Parametr path je null.

SystemException

Soubor nebyl nalezen.

UnauthorizedAccessException

Parametr path zadal soubor, který je jen pro čtení.

-nebo-

Tato operace není na aktuální platformě podporovaná.

-nebo-

Parametr path zadal adresář.

-nebo-

Volající nemá požadované oprávnění.

Poznámky

Pomocí metody GetAccessControl načtěte položky seznamu řízení přístupu (ACL) pro soubor.

Seznam ACL popisuje jednotlivce a skupiny, které mají nebo nemají práva ke konkrétním akcím daného souboru. Další informace naleznete v tématu Postupy: Přidání nebo odebrání položek seznamu řízení přístupu.

V prostředích NTFS se uživateli udělí ReadAttributes a ReadExtendedAttributes, pokud má uživatel ListDirectory práva k nadřazené složce. Pokud chcete odepřít ReadAttributes a ReadExtendedAttributes, odepřete ListDirectory v nadřazené adresáři.