Freigeben über

ClientRolePrincipal Klasse

Definition

Namespace:
System.Web.ClientServices
Assembly:
System.Web.Extensions.dll

Stellt Sicherheitsinformationen für Clientanwendungsdienste dar, die Rolleninformationen enthalten.

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
Object
ClientRolePrincipal
Implementiert
IPrincipal

Beispiele

Im folgenden Beispielcode wird veranschaulicht, wie diese Klasse verwendet wird, um eine Schaltfläche nur anzuzeigen, wenn sich der Benutzer in der Rolle "Manager" befindet. In diesem Beispiel ist ein Button Benannter managerOnlyButton mit einem anfänglichen Visible Eigenschaftswert von 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, ClientFormsAuthenticationMembershipProvider wird die ClientWindowsAuthenticationMembershipProviderstaticThread.CurrentPrincipal Eigenschaft auf eine Instanz dieser Klasse festgelegt. Die ClientFormsAuthenticationMembershipProvider Eigenschaft wird in eine neue Instanz der ClientFormsIdentity Klasse initialisiertIdentity. Die ClientWindowsAuthenticationMembershipProvider Eigenschaft wird für das WindowsIdentity von der staticWindowsIdentity.GetCurrent() Methode zurückgegebene Objekt initialisiertIdentity.

Normalerweise greifen Sie nicht direkt auf diese Klasse zu. Normalerweise rufen Sie die IsInRole Methode der IPrincipal von der staticCurrentPrincipal Eigenschaft zurückgegebenen auf. Sie können den CurrentPrincipal Eigenschaftswert jedoch in einen ClientRolePrincipal Verweis umwandeln, um die IsInRole Methode explizit aufzurufen, wie im Beispielabschnitt gezeigt.

Konstruktoren

Name Beschreibung
ClientRolePrincipal(IIdentity)

Initialisiert eine neue Instanz der ClientRolePrincipal-Klasse.

Eigenschaften

Name Beschreibung
Identity

Ruft die Sicherheitsidentität ab, die der ClientRolePrincipal.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
IsInRole(String)

Ruft einen Wert ab, der angibt, ob sich der durch die ClientRolePrincipal angegebene Rolle dargestellte Benutzer in der angegebenen Rolle befindet.
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen