ClientRolePrincipal Klas

Definitie

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

Vertegenwoordigt beveiligingsgegevens voor clienttoepassingsservices, waaronder rolgegevens.

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
Overname
Object
ClientRolePrincipal
Implementeringen
IPrincipal

Voorbeelden

In de volgende voorbeeldcode ziet u hoe u deze klasse gebruikt om alleen een knop weer te geven wanneer de gebruiker de rol Manager heeft. Voor dit voorbeeld is een Button benoemde managerOnlyButton met een initiële Visible eigenschapswaarde van falsevereist.

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

Opmerkingen

Wanneer u een gebruiker in clienttoepassingsservices valideert, wordt de ClientFormsAuthenticationMembershipProviderClientWindowsAuthenticationMembershipProviderstatic eigenschap ingesteld Thread.CurrentPrincipal op een exemplaar van deze klasse. De ClientFormsAuthenticationMembershipProvider eigenschap wordt geïnitialiseerd Identity naar een nieuw exemplaar van de ClientFormsIdentity klasse. De ClientWindowsAuthenticationMembershipProvider eigenschap wordt geïnitialiseerd Identity naar het WindowsIdentity object dat door de staticWindowsIdentity.GetCurrent() methode wordt geretourneerd.

Deze klasse wordt doorgaans niet rechtstreeks geopend. Normaal gesproken roept u de IsInRole methode aan van de IPrincipal geretourneerde staticCurrentPrincipal eigenschap. U kunt de CurrentPrincipal eigenschapswaarde echter expliciet casten naar een ClientRolePrincipal verwijzing om de IsInRole methode aan te roepen, zoals wordt weergegeven in de sectie Voorbeeld.

Constructors

Name Description
ClientRolePrincipal(IIdentity)

Initialiseert een nieuw exemplaar van de ClientRolePrincipal klasse.

Eigenschappen

Name Description
Identity

Hiermee haalt u de beveiligingsidentiteit op die is gekoppeld aan de ClientRolePrincipal.

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
IsInRole(String)

Hiermee wordt een waarde opgehaald die aangeeft of de gebruiker die wordt vertegenwoordigd door de ClientRolePrincipal opgegeven rol heeft.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook