ClientRolePrincipal Klasse

  • Referenz

Definition

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

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

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 - staticThread.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 staticWindowsIdentity.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 staticCurrentPrincipal -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