Bagikan melalui

ClientRolePrincipal Kelas

  • Referensi

Definisi

Ruang nama:
System.Web.ClientServices
Rakitan:
System.Web.Extensions.dll

Mewakili informasi keamanan untuk layanan aplikasi klien, yang mencakup informasi peran.

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
Warisan
Object
ClientRolePrincipal
Penerapan
IPrincipal

Contoh

Contoh kode berikut menunjukkan cara menggunakan kelas ini untuk menampilkan tombol hanya ketika pengguna berada dalam peran "manajer". Contoh ini memerlukan Button bernama managerOnlyButton dengan nilai properti awal 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

Keterangan

Saat Anda memvalidasi pengguna dalam layanan aplikasi klien, ClientFormsAuthenticationMembershipProvider atau ClientWindowsAuthenticationMembershipProvider mengatur properti staticThread.CurrentPrincipal ke instans kelas ini. ClientFormsAuthenticationMembershipProvider menginisialisasi properti Identity ke instans baru kelas ClientFormsIdentity. ClientWindowsAuthenticationMembershipProvider menginisialisasi properti Identity ke objek WindowsIdentity yang dikembalikan oleh metode staticWindowsIdentity.GetCurrent().

Anda biasanya tidak akan mengakses kelas ini secara langsung. Biasanya, Anda akan memanggil metode IsInRole dari IPrincipal yang dikembalikan oleh properti staticCurrentPrincipal. Namun, Anda dapat mentransmisikan nilai properti CurrentPrincipal ke referensi ClientRolePrincipal untuk memanggil metode IsInRole secara eksplisit, seperti yang ditunjukkan di bagian Contoh.

Konstruktor

ClientRolePrincipal(IIdentity)

Menginisialisasi instans baru kelas ClientRolePrincipal.

Properti

Identity

Mendapatkan identitas keamanan yang terkait dengan ClientRolePrincipal.

Metode

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
IsInRole(String)

Mendapatkan nilai yang menunjukkan apakah pengguna yang diwakili oleh ClientRolePrincipal berada dalam peran yang ditentukan.
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Berlaku untuk

Lihat juga