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 FileSecurity klasy 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 FileSecurity obiekt, 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 FileSecurity obiektu przy użyciu AddAccessRule metody . Reguły dostępu lub inspekcji można usunąć przy użyciu RemoveAccessRule metody .

Aby utrwalać nowe lub zmienione reguły dostępu lub inspekcji do pliku, użyj SetAccessControl metody or SetAccessControl . Aby pobrać reguły dostępu lub inspekcji z istniejącego pliku, użyj GetAccessControl metody lub .GetAccessControl

FileSecurity(String, AccessControlSections)

Inicjuje nowe wystąpienie FileSecurity klasy 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 FileSecurity obiektu.

includeSections

AccessControlSections

Jedna 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łe znaki lub zawiera co najmniej jeden nieprawidłowy znak zdefiniowany przez InvalidPathCharsmetodę .

DirectoryNotFoundException

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

FileNotFoundException

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

IOException

Podczas otwierania pliku wystąpił błąd We/Wy.

NotSupportedException

path jest w nieprawidłowym formacie.

SEHException

Parametr fileName to null.

PlatformNotSupportedException

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

PathTooLongException

Podana ścieżka, nazwa pliku lub obie 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, który jest 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 posiada wymaganych uprawnień.

Uwagi

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

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

Aby utrwalać nowe lub zmienione reguły dostępu lub inspekcji do pliku, użyj SetAccessControl metody or SetAccessControl . Aby pobrać reguły dostępu lub inspekcji z istniejącego pliku, użyj GetAccessControl metody lub .GetAccessControl

Uwagi dotyczące wywoływania

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