FileSecurity Konstruktory

Definice

Obor názvů:

System.Security.AccessControl

Sestavení:

System.IO.FileSystem.AccessControl.dll

Balíček:

System.IO.FileSystem.AccessControl v5.0.0

Inicializuje novou instanci FileSecurity třídy.

Přetížení

FileSecurity()	Inicializuje novou instanci FileSecurity třídy.
FileSecurity(String, AccessControlSections)	Inicializuje novou instanci FileSecurity třídy ze zadaného souboru pomocí zadaných hodnot výčtu AccessControlSections .

FileSecurity()

Inicializuje novou instanci FileSecurity třídy.

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

Výjimky

PlatformNotSupportedException

Aktuální operační systém není Microsoft Windows 2000 nebo novější.

Poznámky

Tento konstruktor použijte, pokud chcete vytvořit prázdný FileSecurity objekt, který není založen na existujícím souboru. Pak můžete objekt naplnit informacemi o řízení přístupu a použít je na soubor.

Pomocí metody můžete k objektu FileSecurity přidat pravidla přístupu nebo auditování AddAccessRule . Pravidla přístupu nebo auditu můžete odebrat pomocí RemoveAccessRule metody .

Pokud chcete k souboru zachovat nová nebo změněná pravidla přístupu nebo auditování, použijte metodu SetAccessControl nebo SetAccessControl . Pokud chcete načíst pravidla přístupu nebo auditování z existujícího souboru, použijte metodu GetAccessControl nebo GetAccessControl .

FileSecurity(String, AccessControlSections)

Inicializuje novou instanci FileSecurity třídy ze zadaného souboru pomocí zadaných hodnot výčtu AccessControlSections .

public:
 FileSecurity(System::String ^ fileName, System::Security::AccessControl::AccessControlSections includeSections);

public FileSecurity (string fileName, System.Security.AccessControl.AccessControlSections includeSections);

new System.Security.AccessControl.FileSecurity : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.FileSecurity

Public Sub New (fileName As String, includeSections As AccessControlSections)

Parametry

fileName

String

Umístění souboru, ze které chcete vytvořit FileSecurity objekt.

includeSections

AccessControlSections

Jedna z AccessControlSections hodnot, která určuje typ informací seznamu řízení přístupu (ACL), které se mají načíst.

Výjimky

ArgumentException

Parametr fileName je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků definovaných nástrojem InvalidPathChars.

DirectoryNotFoundException

Zadaná cesta je neplatná (například se nachází na nenamapované jednotce).

FileNotFoundException

Soubor zadaný v parametru fileName nebyl nalezen.

IOException

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

NotSupportedException

path je v neplatném formátu.

SEHException

Parametr fileName je null.

PlatformNotSupportedException

Aktuální operační systém není Microsoft Windows 2000 nebo novější.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

PrivilegeNotHeldException

Aktuální systémový účet nemá oprávnění správce.

SystemException

Soubor nebyl nalezen.

UnauthorizedAccessException

Parametr fileName určil soubor, který je jen pro čtení.

-nebo-

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

-nebo-

Parametr fileName určil adresář.

-nebo-

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

Poznámky

Tento konstruktor načte informace řízení přístupu pro zadaný soubor a poté vytvoří FileSecurity objekt, který zapouzdřuje tyto informace. Pak můžete zkontrolovat, přidat nebo odstranit informace o řízení přístupu pro zadaný soubor.

Pomocí metody můžete k objektu FileSecurity přidat pravidla přístupu nebo auditování AddAccessRule . Pravidla přístupu nebo auditu můžete odebrat pomocí RemoveAccessRule metody .

Pokud chcete k souboru zachovat nová nebo změněná pravidla přístupu nebo auditování, použijte metodu SetAccessControl nebo SetAccessControl . Pokud chcete načíst pravidla přístupu nebo auditování z existujícího souboru, použijte metodu GetAccessControl nebo GetAccessControl .

Poznámky pro volající

Konstruktor FileSecurity(String, AccessControlSections) vyžaduje, aby aktuální účet měl oprávnění správce. Pokud chcete vytvořit novou instanci FileSecurity třídy pro konkrétní soubor pomocí účtu, který nemá oprávnění správce, použijte metodu GetAccessControl() .