ClientRolePrincipal Klasa
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Reprezentuje informacje o zabezpieczeniach dla usług aplikacji klienckich, w tym informacje o rolach.
public ref class ClientRolePrincipal : System::Security::Principal::IPrincipal
public class ClientRolePrincipal : System.Security.Principal.IPrincipal
type ClientRolePrincipal = class
interface IPrincipal
Public Class ClientRolePrincipal
Implements IPrincipal
- Dziedziczenie
-
ClientRolePrincipal
- Implementuje
Poniższy przykładowy kod pokazuje, jak używać tej klasy do wyświetlania przycisku tylko wtedy, gdy użytkownik znajduje się w roli "menedżer". Ten przykład wymaga Button o nazwie managerOnlyButton
z początkową wartością właściwości Visiblefalse
.
private void DisplayButtonForManagerRole()
{
try
{
ClientRolePrincipal rolePrincipal =
System.Threading.Thread.CurrentPrincipal
as ClientRolePrincipal;
if (rolePrincipal != null && rolePrincipal.IsInRole("manager"))
{
managerOnlyButton.Visible = true;
}
}
catch (System.Net.WebException)
{
MessageBox.Show("Unable to access the roles service.",
"Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
}
}
Private Sub DisplayButtonForManagerRole()
Try
Dim rolePrincipal As ClientRolePrincipal = TryCast( _
System.Threading.Thread.CurrentPrincipal, ClientRolePrincipal)
If rolePrincipal IsNot Nothing And _
rolePrincipal.IsInRole("manager") Then
managerOnlyButton.Visible = True
End If
Catch ex As System.Net.WebException
MessageBox.Show("Unable to access the role service.", _
"Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)
End Try
End Sub
Podczas sprawdzania poprawności użytkownika w usługach aplikacji klienckich ClientFormsAuthenticationMembershipProvider lub ClientWindowsAuthenticationMembershipProvider ustawia właściwość static
Thread.CurrentPrincipal na wystąpienie tej klasy.
ClientFormsAuthenticationMembershipProvider inicjuje właściwość Identity do nowego wystąpienia klasy ClientFormsIdentity. Właściwość ClientWindowsAuthenticationMembershipProvider inicjuje właściwość Identity do obiektu WindowsIdentity zwróconego przez metodę static
WindowsIdentity.GetCurrent().
Zazwyczaj nie będziesz uzyskiwać bezpośredniego dostępu do tej klasy. Zwykle wywołasz metodę IsInRoleIPrincipal zwróconą przez właściwość static
CurrentPrincipal. Można jednak rzutować wartość właściwości CurrentPrincipal na odwołanie ClientRolePrincipal w celu jawnego wywołania metody IsInRole, jak pokazano w sekcji Przykład.
Client |
Inicjuje nowe wystąpienie klasy ClientRolePrincipal. |
Identity |
Pobiera tożsamość zabezpieczeń skojarzona z ClientRolePrincipal. |
Equals(Object) |
Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object) |
Get |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
Get |
Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object) |
Is |
Pobiera wartość wskazującą, czy użytkownik reprezentowany przez ClientRolePrincipal znajduje się w określonej roli. |
Memberwise |
Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object) |
To |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Produkt | Wersje |
---|---|
.NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Opinia o produkcie .NET
.NET to projekt typu open source. Wybierz link, aby przekazać opinię: