SemaphoreAccessRule Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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) .