ClientRolePrincipal Klasse

Referenz

Definition

Namespace:: System.Web.ClientServices

Assembly:: System.Web.Extensions.dll

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: Object
ClientRolePrincipal

Implementiert: IPrincipal

Beispiele

Der folgende Beispielcode veranschaulicht, wie diese Klasse zum Anzeigen einer Schaltfläche nur dann verwendet wird, wenn sich der Benutzer in der Rolle "Manager" befindet. In diesem 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 der ClientFormsAuthenticationMembershipProvider oder ClientWindowsAuthenticationMembershipProvider die - 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 von der WindowsIdentitystaticWindowsIdentity.GetCurrent() -Methode zurückgegebene Objekt.

Sie greifen in der Regel nicht direkt auf diese Klasse zu. Normalerweise rufen Sie die Methode des IPrincipal von der -Eigenschaft zurückgegebenen aufstaticCurrentPrincipal.IsInRole 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:

Freigeben über