ClientRolePrincipal Sınıf

Tanım

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

Devralma

Object

ClientRolePrincipal

Uygulamalar

IPrincipal

Örnekler

Aşağıdaki örnek kod, bu sınıfın yalnızca kullanıcı "yönetici" rolünde olduğunda bir düğme görüntülemek için nasıl kullanılacağını gösterir. Bu örnek, ilk Visible özellik değeri falseolan managerOnlyButton adlı bir Button gerektirir.

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

Açıklamalar

İstemci uygulama hizmetlerinde bir kullanıcıyı doğruladığınızda, ClientFormsAuthenticationMembershipProvider veya ClientWindowsAuthenticationMembershipProviderstaticThread.CurrentPrincipal özelliğini bu sınıfın bir örneğine ayarlar. ClientFormsAuthenticationMembershipProvider, Identity özelliğini ClientFormsIdentity sınıfının yeni bir örneğine başlatır. ClientWindowsAuthenticationMembershipProvider, staticWindowsIdentity.GetCurrent() yöntemi tarafından döndürülen WindowsIdentity nesnesine Identity özelliğini başlatır.

Normalde bu sınıfa doğrudan erişmezsiniz. Normalde, staticCurrentPrincipal özelliği tarafından döndürülen IPrincipalIsInRole yöntemini çağırırsınız. Ancak, Örnek bölümünde gösterildiği gibi IsInRole yöntemini açıkça çağırmak için CurrentPrincipal özellik değerini bir ClientRolePrincipal başvurusuna dönüştürebilirsiniz.

Oluşturucular

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• ClientFormsAuthenticationMembershipProvider
• ClientWindowsAuthenticationMembershipProvider
• CurrentPrincipal
• Identity
• ClientFormsIdentity
• WindowsIdentity
• IPrincipal
• IsInRole(String)
• IsInRole(String)
• İstemci Uygulama Hizmetleri