FormsAuthenticationConfiguration 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 aplikasi ASP.NET untuk menggunakan AuthenticationMode modalitas formulir.

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 FormsAuthenticationConfiguration objek dari file konfigurasi aplikasi Web yang ada. Anda dapat menggunakan objek ini untuk mengakses anggotanya. File konfigurasi akan berisi penyiapan yang mirip dengan yang berikut ini.

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 ini menggunakan SHA1. Karena masalah tabrakan dengan SHA1, Microsoft merekomendasikan SHA256.

<authentication mode="Forms">
  <forms name="MyAppCookie" loginUrl="login.aspx"
    defaultUrl="default.aspx"
    protection="Encryption" timeout="5" path="aspnetTest"
    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("/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 ini FormsAuthenticationConfiguration menyediakan cara untuk mengakses dan memodifikasi forms elemen bagian konfigurasi authentication secara terprogram.

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

Catatan

FormsAuthenticationConfiguration dapat menulis informasi ke bagian terkait dari file konfigurasi sesuai dengan batasan yang ditentukan oleh properti AllowDefinition bagian yang nilainya adalah 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

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	FormsAuthenticationCredentials Mendapatkan kumpulan nama pengguna dan kata sandi.
CurrentConfiguration	Mendapatkan referensi ke instans tingkat Configuration atas yang mewakili hierarki konfigurasi tempat instans saat ini ConfigurationElement berada. (Diperoleh dari ConfigurationElement)
DefaultUrl	Mendapatkan atau mengatur URL default.
Domain	Mendapatkan atau mengatur nama domain yang akan dikirim dengan cookie autentikasi formulir.
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)
EnableCrossAppRedirects	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengguna yang diautentikasi dapat dialihkan ke URL di aplikasi lain.
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)
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 setempat untuk tanggal kedaluwarsa tiket.
Timeout	Mendapatkan atau mengatur waktu habis autentikasi.

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