ActiveDirectoryMembershipUser Kelas

Referensi

Definisi

Ruang nama:: System.Web.Security

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengekspos dan memperbarui informasi pengguna keanggotaan yang disimpan di penyimpanan data Direktori Aktif.

public ref class ActiveDirectoryMembershipUser : System::Web::Security::MembershipUser

[System.Serializable]
public class ActiveDirectoryMembershipUser : System.Web.Security.MembershipUser

[<System.Serializable>]
type ActiveDirectoryMembershipUser = class
    inherit MembershipUser

Public Class ActiveDirectoryMembershipUser
Inherits MembershipUser

Warisan: Object

MembershipUser
ActiveDirectoryMembershipUser

Atribut: SerializableAttribute

Contoh

Contoh kode berikut menunjukkan penggunaan properti pada ActiveDirectoryMembershipUser objek di halaman Web yang dapat mengembalikan informasi pengguna dari beberapa penyimpanan data keanggotaan. ActiveDirectoryMembershipUser Karena objek yang mendasar MembershipUser objek yang dikembalikan oleh penyedia keanggotaan tidak mengimplementasikan LastActivityDate properti dan LastLoginDate , kode terlebih dahulu memeriksa jenis objek pengguna yang dikembalikan dari penyedia keanggotaan sebelum menampilkan konten properti tersebut.


<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {
    MembershipUser user =
        Membership.GetUser();

    userName.Text = user.UserName;
    emailAddress.Text = user.Email;

    // <Snippet2>
    if (user is ActiveDirectoryMembershipUser)
    {
      lastLoginDate.Text = "Not available";
      lastActivityDate.Text = "Not available";
    }
    else
    {
      lastLoginDate.Text = user.LastLoginDate.ToShortDateString();
      lastActivityDate.Text = user.LastActivityDate.ToShortDateString();
    }
    // </Snippet2>   
    
    // <Snippet3>
    System.Security.Principal.SecurityIdentifier sidValue =
      (System.Security.Principal.SecurityIdentifier)user.ProviderUserKey;

    sid.Text = sidValue.ToString();
    // </Snippet3>
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>User information</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            User name:</td>
          <td>
            <asp:Literal ID="userName" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Email Address:</td>
          <td>
            <asp:Literal ID="emailAddress" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Login Date:</td>
          <td>
            <asp:Literal ID="lastLoginDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Activity Date:</td>
          <td>
            <asp:Literal ID="lastActivityDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Security Identifier SID:</td>
          <td>
            <asp:Literal ID="sid" runat="server" /></td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>


<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
    Dim user As MembershipUser = Membership.GetUser()
        
    userName.Text = user.UserName
    emailAddress.Text = user.Email
        
    ' <Snippet2>
    If TypeOf (user) Is ActiveDirectoryMembershipUser Then
      lastLoginDate.Text = "Not available"
      lastActivityDate.Text = "Not available"
    Else
      lastLoginDate.Text = user.LastLoginDate.ToString()
      lastActivityDate.Text = user.LastActivityDate.ToString()
    End If
    ' </Snippet2>
    
    ' <Snippet3>
    Dim sidValue As System.Security.Principal.SecurityIdentifier
    sidValue = CType(user.ProviderUserKey, System.Security.Principal.SecurityIdentifier)
    
    sid.Text = sidValue.ToString()
    ' </Snippet3>
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
  <title>User information page</title>
</head>
<body>
  <form id="form1" runat="server">
    <div>
      <table>
        <tr>
          <td>
            User name:</td>
          <td>
            <asp:Literal ID="userName" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Email Address:</td>
          <td>
            <asp:Literal ID="emailAddress" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Login Date:</td>
          <td>
            <asp:Literal ID="lastLoginDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Last Activity Date:</td>
          <td>
            <asp:Literal ID="lastActivityDate" runat="server" /></td>
        </tr>
        <tr>
          <td>
            Security Identifier SID:</td>
          <td>
            <asp:Literal ID="sid" runat="server" /></td>
        </tr>
      </table>
    </div>
  </form>
</body>
</html>

Keterangan

Objek ActiveDirectoryMembershipUser digunakan untuk mewakili satu pengguna keanggotaan di penyimpanan data keanggotaan Direktori Aktif. Ini mengekspos informasi tentang pengguna keanggotaan seperti alamat email, dan menyediakan fungsionalitas untuk pengguna keanggotaan seperti kemampuan untuk mengubah atau mengatur ulang kata sandi mereka.

Objek ActiveDirectoryMembershipUser dikembalikan oleh penyedia keanggotaan aplikasi setiap kali aplikasi dikonfigurasi untuk menggunakan penyimpanan data Direktori Aktif. Dalam aplikasi yang dapat dikonfigurasi untuk menggunakan penyimpanan data yang berbeda, atau dalam aplikasi yang menggunakan beberapa penyimpanan data, Anda dapat merujuk ke kelas dasar, MembershipUser. ActiveDirectoryMembershipUser Karena objek tidak mengimplementasikan LastActivityDate properti dan LastLoginDate , Anda harus siap untuk menangani NotSupportedException yang dilemparkan ketika anggota ini diakses pada ActiveDirectoryMembershipUser objek.

Kelas ActiveDirectoryMembershipUser menerapkan pengoptimalan internal yang digunakan oleh ActiveDirectoryMembershipProvider kelas untuk meminimalkan jumlah pembaruan atribut yang terjadi saat memanggil UpdateUser metode . Ini juga menserialisasikan SecurityIdentifier representasi (tersedia di ProviderUserKey properti) sehingga ActiveDirectoryMembershipUser objek dapat diserialisasikan dan dideserialisasi tanpa melemparkan pengecualian.

Objek ActiveDirectoryMembershipUser dikembalikan oleh GetUser metode dan CreateUser atau sebagai bagian dari yang MembershipUserCollection dikembalikan oleh GetAllUsersmetode , FindUsersByName, dan FindUsersByEmail .

Objek ActiveDirectoryMembershipUser diperlukan oleh UpdateUser metode ketika Anda ingin memperbarui informasi untuk pengguna keanggotaan yang ada.

ActiveDirectoryMembershipUser properti dipetakan ke atribut Direktori Aktif. Tabel berikut mencantumkan ActiveDirectoryMembershipUser properti dan pemetaan atribut defaultnya.

Properti	Atribut direktori default	Dapat dipetakan?
ProviderUserKey	`securityIdentifier`	Tidak
UserName	`userPrincipalName`	Ya, tetapi harus userPrincipalName atau sAMAccountName
Comment	`comment`	Tidak
CreationDate	`whenCreated`	Tidak
Email	`mail`	Ya, tetapi harus berupa atribut bernilai tunggal dari jenis Unicode String.
LastActivityDate	n/a	Tidak didukung oleh ActiveDirectoryMembershipProvider.
LastLoginDate	n/a	Tidak didukung oleh ActiveDirectoryMembershipProvider.
LastPasswordChangedDate	`pwdLastSet`	Tidak
PasswordQuestion	tidak ada, tetapi harus dipetakan ke atribut jika menggunakan keamanan tanya jawab untuk reset atau pengambilan kata sandi.	Ya, tetapi harus berupa atribut bernilai tunggal dari jenis Unicode String.
IsApproved	`User-Account-Control` (AD) `mDS-UserAccountDisabled` (ADAM)	Tidak
IsLockedOut	dihitung dari `lockoutTime` dan durasi penguncian AD (AD pada Windows 2000) `msDS-User-Account-Control-Computed` (AD di Windows Server 2003) `msDS-User-Account-Control-Computed` (ADAM)	Tidak
LastLockoutDate	Jika dikunci karena terlalu banyak upaya kata sandi yang buruk, atribut waktu penguncian dikembalikan. Jika dikunci karena terlalu banyak upaya jawaban kata sandi yang buruk, nilai yang disimpan dalam atribut yang ditentukan oleh `attributeMapFailedPasswordAnswerLockoutTime` dikembalikan. Jika dikunci karena kata sandi yang buruk dan terlalu banyak upaya kata sandi yang buruk, nilai tanggal/waktu terbaru dikembalikan. Jika akun tidak dikunci, kembalikan 1/1/1753 untuk kompatibilitas SQL.	Tidak

Konstruktor

ActiveDirectoryMembershipUser()	Menginisialisasi instans ActiveDirectoryMembershipUser baru objek untuk kelas yang mewarisi ActiveDirectoryMembershipUser kelas.
ActiveDirectoryMembershipUser(String, String, Object, String, String, String, Boolean, Boolean, DateTime, DateTime, DateTime, DateTime, DateTime)	Membuat instans ActiveDirectoryMembershipUser baru kelas dengan nilai properti yang ditentukan.

Properti

Comment	Mendapatkan atau mengatur informasi khusus aplikasi untuk pengguna keanggotaan.
CreationDate	Mendapatkan tanggal dan waktu saat pengguna ditambahkan ke penyimpanan data keanggotaan. (Diperoleh dari MembershipUser)
Email	Mendapatkan atau mengatur alamat email pengguna keanggotaan.
IsApproved	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengguna keanggotaan dapat diautentikasi.
IsLockedOut	Mendapatkan nilai yang menunjukkan apakah pengguna keanggotaan dikunci dan tidak dapat divalidasi. (Diperoleh dari MembershipUser)
IsOnline	Mendapatkan apakah pengguna saat ini sedang online. (Diperoleh dari MembershipUser)
LastActivityDate	NotSupportedException Memberikan pengecualian dalam semua kasus.
LastLockoutDate	Mendapatkan tanggal dan waktu terbaru pengguna keanggotaan dikunci. (Diperoleh dari MembershipUser)
LastLoginDate	NotSupportedException Memberikan pengecualian dalam semua kasus.
LastPasswordChangedDate	Mendapatkan tanggal dan waktu saat kata sandi pengguna keanggotaan terakhir diperbarui. (Diperoleh dari MembershipUser)
PasswordQuestion	Mendapatkan pertanyaan kata sandi untuk pengguna keanggotaan. (Diperoleh dari MembershipUser)
ProviderName	Mendapatkan nama penyedia keanggotaan yang menyimpan dan mengambil informasi pengguna untuk pengguna keanggotaan. (Diperoleh dari MembershipUser)
ProviderUserKey	Mendapatkan pengidentifikasi pengguna dari penyimpanan data Direktori Aktif untuk pengguna keanggotaan.
UserName	Mendapatkan nama masuk pengguna keanggotaan. (Diperoleh dari MembershipUser)

Metode

ChangePassword(String, String)	Memperbarui kata sandi untuk pengguna keanggotaan di penyimpanan data keanggotaan. (Diperoleh dari MembershipUser)
ChangePasswordQuestionAndAnswer(String, String, String)	Memperbarui pertanyaan dan jawaban kata sandi untuk pengguna keanggotaan di penyimpanan data keanggotaan. (Diperoleh dari MembershipUser)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetPassword()	Mendapatkan kata sandi untuk pengguna keanggotaan dari penyimpanan data keanggotaan. (Diperoleh dari MembershipUser)
GetPassword(String)	Mendapatkan kata sandi untuk pengguna keanggotaan dari penyimpanan data keanggotaan. (Diperoleh dari MembershipUser)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ResetPassword()	Mereset kata sandi pengguna ke kata sandi baru yang dibuat secara otomatis. (Diperoleh dari MembershipUser)
ResetPassword(String)	Mereset kata sandi pengguna ke kata sandi baru yang dibuat secara otomatis. (Diperoleh dari MembershipUser)
ToString()	Mengembalikan nama pengguna untuk pengguna keanggotaan. (Diperoleh dari MembershipUser)
UnlockUser()	Menghapus status pengguna yang terkunci sehingga pengguna keanggotaan dapat divalidasi. (Diperoleh dari MembershipUser)

Berlaku untuk

Lihat juga

Pengantar Keanggotaan

Bagikan melalui