FileSystemAccessRule Constructors

Definitie

Naamruimte:: System.Security.AccessControl

Assembly:: mscorlib.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de FileSystemAccessRule klasse.

Overloads

Name	Description
FileSystemAccessRule(IdentityReference, FileSystemRights, AccessControlType)	Initialiseert een nieuw exemplaar van de FileSystemAccessRule klasse met behulp van een verwijzing naar een gebruikersaccount, een waarde die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel en een waarde die aangeeft of de bewerking moet worden toegestaan of geweigerd.
FileSystemAccessRule(String, FileSystemRights, AccessControlType)	Initialiseert een nieuw exemplaar van de FileSystemAccessRule klasse met behulp van de naam van een gebruikersaccount, een waarde die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel en een waarde die beschrijft of de bewerking moet worden toegestaan of geweigerd.
FileSystemAccessRule(IdentityReference, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)	Initialiseert een nieuw exemplaar van de FileSystemAccessRule klasse met behulp van een verwijzing naar een gebruikersaccount, een waarde die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel, een waarde die bepaalt hoe rechten worden overgenomen, een waarde die bepaalt hoe rechten worden doorgegeven en een waarde die aangeeft of de bewerking moet worden toegestaan of geweigerd.
FileSystemAccessRule(String, FileSystemRights, InheritanceFlags, PropagationFlags, AccessControlType)	Initialiseert een nieuw exemplaar van de FileSystemAccessRule klasse met behulp van de naam van een gebruikersaccount, een waarde die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel, een waarde die bepaalt hoe rechten worden overgenomen, een waarde die bepaalt hoe rechten worden doorgegeven en een waarde die aangeeft of de bewerking moet worden toegestaan of geweigerd.

FileSystemAccessRule(IdentityReference, FileSystemRights, AccessControlType)

Initialiseert een nieuw exemplaar van de FileSystemAccessRule klasse met behulp van een verwijzing naar een gebruikersaccount, een waarde die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel en een waarde die aangeeft of de bewerking moet worden toegestaan of geweigerd.

public:
 FileSystemAccessRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::AccessControlType type);

public FileSystemAccessRule(System.Security.Principal.IdentityReference identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.FileSystemAccessRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.FileSystemAccessRule

Public Sub New (identity As IdentityReference, fileSystemRights As FileSystemRights, type As AccessControlType)

Parameters

identity: IdentityReference

Een IdentityReference object dat een verwijzing naar een gebruikersaccount inkapselt.

fileSystemRights: FileSystemRights

Een van de FileSystemRights waarden die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel.

type: AccessControlType

Een van de AccessControlType waarden die aangeven of de bewerking moet worden toegestaan of geweigerd.

Uitzonderingen

ArgumentException

De identity parameter is geen IdentityReference object.

ArgumentNullException

De identity parameter is null.

ArgumentOutOfRangeException

Er is een onjuiste opsomming doorgegeven aan de type parameter.

Opmerkingen

Gebruik deze constructor om een regel voor toegangsbeheer te maken die u kunt behouden met behulp van de FileSecurity of DirectorySecurity klasse. Regels voor toegangsbeheer definiëren gebruikersaccountrechten die bepalen welke acties zijn toegestaan of niet zijn toegestaan op computers met Microsoft Windows.

Van toepassing op

FileSystemAccessRule(String, FileSystemRights, AccessControlType)

Initialiseert een nieuw exemplaar van de FileSystemAccessRule klasse met behulp van de naam van een gebruikersaccount, een waarde die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel en een waarde die beschrijft of de bewerking moet worden toegestaan of geweigerd.

public:
 FileSystemAccessRule(System::String ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::AccessControlType type);

public FileSystemAccessRule(string identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.FileSystemAccessRule : string * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.FileSystemAccessRule

Public Sub New (identity As String, fileSystemRights As FileSystemRights, type As AccessControlType)

Parameters

identity: String

De naam van een gebruikersaccount.

fileSystemRights: FileSystemRights

Een van de FileSystemRights waarden die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel.

type: AccessControlType

Een van de AccessControlType waarden die aangeven of de bewerking moet worden toegestaan of geweigerd.

Uitzonderingen

ArgumentNullException

De identity parameter is null.

ArgumentOutOfRangeException

Er is een onjuiste opsomming doorgegeven aan de type parameter.

Voorbeelden

In het volgende codevoorbeeld wordt de FileSecurity klasse gebruikt om een TOEGANGSBEHEER-vermelding (ACE) toe te voegen en vervolgens uit een bestand te verwijderen. U moet een geldig gebruikers- of groepsaccount opgeven om dit voorbeeld uit te voeren.

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)
        {
            FileInfo fileInfo = new(fileName);
            FileSecurity fSecurity = fileInfo.GetAccessControl();

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

            // Set the new access settings.
            fileInfo.SetAccessControl(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)
        {
            FileInfo fileInfo = new(fileName);
            FileSecurity fSecurity = fileInfo.GetAccessControl();

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

            // Set the new access settings.
            fileInfo.SetAccessControl(fSecurity);
        }
    }
}

Imports System.IO
Imports System.Security.AccessControl

Module FileExample

    Sub Main()
        Try
            Dim fileName As String = "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 e As Exception
            Console.WriteLine(e)
        End Try

    End Sub

    ' Adds an ACL entry on the specified file for the specified account.
    Sub AddFileSecurity(ByVal fileName As String, ByVal account As String,
        ByVal rights As FileSystemRights, ByVal controlType As AccessControlType)

        Dim fileInfo As New FileInfo(fileName)
        Dim fSecurity As FileSecurity = fileInfo.GetAccessControl()

        ' Add the FileSystemAccessRule to the security settings. 
        Dim accessRule As New FileSystemAccessRule(account, rights, controlType)

        fSecurity.AddAccessRule(accessRule)

        ' Set the new access settings.
        fileInfo.SetAccessControl(fSecurity)

    End Sub

    ' Removes an ACL entry on the specified file for the specified account.
    Sub RemoveFileSecurity(ByVal fileName As String, ByVal account As String,
        ByVal rights As FileSystemRights, ByVal controlType As AccessControlType)

        Dim fileInfo As New FileInfo(fileName)
        Dim fSecurity As FileSecurity = fileInfo.GetAccessControl()

        ' Remove the FileSystemAccessRule from the security settings. 
        fSecurity.RemoveAccessRule(New FileSystemAccessRule(account,
            rights, controlType))

        ' Set the new access settings.
        fileInfo.SetAccessControl(fSecurity)

    End Sub
End Module

Opmerkingen

De identity parameter moet een geldig account identificeren op de huidige computer of het huidige domein. De tekenreeks heeft de volgende vorm, waarbij DOMAIN de naam van een geldig domein of computernaam is en account de naam is van een geldig gebruikersaccount op een domein of computer: DOMAIN\account.

Van toepassing op

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

Initialiseert een nieuw exemplaar van de FileSystemAccessRule klasse met behulp van een verwijzing naar een gebruikersaccount, een waarde die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel, een waarde die bepaalt hoe rechten worden overgenomen, een waarde die bepaalt hoe rechten worden doorgegeven en een waarde die aangeeft of de bewerking moet worden toegestaan of geweigerd.

public:
 FileSystemAccessRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AccessControlType type);

public FileSystemAccessRule(System.Security.Principal.IdentityReference identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.FileSystemAccessRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.FileSystemAccessRule

Public Sub New (identity As IdentityReference, fileSystemRights As FileSystemRights, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, type As AccessControlType)

Parameters

identity: IdentityReference

Een IdentityReference object dat een verwijzing naar een gebruikersaccount inkapselt.

fileSystemRights: FileSystemRights

Een van de FileSystemRights waarden die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel.

inheritanceFlags: InheritanceFlags

Een van de InheritanceFlags waarden die aangeeft hoe toegangsmaskers worden doorgegeven aan onderliggende objecten.

propagationFlags: PropagationFlags

Een van de PropagationFlags waarden die aangeeft hoe Access Control vermeldingen (ACL's) worden doorgegeven aan onderliggende objecten.

type: AccessControlType

Een van de AccessControlType waarden die aangeven of de bewerking moet worden toegestaan of geweigerd.

Uitzonderingen

ArgumentException

De identity parameter is geen IdentityReference object.

ArgumentNullException

De identity parameter is null.

ArgumentOutOfRangeException

Er is een onjuiste opsomming doorgegeven aan de type parameter.

– of –

Er is een onjuiste opsomming doorgegeven aan de inheritanceFlags parameter.

– of –

Er is een onjuiste opsomming doorgegeven aan de propagationFlags parameter.

Opmerkingen

Van toepassing op

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

Initialiseert een nieuw exemplaar van de FileSystemAccessRule klasse met behulp van de naam van een gebruikersaccount, een waarde die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel, een waarde die bepaalt hoe rechten worden overgenomen, een waarde die bepaalt hoe rechten worden doorgegeven en een waarde die aangeeft of de bewerking moet worden toegestaan of geweigerd.

public:
 FileSystemAccessRule(System::String ^ identity, System::Security::AccessControl::FileSystemRights fileSystemRights, System::Security::AccessControl::InheritanceFlags inheritanceFlags, System::Security::AccessControl::PropagationFlags propagationFlags, System::Security::AccessControl::AccessControlType type);

public FileSystemAccessRule(string identity, System.Security.AccessControl.FileSystemRights fileSystemRights, System.Security.AccessControl.InheritanceFlags inheritanceFlags, System.Security.AccessControl.PropagationFlags propagationFlags, System.Security.AccessControl.AccessControlType type);

new System.Security.AccessControl.FileSystemAccessRule : string * System.Security.AccessControl.FileSystemRights * System.Security.AccessControl.InheritanceFlags * System.Security.AccessControl.PropagationFlags * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.FileSystemAccessRule

Public Sub New (identity As String, fileSystemRights As FileSystemRights, inheritanceFlags As InheritanceFlags, propagationFlags As PropagationFlags, type As AccessControlType)

Parameters

identity: String

De naam van een gebruikersaccount.

fileSystemRights: FileSystemRights

Een van de FileSystemRights waarden die het type bewerking aangeeft dat is gekoppeld aan de toegangsregel.

inheritanceFlags: InheritanceFlags

Een van de InheritanceFlags waarden die aangeeft hoe toegangsmaskers worden doorgegeven aan onderliggende objecten.

propagationFlags: PropagationFlags

Een van de PropagationFlags waarden die aangeeft hoe Access Control vermeldingen (ACL's) worden doorgegeven aan onderliggende objecten.

type: AccessControlType

Een van de AccessControlType waarden die aangeven of de bewerking moet worden toegestaan of geweigerd.

Uitzonderingen

ArgumentNullException

De identity parameter is null.

ArgumentOutOfRangeException

Er is een onjuiste opsomming doorgegeven aan de type parameter.

– of –

Er is een onjuiste opsomming doorgegeven aan de inheritanceFlags parameter.

– of –

Er is een onjuiste opsomming doorgegeven aan de propagationFlags parameter.

Opmerkingen

Van toepassing op

Feedback

Is deze pagina nuttig?