FileSecurity Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.