FormsAuthenticationConfiguration Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Form modalitesini kullanmak AuthenticationMode için bir ASP.NET uygulaması yapılandırılır.
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
- Devralma
Örnekler
Aşağıdaki kod örneği, nesnenin FormsAuthenticationConfiguration var olan bir Web uygulamasının yapılandırma dosyasından nasıl alınacaklarını gösterir. Üyelerine erişmek için bu nesneyi kullanabilirsiniz. Yapılandırma dosyası aşağıdakine benzer bir kurulum içerir.
Not bölümünü kullanıyorsanız credentials
ASP.NET Kimlik Doğrulaması bölümünde açıklanan yönergeleri izlediğinize emin olun. Ölçeklenebilirlik ve daha iyi güvenlik için, kullanıcıların kimlik bilgilerini depolamak için bir dış veritabanı kullanmanız önerilir. Güvenli ASP.NET uygulamaları oluşturma hakkında daha fazla bilgi için bkz . ASP.NET Uygulamanızın Güvenliğini Sağlama ve Güvenli ASP.NET Uygulamaları Oluşturma: Kimlik Doğrulaması, Yetkilendirme ve Güvenli İletişim.
Bu örnekte SHA1 kullanılır. SHA1 ile ilgili çakışma sorunları nedeniyle Microsoft SHA256'yı önerir.
<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
Açıklamalar
sınıfı, FormsAuthenticationConfiguration bir yapılandırma authentication
bölümünün öğesine program aracılığıyla erişmek ve bunları değiştirmek forms
için bir yol sağlar.
Bu tür, , FormsAuthenticationUserCollectionve FormsAuthenticationUser türlerini içeren FormsAuthenticationCredentialsbir grubun parçasıdır. Koleksiyon türü dışındaki türler, temel yapılandırma etiketlerini doğrudan etkiler.
Not
değeri FormsAuthenticationConfigurationMachineToApplicationolan bölüm özelliği AllowDefinition tarafından tanımlanan kısıtlamalara göre yapılandırma dosyasının ilgili bölümüne bilgi yazabilir. Hiyerarşide izin verilmeyen bir düzeyde bir yapılandırma dosyasına yazma girişimi ayrıştırıcı tarafından oluşturulan bir hata iletisine neden olur. Ancak, hiyerarşideki herhangi bir düzeyde yapılandırma bilgilerini okumak için bu sınıfı kullanabilirsiniz. Güvenlik ve ölçeklenebilirlik için, kullanıcıların kimlik bilgilerini korumak için veritabanı gibi bir dış depo kullanmanız önerilir.
Oluşturucular
FormsAuthenticationConfiguration() |
FormsAuthenticationConfiguration sınıfının yeni bir örneğini başlatır. |
Özellikler
Cookieless |
Form tabanlı kimlik doğrulamasının tanımlama bilgileri kullanıp kullanmayacağını belirten bir değer alır veya ayarlar. |
CookieSameSite |
Tanımlama bilgisinin SameSite özniteliğinin değerini alır veya ayarlar. |
Credentials |
FormsAuthenticationCredentials Kullanıcı adları ve parola koleksiyonunu alır. |
CurrentConfiguration |
Geçerli ConfigurationElement örneğin ait olduğu yapılandırma hiyerarşisini temsil eden en üst düzey Configuration örneğe başvuru alır. (Devralındığı yer: ConfigurationElement) |
DefaultUrl |
Varsayılan URL'yi alır veya ayarlar. |
Domain |
Form kimlik doğrulama tanımlama bilgileriyle gönderilecek etki alanı adını alır veya ayarlar. |
ElementInformation |
Özelleştirilebilir olmayan bilgileri ve nesnenin işlevselliğini ConfigurationElement içeren bir ElementInformation nesnesi alır. (Devralındığı yer: ConfigurationElement) |
ElementProperty |
Nesnenin ConfigurationElementProperty kendisini temsil ConfigurationElement eden nesneyi alır. (Devralındığı yer: ConfigurationElement) |
EnableCrossAppRedirects |
Kimliği doğrulanmış kullanıcıların diğer uygulamalarda URL'lere yönlendirilip yönlendirilemeyeceğini belirten bir değer alır veya ayarlar. |
EvaluationContext |
Nesnenin ContextInformation nesnesini ConfigurationElement alır. (Devralındığı yer: ConfigurationElement) |
HasContext |
özelliğinin |
Item[ConfigurationProperty] |
Bu yapılandırma öğesinin bir özelliğini veya özniteliğini alır veya ayarlar. (Devralındığı yer: ConfigurationElement) |
Item[String] |
Bu yapılandırma öğesinin bir özelliğini, özniteliğini veya alt öğesini alır veya ayarlar. (Devralındığı yer: ConfigurationElement) |
LockAllAttributesExcept |
Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
LockAllElementsExcept |
Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
LockAttributes |
Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
LockElements |
Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
LockItem |
Öğesinin kilitli olup olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: ConfigurationElement) |
LoginUrl |
İsteğin yeniden yönlendirme URL'sini alır veya ayarlar. |
Name |
Tanımlama bilgisi adını alır veya ayarlar. |
Path |
Tanımlama bilgisi yolunu alır veya ayarlar. |
Properties |
Özellik koleksiyonunu alır. (Devralındığı yer: ConfigurationElement) |
Protection |
Tanımlama bilgisini şifrelemek için kullanılan şifreleme türünü alır veya ayarlar. |
RequireSSL |
Kimlik doğrulama bilgilerini aktarırken Güvenli Yuva Katmanı (SSL) bağlantısı gerekip gerekmediğini belirten bir değer alır veya ayarlar. |
SlidingExpiration |
Kimlik doğrulaması kayan süre sonunu alır veya ayarlar. |
TicketCompatibilityMode |
Biletin son kullanma tarihi için Eşgüdümlü Evrensel Saat (UTC) veya yerel saat kullanılıp kullanılmayacağını belirten bir değer alır veya ayarlar. |
Timeout |
Kimlik doğrulama zaman aşımını alır veya ayarlar. |
Yöntemler
DeserializeElement(XmlReader, Boolean) |
Yapılandırma dosyasından XML okur. (Devralındığı yer: ConfigurationElement) |
Equals(Object) |
Geçerli ConfigurationElement örneği belirtilen nesneyle karşılaştırır. (Devralındığı yer: ConfigurationElement) |
GetHashCode() |
Geçerli ConfigurationElement örneği temsil eden benzersiz bir değer alır. (Devralındığı yer: ConfigurationElement) |
GetTransformedAssemblyString(String) |
Belirtilen derleme adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement) |
GetTransformedTypeString(String) |
Belirtilen tür adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement) |
GetType() |
Type Geçerli örneğini alır. (Devralındığı yer: Object) |
Init() |
ConfigurationElement Nesneyi başlangıç durumuna ayarlar. (Devralındığı yer: ConfigurationElement) |
InitializeDefault() |
Nesne için varsayılan değer kümesini başlatmak için ConfigurationElement kullanılır. (Devralındığı yer: ConfigurationElement) |
IsModified() |
Bu yapılandırma öğesinin türetilmiş bir sınıfta uygulandığında son kaydedildiğinden veya yüklendiğinden bu yana değiştirilip değiştirilmediğini gösterir. (Devralındığı yer: ConfigurationElement) |
IsReadOnly() |
Nesnenin ConfigurationElement salt okunur olup olmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement) |
ListErrors(IList) |
Bu ConfigurationElement nesnedeki ve tüm alt öğelerdeki invalid-property hatalarını geçirilen listeye ekler. (Devralındığı yer: ConfigurationElement) |
MemberwiseClone() |
Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object) |
OnDeserializeUnrecognizedAttribute(String, String) |
Seri durumdan çıkarma sırasında bilinmeyen bir öznitelikle karşılaşılıp karşılaşılmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement) |
OnDeserializeUnrecognizedElement(String, XmlReader) |
Seri durumdan çıkarma sırasında bilinmeyen bir öğeyle karşılaşılıp karşılaşılmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement) |
OnRequiredPropertyNotFound(String) |
Gerekli bir özellik bulunamadığında bir özel durum oluşturur. (Devralındığı yer: ConfigurationElement) |
PostDeserialize() |
Seri durumdan çıkarıldıktan sonra çağrılır. (Devralındığı yer: ConfigurationElement) |
PreSerialize(XmlWriter) |
Serileştirmeden önce çağrılır. (Devralındığı yer: ConfigurationElement) |
Reset(ConfigurationElement) |
Kilitler ve özellikler koleksiyonları dahil olmak üzere nesnenin iç durumunu ConfigurationElement sıfırlar. (Devralındığı yer: ConfigurationElement) |
ResetModified() |
Türetilmiş bir sınıfta uygulandığında yönteminin IsModified() |
SerializeElement(XmlWriter, Boolean) |
Türetilmiş bir sınıfta uygulandığında bu yapılandırma öğesinin içeriğini yapılandırma dosyasına yazar. (Devralındığı yer: ConfigurationElement) |
SerializeToXmlElement(XmlWriter, String) |
Türetilmiş bir sınıfta uygulandığında bu yapılandırma öğesinin dış etiketlerini yapılandırma dosyasına yazar. (Devralındığı yer: ConfigurationElement) |
SetPropertyValue(ConfigurationProperty, Object, Boolean) |
Belirtilen değere bir özellik ayarlar. (Devralındığı yer: ConfigurationElement) |
SetReadOnly() |
Nesnesinin IsReadOnly() ve tüm alt öğelerinin ConfigurationElement özelliğini ayarlar. (Devralındığı yer: ConfigurationElement) |
ToString() |
Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object) |
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode) |
ConfigurationElement Kaydedilmemesi gereken tüm değerleri kaldırmak için nesnesini değiştirir. (Devralındığı yer: ConfigurationElement) |