FileSecurity Konstruktoren

Definition

Namespace:

System.Security.AccessControl

Assembly:

System.IO.FileSystem.AccessControl.dll

Initialisiert eine neue Instanz der FileSecurity Klasse.

Überlädt

FileSecurity()	Initialisiert eine neue Instanz der FileSecurity Klasse.
FileSecurity(String, AccessControlSections)	Initialisiert eine neue Instanz der FileSecurity Klasse aus einer angegebenen Datei mithilfe der angegebenen Werte der AccessControlSections-Aufzählung.

FileSecurity()

Initialisiert eine neue Instanz der FileSecurity Klasse.

public:
 FileSecurity();

public FileSecurity ();

Public Sub New ()

Ausnahmen

PlatformNotSupportedException

Das aktuelle Betriebssystem ist nicht Microsoft Windows 2000 oder höher.

Hinweise

Verwenden Sie diesen Konstruktor, wenn Sie ein leeres FileSecurity-Objekt erstellen möchten, das nicht auf einer vorhandenen Datei basiert. Anschließend können Sie das Objekt mit Zugriffssteuerungsinformationen auffüllen und auf eine Datei anwenden.

Sie können dem FileSecurity Objekt Mithilfe der AddAccessRule-Methode Zugriffs- oder Überwachungsregeln hinzufügen. Sie können Zugriffs- oder Überwachungsregeln mithilfe der RemoveAccessRule-Methode entfernen.

FileSecurity(String, AccessControlSections)

Initialisiert eine neue Instanz der FileSecurity Klasse aus einer angegebenen Datei mithilfe der angegebenen Werte der AccessControlSections-Aufzählung.

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)

Parameter

fileName

String

Der Speicherort einer Datei, aus der ein FileSecurity-Objekt erstellt werden soll.

includeSections

AccessControlSections

Einer der AccessControlSections Werte, die den Typ der abzurufenden Zugriffssteuerungslisteninformationen (Access Control List, ACL) angibt.

Ausnahmen

ArgumentException

Der parameter fileName ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen, wie durch InvalidPathCharsdefiniert.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (z. B. auf einem nicht zugeordneten Laufwerk).

FileNotFoundException

Die im fileName Parameter angegebene Datei wurde nicht gefunden.

IOException

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

NotSupportedException

path weist ein ungültiges Format auf.

SEHException

Der parameter fileName ist null.

PlatformNotSupportedException

Das aktuelle Betriebssystem ist nicht Microsoft Windows 2000 oder höher.

PathTooLongException

Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.

PrivilegeNotHeldException

Das aktuelle Systemkonto verfügt nicht über Administratorrechte.

SystemException

Die Datei konnte nicht gefunden werden.

UnauthorizedAccessException

Der fileName Parameter hat eine Datei angegeben, die schreibgeschützt ist.

-oder-

Dieser Vorgang wird auf der aktuellen Plattform nicht unterstützt.

-oder-

Der fileName Parameter hat ein Verzeichnis angegeben.

-oder-

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Dieser Konstruktor ruft die Zugriffssteuerungsinformationen für die angegebene Datei ab und erstellt dann ein FileSecurity Objekt, das diese Informationen kapselt. Anschließend können Sie die Zugriffssteuerungsinformationen für die angegebene Datei überprüfen, hinzufügen oder löschen.

Sie können dem FileSecurity Objekt Mithilfe der AddAccessRule-Methode Zugriffs- oder Überwachungsregeln hinzufügen. Sie können Zugriffs- oder Überwachungsregeln mithilfe der RemoveAccessRule-Methode entfernen.

Hinweise für Aufrufer

Der FileSecurity(String, AccessControlSections)-Konstruktor erfordert, dass das aktuelle Konto über Administratorrechte verfügt. Um eine neue Instanz der FileSecurity-Klasse für eine bestimmte Datei mit einem Konto zu erstellen, das nicht über Administratorrechte verfügt, verwenden Sie die GetAccessControl()-Methode.