Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

FileSystemAccessRule-Klasse

 

Veröffentlicht: Oktober 2016

Stellt einen Zugriffssteuerungseintrag (ACE), der eine Zugriffsregel für eine Datei oder ein Verzeichnis definiert eine Abstraktion dar. Diese Klasse kann nicht vererbt werden.

Namespace:   System.Security.AccessControl
Assembly:  mscorlib (in mscorlib.dll)

System.Object
  System.Security.AccessControl.AuthorizationRule
    System.Security.AccessControl.AccessRule
      System.Security.AccessControl.FileSystemAccessRule

public sealed class FileSystemAccessRule : AccessRule

NameBeschreibung
System_CAPS_pubmethodFileSystemAccessRule(IdentityReference, FileSystemRights, AccessControlType)

Initialisiert eine neue Instanz der FileSystemAccessRule -Klasse mit einem Verweis auf ein Benutzerkonto, ein Wert, der den Typ der Zugriffsregel zugeordnete Operation angibt und ein Wert, der angibt, ob die Operation zugelassen oder verweigert.

System_CAPS_pubmethodFileSystemAccessRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)

Initialisiert eine neue Instanz der FileSystemAccessRule -Klasse mit einem Verweis auf ein Benutzerkonto, ein Wert, der angibt, welcher Vorgang zugeordnet, die Regel, ein Wert, der bestimmt, wie Rechte geerbt werden, einem Wert, der bestimmt, wie Rechte weitergegeben werden und ein Wert, der angibt, ob die Operation zugelassen oder verweigert.

System_CAPS_pubmethodFileSystemAccessRule(String, FileSystemRights, AccessControlType)

Initialisiert eine neue Instanz der FileSystemAccessRule -Klasse mit dem Namen eines Benutzerkontos, ein Wert, der den Typ der Zugriffsregel zugeordnete Operation angibt und ein Wert, der angibt, ob die Operation zugelassen oder verweigert.

System_CAPS_pubmethodFileSystemAccessRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)

Initialisiert eine neue Instanz der FileSystemAccessRule -Klasse mit dem Namen eines Benutzerkontos ein Wert, der angibt, welcher Vorgang zugeordnet, die Regel, ein Wert, der bestimmt, wie Rechte geerbt werden, einem Wert, der bestimmt, wie Rechte weitergegeben werden und ein Wert, der angibt, ob die Operation zugelassen oder verweigert.

NameBeschreibung
System_CAPS_pubpropertyAccessControlType

Ruft die AccessControlType zugeordneten Wert AccessRule Objekt.(Geerbt von „AccessRule“.)

System_CAPS_protpropertyAccessMask

Ruft die Zugriffsmaske für diese Regel ab.(Geerbt von „AuthorizationRule“.)

System_CAPS_pubpropertyFileSystemRights

Ruft die FileSystemRights der aktuellen zugeordneten Flags FileSystemAccessRule Objekt.

System_CAPS_pubpropertyIdentityReference

Ruft den IdentityReference ab, für den diese Regel gilt.(Geerbt von „AuthorizationRule“.)

System_CAPS_pubpropertyInheritanceFlags

Ruft den Wert von Flags ab, die bestimmen, wie diese Regel von untergeordneten Objekten geerbt wird.(Geerbt von „AuthorizationRule“.)

System_CAPS_pubpropertyIsInherited

Ruft einen Wert ab, der angibt, ob diese Regel explizit festgelegt oder von einem übergeordneten Containerobjekt geerbt wird.(Geerbt von „AuthorizationRule“.)

System_CAPS_pubpropertyPropagationFlags

Ruft den Wert der Weitergabeflags ab, die bestimmen, wie die Vererbung dieser Regel an untergeordnete Objekte weitergegeben wird. Diese Eigenschaft ist nur dann wesentlich, wenn der Wert der InheritanceFlags-Enumeration nicht None ist.(Geerbt von „AuthorizationRule“.)

NameBeschreibung
System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

Die FileSystemAccessRule -Klasse stellt eine Abstraktion der zugrunde liegenden Zugriffssteuerungseintrags (ACE), der angibt, ein Benutzerkonto, den Typ des Zugriffs (Lesen, schreiben usw.) und ob zulassen oder verweigern, richtig. Diese Klasse kann auch angeben, wie Zugriffsregeln an untergeordnete Objekte weitergegeben werden.

Verwenden der FileSystemAccessRule Klasse, um eine neue Zugriffsregel erstellen. Sie können beibehalten, die mithilfe der FileSecurity oder DirectorySecurity Klasse.

Im folgenden Codebeispiel wird mithilfe der FileSecurity Klasse hinzufügen und entfernen Sie dann einen Zugriffssteuerungseintrag (ACE) aus einer Datei. Sie müssen ein gültiges Benutzer- oder Gruppenkonto angeben, um dieses Beispiel auszuführen.

using System;
using System.IO;
using System.Security.AccessControl;

namespace FileSystemExample
{
    class FileExample
    {
        public static void Main()
        {
            try
            {
                string fileName = "test.xml";

                Console.WriteLine("Adding access control entry for "
                    + fileName);

                // Add the access control entry to the file.
                AddFileSecurity(fileName, @"DomainName\AccountName",
                    FileSystemRights.ReadData, AccessControlType.Allow);

                Console.WriteLine("Removing access control entry from "
                    + fileName);

                // Remove the access control entry from the file.
                RemoveFileSecurity(fileName, @"DomainName\AccountName",
                    FileSystemRights.ReadData, AccessControlType.Allow);

                Console.WriteLine("Done.");
            }
            catch (Exception e)
            {
                Console.WriteLine(e);
            }
        }

        // Adds an ACL entry on the specified file for the specified account.
        public static void AddFileSecurity(string fileName, string account,
            FileSystemRights rights, AccessControlType controlType)
        {


            // Get a FileSecurity object that represents the
            // current security settings.
            FileSecurity fSecurity = File.GetAccessControl(fileName);

            // Add the FileSystemAccessRule to the security settings.
            fSecurity.AddAccessRule(new FileSystemAccessRule(account,
                rights, controlType));

            // Set the new access settings.
            File.SetAccessControl(fileName, fSecurity);

        }

        // Removes an ACL entry on the specified file for the specified account.
        public static void RemoveFileSecurity(string fileName, string account,
            FileSystemRights rights, AccessControlType controlType)
        {

            // Get a FileSecurity object that represents the
            // current security settings.
            FileSecurity fSecurity = File.GetAccessControl(fileName);

            // Remove the FileSystemAccessRule from the security settings.
            fSecurity.RemoveAccessRule(new FileSystemAccessRule(account,
                rights, controlType));

            // Set the new access settings.
            File.SetAccessControl(fileName, fSecurity);

        }
    }
}

.NET Framework
Verfügbar seit 2.0

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: