FormsAuthenticationCredentials Kelas
Definisi
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 ASP.NET yang menggunakan autentikasi berbasis formulir.
public ref class FormsAuthenticationCredentials sealed : System::Configuration::ConfigurationElement
public sealed class FormsAuthenticationCredentials : System.Configuration.ConfigurationElement
type FormsAuthenticationCredentials = class
inherit ConfigurationElement
Public NotInheritable Class FormsAuthenticationCredentials
Inherits ConfigurationElement
- Warisan
Contoh
Contoh ini menunjukkan cara menentukan nilai secara deklaratif untuk beberapa atribut credentials
bagian, yang juga dapat diakses sebagai anggota FormsAuthenticationCredentials kelas.
Contoh file konfigurasi berikut menunjukkan cara menentukan nilai secara deklaratif untuk bagian tersebut credentials
.
<credentials passwordFormat="SHA1">
<user name="aspnetuser1"
password="5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8"/>
<user name="aspnetuser2"
password="E38AD214943DAAD1D64C102FAEC29DE4AFE9DA3D"/>
</credentials>
Contoh ini menggunakan SHA1. Karena masalah tabrakan dengan SHA1, Microsoft merekomendasikan SHA256.
Catatan
Jika Anda menggunakan bagian tersebut credentials
, pastikan untuk mengikuti panduan yang dijelaskan di Autentikasi ASP.NET. Untuk skalabilitas dan keamanan yang lebih baik, disarankan agar 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 kode berikut menunjukkan cara menggunakan FormsAuthenticationCredentials kelas .
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration("/aspnetTest");
// Get the authentication section.
AuthenticationSection authenticationSection =
(AuthenticationSection)configuration.GetSection(
"system.web/authentication");
// Get the forms credentials collection .
FormsAuthenticationCredentials formsAuthenticationCredentials =
authenticationSection.Forms.Credentials;
' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the authentication section.
Dim authenticationSection _
As AuthenticationSection = _
CType(configuration.GetSection( _
"system.web/authentication"), AuthenticationSection)
' Get the forms credentials collection .
Dim formsAuthenticationCredentials _
As FormsAuthenticationCredentials = _
authenticationSection.Forms.Credentials
Keterangan
Kelas FormsAuthenticationCredentials ini menyediakan cara untuk mengakses dan memodifikasi credentials
elemen forms
bagian secara terprogram di bagian authentication
file konfigurasi. Jenis ini adalah bagian dari grup yang mencakup FormsAuthenticationConfiguration, , FormsAuthenticationUserCollectiondan jenisnya FormsAuthenticationUser . Dengan pengecualian jenis koleksi, semua yang lain secara langsung memengaruhi tag konfigurasi yang mendasar.
Catatan
FormsAuthenticationCredentials dapat menulis informasi ke bagian terkait dari file konfigurasi sesuai dengan batasan yang ditentukan oleh MachineToApplication. Setiap upaya untuk menulis dalam file konfigurasi pada tingkat yang tidak diizinkan 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
FormsAuthenticationCredentials() |
Menginisialisasi instans baru kelas FormsAuthenticationCredentials. |
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 |
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) |
PasswordFormat |
Mendapatkan atau mengatur format kata sandi. |
Properties |
Mendapatkan koleksi properti. (Diperoleh dari ConfigurationElement) |
Users |
Mendapatkan nama pengguna dan kredensial kata sandi. |
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() |
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) |