Freigeben über


FileSecurity Konstruktoren

Definition

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

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.

Gilt für:

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

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

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

Die im fileName Parameter angegebene Datei wurde nicht gefunden.

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

path weist ein ungültiges Format auf.

Der parameter fileName ist null.

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

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

Das aktuelle Systemkonto verfügt nicht über Administratorrechte.

Die Datei konnte nicht gefunden werden.

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.

Gilt für: