FileSecurity Konstruktory

Definicja

Przestrzeń nazw:

System.Security.AccessControl

Zestaw:

System.IO.FileSystem.AccessControl.dll

Inicjuje nowe wystąpienie klasy FileSecurity.

Przeciążenia

FileSecurity()	Inicjuje nowe wystąpienie klasy FileSecurity.
FileSecurity(String, AccessControlSections)	Inicjuje nowe wystąpienie klasy FileSecurity z określonego pliku przy użyciu określonych wartości wyliczenia AccessControlSections.

FileSecurity()

Inicjuje nowe wystąpienie klasy FileSecurity.

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

Wyjątki

PlatformNotSupportedException

Bieżący system operacyjny nie jest systemem Microsoft Windows 2000 lub nowszym.

Uwagi

Użyj tego konstruktora, jeśli chcesz utworzyć pusty obiekt FileSecurity, który nie jest oparty na istniejącym pliku. Następnie można wypełnić obiekt informacjami dotyczącymi kontroli dostępu i zastosować go do pliku.

Reguły dostępu lub inspekcji można dodać do obiektu FileSecurity przy użyciu metody AddAccessRule. Reguły dostępu lub inspekcji można usunąć przy użyciu metody RemoveAccessRule.

FileSecurity(String, AccessControlSections)

Inicjuje nowe wystąpienie klasy FileSecurity z określonego pliku przy użyciu określonych wartości wyliczenia 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

Lokalizacja pliku do utworzenia obiektu FileSecurity.

includeSections

AccessControlSections

Jedną z AccessControlSections wartości określających typ informacji listy kontroli dostępu (ACL) do pobrania.

Wyjątki

ArgumentException

Parametr fileName jest ciągiem o zerowej długości, zawiera tylko biały znak lub zawiera jeden lub więcej nieprawidłowych znaków zdefiniowanych przez InvalidPathChars.

DirectoryNotFoundException

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

FileNotFoundException

Nie można odnaleźć pliku określonego w parametrze fileName.

IOException

Wystąpił błąd we/wy podczas otwierania pliku.

NotSupportedException

path jest w nieprawidłowym formacie.

SEHException

Parametr fileName jest null.

PlatformNotSupportedException

Bieżący system operacyjny nie jest systemem Microsoft Windows 2000 lub nowszym.

PathTooLongException

Określona ścieżka, nazwa pliku lub obie metody przekraczają maksymalną długość zdefiniowaną przez system.

PrivilegeNotHeldException

Bieżące konto systemowe nie ma uprawnień administracyjnych.

SystemException

Nie można odnaleźć pliku.

UnauthorizedAccessException

Parametr fileName określił plik tylko do odczytu.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub-

Parametr fileName określił katalog.

-lub-

Obiekt wywołujący nie ma wymaganych uprawnień.

Uwagi

Ten konstruktor pobiera informacje kontroli dostępu dla określonego pliku, a następnie tworzy obiekt FileSecurity, który hermetyzuje te informacje. Następnie można sprawdzić, dodać lub usunąć informacje kontroli dostępu dla określonego pliku.

Reguły dostępu lub inspekcji można dodać do obiektu FileSecurity przy użyciu metody AddAccessRule. Reguły dostępu lub inspekcji można usunąć przy użyciu metody RemoveAccessRule.

Uwagi dotyczące wywoływania

Konstruktor FileSecurity(String, AccessControlSections) wymaga, aby bieżące konto miało uprawnienia administracyjne. Aby utworzyć nowe wystąpienie klasy FileSecurity dla określonego pliku przy użyciu konta, które nie ma uprawnień administracyjnych, użyj metody GetAccessControl().