ClientRolePrincipal Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Sicherheitsinformationen für Clientanwendungsdienste mit Rolleninformationen dar.
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
- Vererbung
-
ClientRolePrincipal
- Implementiert
Beispiele
Der folgende Beispielcode veranschaulicht, wie diese Klasse verwendet wird, um eine Schaltfläche nur dann anzuzeigen, wenn der Benutzer die Rolle "Manager" hat. Für dieses Beispiel ist ein Button benannter managerOnlyButton
mit dem anfänglichen Visible Eigenschaftswert erforderlich 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
Hinweise
Wenn Sie einen Benutzer in Clientanwendungsdiensten überprüfen, legt oder ClientFormsAuthenticationMembershipProvider die ClientWindowsAuthenticationMembershipProvider - static
Thread.CurrentPrincipal Eigenschaft auf eine Instanz dieser Klasse fest. Initialisiert ClientFormsAuthenticationMembershipProvider die Identity -Eigenschaft in einer neuen Instanz der ClientFormsIdentity -Klasse. Initialisiert ClientWindowsAuthenticationMembershipProvider die Identity -Eigenschaft für das -Objekt, das WindowsIdentity von der static
WindowsIdentity.GetCurrent() -Methode zurückgegeben wird.
Sie greifen in der Regel nicht direkt auf diese Klasse zu. Normalerweise rufen Sie die IsInRole -Methode der auf, die IPrincipal von der static
CurrentPrincipal -Eigenschaft zurückgegeben wird. Sie können den CurrentPrincipal Eigenschaftswert jedoch in einen ClientRolePrincipal Verweis umwandeln, um die IsInRole -Methode explizit aufzurufen, wie im Abschnitt Beispiel veranschaulicht.
Konstruktoren
ClientRolePrincipal(IIdentity) |
Initialisiert eine neue Instanz der ClientRolePrincipal-Klasse. |
Eigenschaften
Identity |
Ruft die Sicherheitsidentität ab, die mit dem ClientRolePrincipal verknüpft ist. |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
IsInRole(String) |
Ruft einen Wert ab, der angibt, ob der durch ClientRolePrincipal dargestellte Benutzer die angegebene Rolle innehat. |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für