FormsAuthenticationUser Kelas

Referensi

Definisi

Ruang nama:: System.Web.Configuration

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.

Mengonfigurasi kredensial pengguna untuk aplikasi Web yang menggunakan autentikasi berbasis formulir.

public ref class FormsAuthenticationUser sealed : System::Configuration::ConfigurationElement

public sealed class FormsAuthenticationUser : System.Configuration.ConfigurationElement

type FormsAuthenticationUser = class
    inherit ConfigurationElement

Public NotInheritable Class FormsAuthenticationUser
Inherits ConfigurationElement

Warisan: Object

ConfigurationElement
FormsAuthenticationUser

Contoh

Contoh kode berikut menunjukkan cara mendapatkan FormsAuthenticationUserCollection untuk mengakses FormsAuthenticationUser objek aplikasi Web yang ada. File konfigurasi akan berisi penyiapan yang mirip dengan yang berikut ini.

Catatan

Jika Anda menggunakan Elemen kredensial untuk formulir untuk autentikasi (ASP.NET Skema Pengaturan), pastikan untuk mengikuti panduan yang dijelaskan di Autentikasi ASP.NET. Untuk skalabilitas dan keamanan yang lebih baik, disarankan Anda menggunakan database eksternal untuk menyimpan kredensial pengguna. Untuk informasi selengkapnya tentang membangun aplikasi ASP.NET yang aman, lihat Mengamankan Aplikasi ASP.NET Anda dan Membangun Aplikasi ASP.NET Aman: Autentikasi, Otorisasi, dan Komunikasi Aman.

Contoh ini menggunakan SHA1. Karena masalah tabrakan dengan SHA1, Microsoft merekomendasikan SHA256.

<authentication mode="Forms">
  <forms name="MyAppCookieName" loginUrl="/login.aspx">
    defaultUrl="formsdefault.aspx"
    protection="Encryption" timeout="5" path="aspnet"
    slidingExpiration="false"
    cookieless="UseCookies" domain="domainName">
    <credentials passwordFormat="SHA1">
      <user name="aspnetuser1"
        password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
       <user name="aspnetuser2"
         password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
    </credentials>
  </forms>
</authentication>


// Get the Web application configuration.
System.Configuration.Configuration configuration = 
    WebConfigurationManager.OpenWebConfiguration(
    "/aspnet");
// Get the section.
AuthenticationSection authenticationSection = 
    (AuthenticationSection)configuration.GetSection(
    "system.web/authentication");
// Get the users collection.
FormsAuthenticationUserCollection formsAuthenticationUsers =
    authenticationSection.Forms.Credentials.Users;

' Get the Web application configuration.
  Dim configuration _
  As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnet")
' Get the section.
  Dim authenticationSection _
  As AuthenticationSection = _
  CType(configuration.GetSection( _
  "system.web/authentication"), AuthenticationSection)
' Get the users collection.
  Dim formsAuthenticationUsers _
  As FormsAuthenticationUserCollection = _
  authenticationSection.Forms.Credentials.Users

Keterangan

Kelas ini FormsAuthenticationUser menyediakan cara untuk mengakses dan memodifikasi elemen kredensial secara terprogram untuk formulir untuk bagian autentikasi dari file konfigurasi.

Jenis ini adalah bagian dari grup yang mencakup FormsAuthenticationCredentials, , FormsAuthenticationUserCollectiondan jenisnya FormsAuthenticationConfiguration . Jenis selain jenis koleksi secara langsung memengaruhi tag konfigurasi yang mendasar.

Catatan

FormsAuthenticationUser dapat menulis informasi ke bagian terkait dari file konfigurasi di tingkat komputer, situs, atau aplikasi saja. Setiap upaya untuk menulis dalam file konfigurasi pada tingkat yang berbeda dalam hierarki akan mengakibatkan pesan kesalahan yang dihasilkan oleh pengurai. Namun, Anda dapat menggunakan kelas ini untuk membaca informasi konfigurasi di tingkat mana pun dalam hierarki. Untuk keamanan dan skalabilitas, disarankan agar Anda menggunakan repositori eksternal, seperti database, untuk menyimpan kredensial pengguna.

Konstruktor

FormsAuthenticationUser(String, String)

Menginisialisasi instans FormsAuthenticationUser baru kelas menggunakan parameter yang diteruskan.

Properti

CurrentConfiguration	Mendapatkan referensi ke instans tingkat Configuration atas yang mewakili hierarki konfigurasi tempat instans saat ini ConfigurationElement berada. (Diperoleh dari ConfigurationElement)
ElementInformation	ElementInformation Mendapatkan objek yang berisi informasi dan fungsionalitas ConfigurationElement objek yang tidak dapat disesuaikan. (Diperoleh dari ConfigurationElement)
ElementProperty	ConfigurationElementProperty Mendapatkan objek yang mewakili objek itu ConfigurationElement sendiri. (Diperoleh dari ConfigurationElement)
EvaluationContext	ContextInformation Mendapatkan objek untuk ConfigurationElement objek . (Diperoleh dari ConfigurationElement)
HasContext	Mendapatkan nilai yang menunjukkan apakah CurrentConfiguration properti adalah `null`. (Diperoleh dari ConfigurationElement)
Item[ConfigurationProperty]	Mendapatkan atau mengatur properti atau atribut elemen konfigurasi ini. (Diperoleh dari ConfigurationElement)
Item[String]	Mendapatkan atau mengatur properti, atribut, atau elemen turunan dari elemen konfigurasi ini. (Diperoleh dari ConfigurationElement)
LockAllAttributesExcept	Mendapatkan koleksi atribut terkunci. (Diperoleh dari ConfigurationElement)
LockAllElementsExcept	Mendapatkan koleksi elemen terkunci. (Diperoleh dari ConfigurationElement)
LockAttributes	Mendapatkan koleksi atribut terkunci. (Diperoleh dari ConfigurationElement)
LockElements	Mendapatkan koleksi elemen terkunci. (Diperoleh dari ConfigurationElement)
LockItem	Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen dikunci. (Diperoleh dari ConfigurationElement)
Name	Mendapatkan atau mengatur nama pengguna masuk.
Password	Mendapatkan atau mengatur kata sandi pengguna.
Properties	Mendapatkan koleksi properti. (Diperoleh dari ConfigurationElement)

Metode

DeserializeElement(XmlReader, Boolean)	Membaca XML dari file konfigurasi. (Diperoleh dari ConfigurationElement)
Equals(Object)	Membandingkan instans saat ini ConfigurationElement dengan objek yang ditentukan. (Diperoleh dari ConfigurationElement)
GetHashCode()	Mendapatkan nilai unik yang mewakili instans saat ini ConfigurationElement . (Diperoleh dari ConfigurationElement)
GetTransformedAssemblyString(String)	Mengembalikan versi yang ditransformasi dari nama rakitan yang ditentukan. (Diperoleh dari ConfigurationElement)
GetTransformedTypeString(String)	Mengembalikan versi yang ditransformasi dari nama jenis yang ditentukan. (Diperoleh dari ConfigurationElement)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
Init()	Mengatur objek ke ConfigurationElement status awalnya. (Diperoleh dari ConfigurationElement)
InitializeDefault()	Digunakan untuk menginisialisasi sekumpulan nilai default untuk ConfigurationElement objek. (Diperoleh dari ConfigurationElement)
IsModified()	Menunjukkan apakah elemen konfigurasi ini telah dimodifikasi sejak terakhir disimpan atau dimuat, ketika diimplementasikan di kelas turunan. (Diperoleh dari ConfigurationElement)
IsReadOnly()	Mendapatkan nilai yang menunjukkan apakah ConfigurationElement objek bersifat baca-saja. (Diperoleh dari ConfigurationElement)
ListErrors(IList)	Menambahkan kesalahan properti yang tidak valid dalam objek ini ConfigurationElement , dan di semua subelemen, ke daftar yang diteruskan. (Diperoleh dari ConfigurationElement)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnDeserializeUnrecognizedAttribute(String, String)	Mendapatkan nilai yang menunjukkan apakah atribut yang tidak diketahui ditemui selama deserialisasi. (Diperoleh dari ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Mendapatkan nilai yang menunjukkan apakah elemen yang tidak diketahui ditemui selama deserialisasi. (Diperoleh dari ConfigurationElement)
OnRequiredPropertyNotFound(String)	Memberikan pengecualian ketika properti yang diperlukan tidak ditemukan. (Diperoleh dari ConfigurationElement)
PostDeserialize()	Dipanggil setelah deserialisasi. (Diperoleh dari ConfigurationElement)
PreSerialize(XmlWriter)	Dipanggil sebelum serialisasi. (Diperoleh dari ConfigurationElement)
Reset(ConfigurationElement)	Mereset status ConfigurationElement internal objek, termasuk kunci dan koleksi properti. (Diperoleh dari ConfigurationElement)
ResetModified()	Mengatur ulang nilai metode ke IsModified()`false` saat diimplementasikan di kelas turunan. (Diperoleh dari ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Menulis konten elemen konfigurasi ini ke file konfigurasi saat diimplementasikan di kelas turunan. (Diperoleh dari ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Menulis tag luar elemen konfigurasi ini ke file konfigurasi saat diimplementasikan di kelas turunan. (Diperoleh dari ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Mengatur properti ke nilai yang ditentukan. (Diperoleh dari ConfigurationElement)
SetReadOnly()	IsReadOnly() Mengatur properti untuk ConfigurationElement objek dan semua sublemen. (Diperoleh dari ConfigurationElement)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Memodifikasi ConfigurationElement objek untuk menghapus semua nilai yang tidak boleh disimpan. (Diperoleh dari ConfigurationElement)

Berlaku untuk

Bagikan melalui