Sdílet prostřednictvím


SemaphoreAccessRule Konstruktory

Definice

Inicializuje novou instanci SemaphoreAccessRule třídy.

Přetížení

SemaphoreAccessRule(IdentityReference, SemaphoreRights, AccessControlType)

Inicializuje novou instanci SemaphoreAccessRule třídy s určením uživatele nebo skupiny, na které se pravidlo vztahuje, přístupová práva a zda jsou zadaná přístupová práva povolena nebo odepřena.

SemaphoreAccessRule(String, SemaphoreRights, AccessControlType)

Inicializuje novou instanci SemaphoreAccessRule třídy a určí název uživatele nebo skupiny, na které se pravidlo vztahuje, přístupová práva a zda jsou zadaná přístupová práva povolena nebo odepřena.

SemaphoreAccessRule(IdentityReference, SemaphoreRights, AccessControlType)

Zdroj:
SemaphoreSecurity.cs
Zdroj:
SemaphoreSecurity.cs
Zdroj:
SemaphoreSecurity.cs
Zdroj:
SemaphoreSecurity.cs

Inicializuje novou instanci SemaphoreAccessRule třídy s určením uživatele nebo skupiny, na které se pravidlo vztahuje, přístupová práva a zda jsou zadaná přístupová práva povolena nebo odepřena.

public:
 SemaphoreAccessRule(System::Security::Principal::IdentityReference ^ identity, System::Security::AccessControl::SemaphoreRights eventRights, System::Security::AccessControl::AccessControlType type);
public SemaphoreAccessRule (System.Security.Principal.IdentityReference identity, System.Security.AccessControl.SemaphoreRights eventRights, System.Security.AccessControl.AccessControlType type);
new System.Security.AccessControl.SemaphoreAccessRule : System.Security.Principal.IdentityReference * System.Security.AccessControl.SemaphoreRights * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.SemaphoreAccessRule
Public Sub New (identity As IdentityReference, eventRights As SemaphoreRights, type As AccessControlType)

Parametry

identity
IdentityReference

Uživatel nebo skupina, na které se pravidlo vztahuje. Musí být typu SecurityIdentifier nebo typu NTAccount , který lze převést na typ SecurityIdentifier.

eventRights
SemaphoreRights

Bitová kombinace SemaphoreRights hodnot určujících práva povolená nebo odepřená.

type
AccessControlType

Jedna z AccessControlType hodnot určujících, zda jsou práva povolena nebo odepřena.

Výjimky

eventRights určuje neplatnou hodnotu.

-nebo-

type určuje neplatnou hodnotu.

identity je null.

-nebo-

eventRights je nula.

identity není typu SecurityIdentifier , ani typu, který NTAccount lze převést na typ SecurityIdentifier.

Poznámky

Pokud chcete zadat Semaphore, například voláním WaitOne metody, musí mít SemaphoreRights.Synchronize uživatel přístup. Pokud chcete semafor ukončit voláním Release metody, musí mít SemaphoreRights.Modify uživatel přístup.

Platí pro

SemaphoreAccessRule(String, SemaphoreRights, AccessControlType)

Zdroj:
SemaphoreSecurity.cs
Zdroj:
SemaphoreSecurity.cs
Zdroj:
SemaphoreSecurity.cs
Zdroj:
SemaphoreSecurity.cs

Inicializuje novou instanci SemaphoreAccessRule třídy a určí název uživatele nebo skupiny, na které se pravidlo vztahuje, přístupová práva a zda jsou zadaná přístupová práva povolena nebo odepřena.

public:
 SemaphoreAccessRule(System::String ^ identity, System::Security::AccessControl::SemaphoreRights eventRights, System::Security::AccessControl::AccessControlType type);
public SemaphoreAccessRule (string identity, System.Security.AccessControl.SemaphoreRights eventRights, System.Security.AccessControl.AccessControlType type);
new System.Security.AccessControl.SemaphoreAccessRule : string * System.Security.AccessControl.SemaphoreRights * System.Security.AccessControl.AccessControlType -> System.Security.AccessControl.SemaphoreAccessRule
Public Sub New (identity As String, eventRights As SemaphoreRights, type As AccessControlType)

Parametry

identity
String

Jméno uživatele nebo skupiny, na které se pravidlo vztahuje.

eventRights
SemaphoreRights

Bitová kombinace SemaphoreRights hodnot určujících práva povolená nebo odepřená.

type
AccessControlType

Jedna z AccessControlType hodnot určujících, zda jsou práva povolena nebo odepřena.

Výjimky

eventRights určuje neplatnou hodnotu.

-nebo-

type určuje neplatnou hodnotu.

eventRights je nula.

identity je null.

-nebo-

identity je řetězec nulové délky.

-nebo-

identity je delší než 512 znaků.

Příklady

Následující příklad kódu ukazuje použití tohoto konstruktoru k vytvoření SemaphoreAccessRule objektů. Příklad vytvoří SemaphoreSecurity objekt, přidá pravidla, která povolují a odmítnou různá práva pro aktuálního uživatele, a zobrazí výslednou dvojici pravidel. Příklad pak povolí nová práva pro aktuálního uživatele a zobrazí výsledek, který ukazuje, že nová práva jsou sloučena s existujícím Allow pravidlem.

Poznámka

Tento příklad nepřipoutuje objekt zabezpečení k objektu Semaphore . Příklady, které připojují objekty zabezpečení, najdete v Semaphore.GetAccessControl a Semaphore.SetAccessControl.

