ClientRolePrincipal Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente des informations de sécurité pour les services d'application cliente, qui incluent des informations de rôle.
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
- Héritage
-
ClientRolePrincipal
- Implémente
Exemples
L’exemple de code suivant montre comment utiliser cette classe pour afficher un bouton uniquement lorsque l’utilisateur est dans le rôle « manager ». Cet exemple nécessite un Button nommé managerOnlyButton
avec une valeur de propriété initiale Visible de false
.
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
Remarques
Lorsque vous validez un utilisateur dans les services d’application client, le ClientFormsAuthenticationMembershipProvider ou ClientWindowsAuthenticationMembershipProvider définit la static
Thread.CurrentPrincipal propriété sur une instance de cette classe. ClientFormsAuthenticationMembershipProvider initialise la Identity propriété dans une nouvelle instance de la ClientFormsIdentity classe . initialise ClientWindowsAuthenticationMembershipProvider la Identity propriété sur l’objet WindowsIdentity retourné par la static
WindowsIdentity.GetCurrent() méthode .
En règle générale, vous n’accéderez pas directement à cette classe. Normalement, vous appelez la IsInRole méthode du IPrincipal retourné par la static
CurrentPrincipal propriété . Toutefois, vous pouvez convertir la valeur de la CurrentPrincipal propriété en référence ClientRolePrincipal pour appeler explicitement la IsInRole méthode, comme illustré dans la section Exemple.
Constructeurs
ClientRolePrincipal(IIdentity) |
Initialise une nouvelle instance de la classe ClientRolePrincipal. |
Propriétés
Identity |
Obtient l'identité de sécurité associée au ClientRolePrincipal. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
IsInRole(String) |
Obtient une valeur indiquant si l'utilisateur représenté par le ClientRolePrincipal figure dans le rôle spécifié. |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
S’applique à
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour