FormsAuthenticationConfiguration Kelas

Definisi

Ruang nama:

System.Web.Configuration

Rakitan:

System.Web.dll

Mengonfigurasi aplikasi ASP.NET untuk menggunakan modalitas formulir AuthenticationMode.

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

public sealed class FormsAuthenticationConfiguration : System.Configuration.ConfigurationElement

type FormsAuthenticationConfiguration = class
    inherit ConfigurationElement

Public NotInheritable Class FormsAuthenticationConfiguration
Inherits ConfigurationElement

Warisan

Object

ConfigurationElement

FormsAuthenticationConfiguration

Contoh

Contoh kode berikut menunjukkan cara mendapatkan objek FormsAuthenticationConfiguration dari file konfigurasi aplikasi Web yang ada. Anda dapat menggunakan objek ini untuk mengakses anggotanya.

// Get the Web application configuration.
System.Configuration.Configuration configuration =
    WebConfigurationManager.OpenWebConfiguration("/aspnetTest");

// Get the external Authentication section.
AuthenticationSection authenticationSection =
    (AuthenticationSection)configuration.GetSection(
    "system.web/authentication");

// Get the external Forms section .
FormsAuthenticationConfiguration formsAuthentication =
    authenticationSection.Forms;

' Get the Web application configuration.
Dim configuration As System.Configuration.Configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest")

' Get the external Authentication section.
Dim authenticationSection _
As AuthenticationSection =
CType(configuration.GetSection(
"system.web/authentication"), AuthenticationSection)

' Get the external Forms section .
Dim formsAuthentication _
As FormsAuthenticationConfiguration =
authenticationSection.Forms

Keterangan

Kelas FormsAuthenticationConfiguration menyediakan cara untuk mengakses dan memodifikasi elemen forms bagian authentication konfigurasi secara terprogram.

Jenis ini adalah bagian dari grup yang menyertakan FormsAuthenticationCredentials, FormsAuthenticationUserCollection, dan jenis FormsAuthenticationUser. Jenis selain jenis koleksi secara langsung memengaruhi tag konfigurasi yang mendasar.

Peringatan

Menyimpan kredensial pengguna di bagian credentialstidak aman. Sebagai gantinya, gunakan Azure Key Vault.

Nota

FormsAuthenticationConfiguration dapat menulis informasi ke bagian terkait dari file konfigurasi sesuai dengan batasan yang ditentukan oleh properti bagian AllowDefinition yang nilainya 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 Azure Key Vault untuk menyimpan kredensial pengguna.

Konstruktor

FormsAuthenticationConfiguration()

Menginisialisasi instans baru kelas FormsAuthenticationConfiguration.

Properti

Cookieless	Mendapatkan atau menetapkan nilai yang menunjukkan apakah autentikasi berbasis formulir harus menggunakan cookie.
CookieSameSite	Mendapatkan atau menetapkan nilai untuk atribut SameSite cookie.
Credentials	Mendapatkan kumpulan FormsAuthenticationCredentials nama pengguna dan kata sandi.
CurrentConfiguration	Mendapatkan referensi ke instans Configuration tingkat atas yang mewakili hierarki konfigurasi tempat instans ConfigurationElement saat ini berada. (Diperoleh dari ConfigurationElement)
DefaultUrl	Mendapatkan atau mengatur URL default.
Domain	Mendapatkan atau mengatur nama domain yang akan dikirim dengan cookie autentikasi formulir.
ElementInformation	Mendapatkan objek ElementInformation yang berisi informasi dan fungsionalitas yang tidak dapat disesuaikan dari objek ConfigurationElement. (Diperoleh dari ConfigurationElement)
ElementProperty	Mendapatkan objek ConfigurationElementProperty yang mewakili objek ConfigurationElement itu sendiri. (Diperoleh dari ConfigurationElement)
EnableCrossAppRedirects	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengguna yang diautentikasi dapat dialihkan ke URL di aplikasi lain.
EvaluationContext	Mendapatkan objek ContextInformation untuk objek ConfigurationElement. (Diperoleh dari ConfigurationElement)
HasContext	Mendapatkan nilai yang menunjukkan apakah properti CurrentConfigurationnull. (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)
LoginUrl	Mendapatkan atau mengatur URL pengalihan untuk permintaan tersebut.
Name	Mendapatkan atau mengatur nama cookie.
Path	Mendapatkan atau mengatur jalur cookie.
Properties	Mendapatkan koleksi properti. (Diperoleh dari ConfigurationElement)
Protection	Mendapatkan atau mengatur jenis enkripsi yang digunakan untuk mengenkripsi cookie.
RequireSSL	Mendapatkan atau menetapkan nilai yang menunjukkan apakah koneksi Secure Sockets Layer (SSL) diperlukan saat mengirimkan informasi autentikasi.
SlidingExpiration	Mendapatkan atau mengatur kedaluwarsa geser autentikasi.
TicketCompatibilityMode	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menggunakan Waktu Universal Terkoordinasi (UTC) atau waktu lokal untuk tanggal kedaluwarsa tiket.
Timeout	Mendapatkan atau mengatur batas waktu autentikasi.

Metode

DeserializeElement(XmlReader, Boolean)	Membaca XML dari file konfigurasi. (Diperoleh dari ConfigurationElement)
Equals(Object)	Membandingkan instans ConfigurationElement saat ini dengan objek yang ditentukan. (Diperoleh dari ConfigurationElement)
GetHashCode()	Mendapatkan nilai unik yang mewakili instans ConfigurationElement saat ini. (Diperoleh dari ConfigurationElement)
GetTransformedAssemblyString(String)	Mengembalikan versi yang diubah dari nama rakitan yang ditentukan. (Diperoleh dari ConfigurationElement)
GetTransformedTypeString(String)	Mengembalikan versi yang diubah dari nama jenis yang ditentukan. (Diperoleh dari ConfigurationElement)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
Init()	Mengatur objek ConfigurationElement ke status awalnya. (Diperoleh dari ConfigurationElement)
InitializeDefault()	Digunakan untuk menginisialisasi sekumpulan nilai default untuk objek ConfigurationElement. (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 objek ConfigurationElement bersifat baca-saja. (Diperoleh dari ConfigurationElement)
ListErrors(IList)	Menambahkan kesalahan properti yang tidak valid dalam objek ConfigurationElement ini, dan di semua subelemen, ke daftar yang diteruskan. (Diperoleh dari ConfigurationElement)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (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)	Melempar 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 internal objek ConfigurationElement, termasuk kunci dan koleksi properti. (Diperoleh dari ConfigurationElement)
ResetModified()	Mengatur ulang nilai metode IsModified() ke false saat diimplementasikan dalam 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()	Mengatur properti IsReadOnly() untuk objek ConfigurationElement dan semua subelemen. (Diperoleh dari ConfigurationElement)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Memodifikasi objek ConfigurationElement untuk menghapus semua nilai yang tidak boleh disimpan. (Diperoleh dari ConfigurationElement)