ClientRolePrincipal Klasa
Definicja
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
Przykłady
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 nazwy managerOnlyButton
z początkową Visible wartością false
właściwości .
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
Uwagi
Podczas sprawdzania poprawności użytkownika w usługach ClientFormsAuthenticationMembershipProvider aplikacji klienckich właściwość lub ClientWindowsAuthenticationMembershipProvider ustawia static
Thread.CurrentPrincipal właściwość na wystąpienie tej klasy. Właściwość ClientFormsAuthenticationMembershipProvider inicjuje Identity nowe wystąpienie ClientFormsIdentity klasy . Właściwość ClientWindowsAuthenticationMembershipProvider inicjuje IdentityWindowsIdentity obiekt zwrócony przez metodę static
WindowsIdentity.GetCurrent() .
Zazwyczaj nie będziesz uzyskiwać bezpośredniego dostępu do tej klasy. Zwykle metoda zwracana przez właściwość jest wywoływana IsInRolestatic
IPrincipalCurrentPrincipal. Można jednak rzutować CurrentPrincipal wartość właściwości na ClientRolePrincipal odwołanie, aby jawnie wywołać IsInRole metodę, jak pokazano w sekcji Przykład.
Konstruktory
ClientRolePrincipal(IIdentity) |
Inicjuje nowe wystąpienie klasy ClientRolePrincipal. |
Właściwości
Identity |
Pobiera tożsamość zabezpieczeń skojarzona z elementem ClientRolePrincipal. |
Metody
Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
IsInRole(String) |
Pobiera wartość wskazującą, czy użytkownik reprezentowany przez element ClientRolePrincipal znajduje się w określonej roli. |
MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla