ClientRoleProvider.GetRolesForUser(String) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.ClientServices.Providers

Bütünleştirilmiş Kod:: System.Web.Extensions.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen kullanıcının ait olduğu rollerin adlarını alır.

public:
 override cli::array <System::String ^> ^ GetRolesForUser(System::String ^ username);

public override string[] GetRolesForUser (string username);

override this.GetRolesForUser : string -> string[]

Public Overrides Function GetRolesForUser (username As String) As String()

Parametreler

username: String

Rolleri alınacak kullanıcının adı.

Döndürülenler

String[]

Kullanıcının kimliği doğrulanmamışsa, dizinine ait rol adları username veya boş bir dizi.

Özel durumlar

ArgumentException

usernameveya nullşeklindedirEmpty.

-veya-

username geçerli, kimliği doğrulanmış kullanıcının kullanıcı adı değildir.

Örnekler

Aşağıdaki örnek kod, rol üyeliğini test etmeden önce kullanıcı oturum açma bilgilerinin süresinin dolup dolmadığını belirlemek için bu yöntemin nasıl kullanılacağını gösterir. Bu kod, tüm geçerli kullanıcıların bir veya daha fazla rolle ilişkilendirildiğini varsayar. Bu durumda yöntemi, GetRolesForUser oturum açma süresi dolan önceden kimliği doğrulanmış bir kullanıcı için hiçbir rol döndürmez. Kullanıcı oturum açma işleminin süresi dolduysa, bu kod oturum açma iletişim kutusunu görüntüler. Aksi takdirde, kullanıcının "yönetici" rolünde olup olmadığını belirlemek için yöntemini çağırır IsUserInRole . Kısıtlanmış kod, sağlanmayan bir PerformManagerTask yöntemdedir.

private void AttemptManagerTask()
{
    System.Security.Principal.IIdentity identity =
        System.Threading.Thread.CurrentPrincipal.Identity;

    // Return if the authentication type is not "ClientForms". 
    // This indicates that the user is logged out.
    if (!identity.AuthenticationType.Equals("ClientForms")) return;

    try
    {
        ClientRoleProvider provider =
            (ClientRoleProvider)System.Web.Security.Roles.Provider;
        String userName = identity.Name;

        // Determine whether the user login has expired by attempting
        // to retrieve roles from the service. Call the ResetCache method
        // to ensure that the roles are retrieved from the service. If no 
        // roles are returned, then the login has expired. This assumes 
        // that every valid user has been assigned to one or more roles.
        provider.ResetCache();
        String[] roles = provider.GetRolesForUser(userName);
        if (roles.Length == 0)
        {
            MessageBox.Show(
                "Your login has expired. Please log in again to access " +
                "the roles service.", "Attempting to access user roles...");

            // Call ValidateUser with empty strings in order to 
            // display the login dialog box configured as a 
            // credentials provider.
            if (!System.Web.Security.Membership.ValidateUser(
                String.Empty, String.Empty))
            {
                MessageBox.Show("Unable to authenticate. " +
                    "Cannot retrieve user roles.", "Not logged in",
                    MessageBoxButtons.OK, MessageBoxIcon.Error);
                return;
            }
        }

        if (provider.IsUserInRole(userName, "manager"))
        {
            PerformManagerTask();
        }
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show(
            "Unable to access the remote service. " +
            "Cannot retrieve user roles.", "Warning",
            MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
}

Private Sub AttemptManagerTask()

    Dim identity As System.Security.Principal.IIdentity = _
        System.Threading.Thread.CurrentPrincipal.Identity

    ' Return if the authentication type is not "ClientForms". 
    ' This indicates that the user is logged out.
    If Not identity.AuthenticationType.Equals("ClientForms") Then Return

    Try

        Dim provider As ClientRoleProvider = _
            CType(System.Web.Security.Roles.Provider, ClientRoleProvider)
        Dim userName As String = identity.Name

        ' Determine whether the user login has expired by attempting
        ' to retrieve roles from the service. Call the ResetCache method
        ' to ensure that the roles are retrieved from the service. If no 
        ' roles are returned, then the login has expired. This assumes 
        ' that every valid user has been assigned to one or more roles.
        provider.ResetCache()
        Dim roles As String() = provider.GetRolesForUser(userName)
        If roles.Length = 0 Then

            MessageBox.Show( _
                "Your login has expired. Please log in again to access " & _
                "the roles service.", "Attempting to access user roles...")

            ' Call ValidateUser with empty strings in order to 
            ' display the login dialog box configured as a 
            ' credentials provider.
            If Not System.Web.Security.Membership.ValidateUser( _
                String.Empty, String.Empty) Then

                MessageBox.Show("Unable to authenticate. " & _
                    "Cannot retrieve user roles.", "Not logged in", _
                    MessageBoxButtons.OK, MessageBoxIcon.Error)
                Return

            End If

        End If

        If provider.IsUserInRole(userName, "manager") Then
            PerformManagerTask()
        End If

    Catch ex As System.Net.WebException

        MessageBox.Show( _
            "Unable to access the remote service. " & _
            "Cannot retrieve user roles.", "Warning", _
            MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

End Sub

Açıklamalar

GetRolesForUser yöntemi geçerli, kimliği doğrulanmış kullanıcının rol bilgilerini alır ve bunu parametresinde username belirtmeniz gerekir. Kullanıcı adını özelliği aracılığıyla staticThread.CurrentPrincipal şu şekilde alabilirsiniz: Thread.CurrentPrincipal.Identity.Name.

Hizmet sağlayıcısı, gereksiz hizmet çağrılarını önlemek için yerel dosya sistemiyle ilgili rol bilgilerini önbelleğe alır. Daha fazla bilgi için bkz. sınıfa ClientRoleProvider genel bakış.

Şunlara uygulanır

Aracılığıyla paylaş