FormsAuthenticationConfiguration Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.Configuration

Bütünleştirilmiş Kod:: System.Web.dll

Ö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 AuthenticationMode kullanmak 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: Object

ConfigurationElement
FormsAuthenticationConfiguration

Örnekler

Aşağıdaki kod örneğinde, nesnenin FormsAuthenticationConfiguration var olan bir Web uygulamasının yapılandırma dosyasından nasıl alın aldığı gösterilmektedir. Ü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

FormsAuthenticationConfiguration sınıfı, bir yapılandırma authentication bölümünün öğesine program aracılığıyla erişmek ve öğeyi forms değiştirmek 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 FormsAuthenticationConfiguration MachineToApplicationolan 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 parolalar 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	Nesnenin özelleştirilebilir olmayan bilgilerini ve 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 yeniden 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 `null`olup olmadığını CurrentConfiguration gösteren bir değer alır. (Devralındığı yer: ConfigurationElement)
Item[ConfigurationProperty]	Bu yapılandırma öğesinin ö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 ilk 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 beri 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 özellik 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() `false` değerini olarak sıfırlar. (Devralındığı yer: ConfigurationElement)
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)

Şunlara uygulanır