using System;
using System.Threading;
using System.Security.AccessControl;
using System.Security.Principal;

public class Example
{
    public static void Main()
    {
        // Create a string representing the current user.
        string user = Environment.UserDomainName + "\\" + 
            Environment.UserName;

        // Create a security object that grants no access.
        SemaphoreSecurity mSec = new SemaphoreSecurity();

        // Add a rule that grants the current user the 
        // right to enter or release the semaphore.
        SemaphoreAccessRule rule = new SemaphoreAccessRule(user, 
            SemaphoreRights.Synchronize | SemaphoreRights.Modify, 
            AccessControlType.Allow);
        mSec.AddAccessRule(rule);

        // Add a rule that denies the current user the 
        // right to change permissions on the semaphore.
        rule = new SemaphoreAccessRule(user, 
            SemaphoreRights.ChangePermissions, 
            AccessControlType.Deny);
        mSec.AddAccessRule(rule);

        // Display the rules in the security object.
        ShowSecurity(mSec);

        // Add a rule that allows the current user the 
        // right to read permissions on the semaphore. This rule
        // is merged with the existing Allow rule.
        rule = new SemaphoreAccessRule(user, 
            SemaphoreRights.ReadPermissions, 
            AccessControlType.Allow);
        mSec.AddAccessRule(rule);

        ShowSecurity(mSec);
    }

    private static void ShowSecurity(SemaphoreSecurity security)
    {
        Console.WriteLine("\r\nCurrent access rules:\r\n");

        foreach(SemaphoreAccessRule ar in 
            security.GetAccessRules(true, true, typeof(NTAccount)))
        {
            Console.WriteLine("        User: {0}", ar.IdentityReference);
            Console.WriteLine("        Type: {0}", ar.AccessControlType);
            Console.WriteLine("      Rights: {0}", ar.SemaphoreRights);
            Console.WriteLine();
        }
    }
}

/*This code example produces output similar to following:

Current access rules:

        User: TestDomain\TestUser
        Type: Deny
      Rights: ChangePermissions

        User: TestDomain\TestUser
        Type: Allow
      Rights: Modify, Synchronize


Current access rules:

        User: TestDomain\TestUser
        Type: Deny
      Rights: ChangePermissions

        User: TestDomain\TestUser
        Type: Allow
      Rights: Modify, ReadPermissions, Synchronize
 */
Imports System.Threading
Imports System.Security.AccessControl
Imports System.Security.Principal

Public Class Example

    Public Shared Sub Main()

        ' Create a string representing the current user.
        Dim user As String = Environment.UserDomainName _ 
            & "\" & Environment.UserName

        ' Create a security object that grants no access.
        Dim mSec As New SemaphoreSecurity()

        ' Add a rule that grants the current user the 
        ' right to enter or release the semaphore.
        Dim rule As New SemaphoreAccessRule(user, _
            SemaphoreRights.Synchronize _
            Or SemaphoreRights.Modify, _
            AccessControlType.Allow)
        mSec.AddAccessRule(rule)

        ' Add a rule that denies the current user the 
        ' right to change permissions on the semaphore.
        rule = New SemaphoreAccessRule(user, _
            SemaphoreRights.ChangePermissions, _
            AccessControlType.Deny)
        mSec.AddAccessRule(rule)

        ' Display the rules in the security object.
        ShowSecurity(mSec)

        ' Add a rule that allows the current user the 
        ' right to read permissions on the semaphore. This 
        ' rule is merged with the existing Allow rule.
        rule = New SemaphoreAccessRule(user, _
            SemaphoreRights.ReadPermissions, _
            AccessControlType.Allow)
        mSec.AddAccessRule(rule)

        ShowSecurity(mSec)

    End Sub 

    Private Shared Sub ShowSecurity(ByVal security As SemaphoreSecurity)
        Console.WriteLine(vbCrLf & "Current access rules:" & vbCrLf)

        For Each ar As SemaphoreAccessRule In _
            security.GetAccessRules(True, True, GetType(NTAccount))

            Console.WriteLine("        User: {0}", ar.IdentityReference)
            Console.WriteLine("        Type: {0}", ar.AccessControlType)
            Console.WriteLine("      Rights: {0}", ar.SemaphoreRights)
            Console.WriteLine()
        Next

    End Sub
End Class 

'This code example produces output similar to following:
'
'Current access rules:
'
'        User: TestDomain\TestUser
'        Type: Deny
'      Rights: ChangePermissions
'
'        User: TestDomain\TestUser
'        Type: Allow
'      Rights: Modify, Synchronize
'
'
'Current access rules:
'
'        User: TestDomain\TestUser
'        Type: Deny
'      Rights: ChangePermissions
'
'        User: TestDomain\TestUser
'        Type: Allow
'      Rights: Modify, ReadPermissions, Synchronize

Poznámky

Pokud chcete zadat Semaphore, například voláním WaitOne metody, musí mít SemaphoreRights.Synchronize uživatel přístup. Pokud chcete semafor ukončit voláním Release metody, musí mít SemaphoreRights.Modify uživatel přístup.

Tento konstruktor je ekvivalentem vytvoření objektu NTAccount předáním identity konstruktoru NTAccount.NTAccount(String) a předáním nově vytvořeného NTAccount objektu konstruktoru SemaphoreAccessRule(IdentityReference, SemaphoreRights, AccessControlType) .

Platí pro