ClientRolePrincipal Класс

Определение

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

Наследование

Object

ClientRolePrincipal

Реализации

IPrincipal

Примеры

В следующем примере кода показано, как использовать этот класс для отображения кнопки только в том случае, если пользователь находится в роли "manager". В этом примере требуется Button с именем managerOnlyButton с начальным значением свойства Visiblefalse.

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

Комментарии

При проверке пользователя в службах клиентских приложений ClientFormsAuthenticationMembershipProvider или ClientWindowsAuthenticationMembershipProvider задает свойство staticThread.CurrentPrincipal экземпляру этого класса. ClientFormsAuthenticationMembershipProvider инициализирует свойство Identity в новый экземпляр класса ClientFormsIdentity. ClientWindowsAuthenticationMembershipProvider инициализирует свойство Identity объекту WindowsIdentity, возвращаемому методом staticWindowsIdentity.GetCurrent().

Обычно доступ к этому классу не выполняется напрямую. Как правило, вы вызовете метод IsInRoleIPrincipal, возвращаемого свойством staticCurrentPrincipal. Однако значение свойства CurrentPrincipal можно привести к ссылке ClientRolePrincipal для явного вызова метода IsInRole, как показано в разделе "Пример".

Конструкторы

Свойства

Методы

Применяется к

См. также раздел

• ClientFormsAuthenticationMembershipProvider
• ClientWindowsAuthenticationMembershipProvider
• CurrentPrincipal
• Identity
• ClientFormsIdentity
• WindowsIdentity
• IPrincipal
• IsInRole(String)
• IsInRole(String)
• клиентских служб приложений