FileSecurity Konstruktoren

  • Referenz

Definition

Namespace:
System.Security.AccessControl
Assembly:
System.IO.FileSystem.AccessControl.dll
Assembly:
mscorlib.dll

Initialisiert eine neue Instanz der FileSecurity-Klasse.

Überlädt

FileSecurity()

Initialisiert eine neue Instanz der FileSecurity-Klasse.
FileSecurity(String, AccessControlSections)

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

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 Objekt mithilfe der FileSecurityAddAccessRule -Methode Zugriffsregeln oder Überwachungsregeln hinzufügen. Sie können Zugriffsregeln oder Überwachungsregeln mithilfe der RemoveAccessRule -Methode entfernen.

Verwenden Sie die SetAccessControlSetAccessControl - oder -Methode, um neue oder geänderte Zugriffs- oder Überwachungsregeln für eine Datei beizubehalten. Verwenden Sie die GetAccessControlGetAccessControl - oder -Methode, um Zugriffs- oder Überwachungsregeln aus einer vorhandenen Datei abzurufen.

Gilt für:

FileSecurity(String, AccessControlSections)

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

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 wird.

includeSections
AccessControlSections

Einer der AccessControlSections-Werte, der den Typ der abzurufenden Informationen zur Zugriffssteuerungsliste angibt.

Ausnahmen

ArgumentException

Der fileName-Parameter ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen gemäß der Definition von InvalidPathChars.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (er befindet sich 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 fileName-Parameter ist null.

PlatformNotSupportedException

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

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

PrivilegeNotHeldException

Das aktuelle Systemkonto verfügt nicht über Administratorrechte.

SystemException

Die Datei wurde nicht gefunden.

UnauthorizedAccessException

Der fileName-Parameter hat eine schreibgeschützte Datei angegeben.

- oder -

Dieser Vorgang wird von 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 Objekt mithilfe der FileSecurityAddAccessRule -Methode Zugriffsregeln oder Überwachungsregeln hinzufügen. Sie können Zugriffsregeln oder Überwachungsregeln mithilfe der RemoveAccessRule -Methode entfernen.

Verwenden Sie die SetAccessControlSetAccessControl - oder -Methode, um neue oder geänderte Zugriffs- oder Überwachungsregeln für eine Datei beizubehalten. Verwenden Sie die GetAccessControlGetAccessControl - oder -Methode, um Zugriffs- oder Überwachungsregeln aus einer vorhandenen Datei abzurufen.

Hinweise für Aufrufer

Der FileSecurity(String, AccessControlSections) Konstruktor erfordert, dass das aktuelle Konto über Administratorrechte verfügt. Verwenden GetAccessControl() Sie die -Methode, um eine neue instance der FileSecurity -Klasse für eine bestimmte Datei mithilfe eines Kontos zu erstellen, das nicht über Administratorrechte verfügt.

Gilt für: