Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

AuthenticationSection-Klasse

Konfiguriert die Authentifizierung für eine Webanwendung. Diese Klasse kann nicht vererbt werden.

Namespace:  System.Web.Configuration
Assembly:  System.Web (in System.Web.dll)
public sealed class AuthenticationSection : ConfigurationSection

Der AuthenticationSection-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeAuthenticationSectionInfrastruktur. Initialisiert eine neue Instanz der AuthenticationSection-Klasse.
Zum Seitenanfang
  NameBeschreibung
Öffentliche EigenschaftCurrentConfigurationRuft einen Verweis auf die Configuration-Instanz der obersten Ebene ab, die die Konfigurationshierarchie darstellt, zu der die aktuelle ConfigurationElement-Instanz gehört. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftElementInformationRuft ein ElementInformation-Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationElement-Objekts enthält. (Von ConfigurationElement geerbt.)
Geschützte EigenschaftElementPropertyRuft das ConfigurationElementProperty-Objekt ab, das das ConfigurationElement-Objekt selbst darstellt. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftFormsRuft die Forms-Elementeigenschaft ab.
Geschützte EigenschaftItem[ConfigurationProperty]Ruft eine Eigenschaft oder ein Attribut dieses Konfigurationselements ab oder legt diese bzw. dieses fest. (Von ConfigurationElement geerbt.)
Geschützte EigenschaftItem[String]Ruft eine Eigenschaft, ein Attribut oder ein untergeordnetes Element dieses Konfigurationselements ab oder legt diese(s) fest. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftLockAllAttributesExceptRuft die Auflistung gesperrter Attribute ab. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftLockAllElementsExceptRuft die Auflistung gesperrter Elemente ab. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftLockAttributesRuft die Auflistung gesperrter Attribute ab. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftLockElementsRuft die Auflistung gesperrter Elemente ab. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftLockItemRuft einen Wert ab, der angibt, ob das Element gesperrt ist, oder legt diesen fest. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftModeRuft das Authentifizierungsverhalten ab oder legt dieses fest.
Öffentliche EigenschaftPassport Veraltet. Ruft die Passport-Elementeigenschaft ab.
Geschützte EigenschaftPropertiesRuft die Auflistung von Eigenschaften ab. (Von ConfigurationElement geerbt.)
Öffentliche EigenschaftSectionInformationRuft ein SectionInformation-Objekt ab, das die nicht anpassbaren Informationen und Funktionen des ConfigurationSection-Objekts enthält. (Von ConfigurationSection geerbt.)
Zum Seitenanfang
  NameBeschreibung
Geschützte MethodeDeserializeElementLiest XML aus der Konfigurationsdatei. (Von ConfigurationElement geerbt.)
Geschützte MethodeDeserializeSectionInfrastruktur. Liest XML aus der Konfigurationsdatei. (Von ConfigurationSection geerbt.)
Öffentliche MethodeEqualsVergleicht die aktuelle ConfigurationElement-Instanz mit dem angegebenen Objekt. (Von ConfigurationElement geerbt.)
Öffentliche MethodeGetHashCodeRuft einen eindeutigen Wert ab, der die aktuelle ConfigurationElement-Instanz darstellt. (Von ConfigurationElement geerbt.)
Geschützte MethodeGetRuntimeObjectGibt ein benutzerdefiniertes Objekt zurück, wenn es in einer abgeleiteten Klasse überschrieben wird. (Von ConfigurationSection geerbt.)
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte MethodeInitLegt für das ConfigurationElement-Objekt den Ausgangszustand fest. (Von ConfigurationElement geerbt.)
Geschützte MethodeInitializeDefaultWird verwendet, um einen Standardsatz von Werten für das ConfigurationElement-Objekt zu initialisieren. (Von ConfigurationElement geerbt.)
Geschützte MethodeIsModifiedGibt an, ob dieses Konfigurationselement geändert wurde, seit es zuletzt gespeichert oder geladen wurde, wenn es in einer abgeleiteten Klasse implementiert wurde. (Von ConfigurationSection geerbt.)
Öffentliche MethodeIsReadOnlyRuft einen Wert ab, der angibt, ob das ConfigurationElement-Objekt schreibgeschützt ist. (Von ConfigurationElement geerbt.)
Geschützte MethodeResetSetzt den internen Zustand des ConfigurationElement-Objekts zurück, einschließlich der Sperren und der Eigenschaftenauflistungen. (Von ConfigurationElement geerbt.)
Geschützte MethodeResetModifiedSetzt bei Implementierung in einer abgeleiteten Klasse den Wert der IsModified-Methode auf false zurück. (Von ConfigurationSection geerbt.)
Geschützte MethodeSerializeElementSchreibt bei Implementierung in einer abgeleiteten Klasse den Inhalt dieses Konfigurationselements in die Konfigurationsdatei. (Von ConfigurationElement geerbt.)
Geschützte MethodeSerializeSectionInfrastruktur. Erstellt eine XML-Zeichenfolge mit einer nicht zusammengeführten Ansicht des ConfigurationSection-Objekts als einzelnem Abschnitt, der in einer Datei geschrieben werden soll. (Von ConfigurationSection geerbt.)
Geschützte MethodeSerializeToXmlElementSchreibt bei Implementierung in einer abgeleiteten Klasse die äußeren Tags dieses Konfigurationselements in die Konfigurationsdatei. (Von ConfigurationElement geerbt.)
Geschützte MethodeSetReadOnlyLegt die IsReadOnly-Eigenschaft für das ConfigurationElement-Objekt und alle Unterelemente fest. (Von ConfigurationElement geerbt.)
Geschützte MethodeShouldSerializeElementInTargetVersionGibt an, ob das angegebene Element serialisiert werden soll, wenn die Konfigurationsobjekthierarchie für die angegebene Zielversion von .NET Framework serialisiert wird. (Von ConfigurationSection geerbt.)
Geschützte MethodeShouldSerializePropertyInTargetVersionGibt an, ob die angegebene Eigenschaft serialisiert werden soll, wenn die Konfigurationsobjekthierarchie für die angegebene Zielversion von .NET Framework serialisiert wird. (Von ConfigurationSection geerbt.)
Geschützte MethodeShouldSerializeSectionInTargetVersionGibt an, ob die aktuelle ConfigurationSection-Instanz serialisiert werden soll, wenn die Konfigurationsobjekthierarchie für die angegebene Zielversion von .NET Framework serialisiert wird. (Von ConfigurationSection geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Geschützte MethodeUnmergeÄndert das ConfigurationElement-Objekt, um alle Werte zu entfernen, die nicht gespeichert werden sollen. (Von ConfigurationElement geerbt.)
Zum Seitenanfang

Die AuthenticationSection-Klasse ermöglicht den programmgesteuerten Zugriff auf den authentication-Abschnitt einer Konfigurationsdatei und dessen programmgesteuerte Änderung.

HinweisHinweis

AuthenticationSection kann Informationen in den entsprechenden Abschnitt der Konfigurationsdatei schreiben, wobei die durch die Abschnittseigenschaft AllowDefinition mit dem Wert MachineToApplication definierten Einschränkungen berücksichtigt werden. Beim Versuch, auf einer Ebene, die in der Hierarchie nicht zulässig ist, in eine Konfigurationsdatei zu schreiben, wird vom Parser eine Fehlermeldung generiert. Sie können diese Klasse jedoch zum Lesen von Konfigurationsinformationen auf einer beliebigen Hierarchieebene verwenden. Aus Gründen der Sicherheit und Skalierbarkeit wird empfohlen, zur Speicherung der Benutzeranmeldeinformationen ein externes Repository, z. B. eine Datenbank, zu verwenden.

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Beispiel wird veranschaulicht, wie Sie deklarativ für mehrere Attribute des authentication-Abschnitts Werte angeben, auf die auch als Member der AuthenticationSection-Klasse zugegriffen werden kann. Im zweiten Beispiel wird die Verwendung der AuthenticationSection-Klasse veranschaulicht.

Im folgenden Beispiel für eine Konfigurationsdatei wird veranschaulicht, wie Sie deklarativ Werte für den authentication-Abschnitt angeben.

HinweisHinweis

Wenn Sie den credentials-Abschnitt verwenden, müssen Sie die unter ASP.NET Authentication erläuterten Richtlinien befolgen. Aus Gründen der Sicherheit und Skalierbarkeit wird empfohlen, zur Speicherung der Benutzeranmeldeinformationen eine externe Datenbank zu verwenden. Weitere Informationen zum Erstellen sicherer ASP.NET-Anwendungen finden Sie auf der Microsoft MSDN-Website (http://www.microsoft.com/germany/msdn), wenn Sie als Suchbegriffe "Securing Your ASP.NET Application" und "Building Secure ASP.NET Applications: Authentication, Authorization, and Secure Communication" eingeben.

<authentication mode="Forms">
  <forms name="MyAppCookieName" loginUrl="login.aspx">
    <credentials passwordFormat="SHA1">
      <user name="Kim"
         password="07B7F3EE06F278DB966BE960E7CBBD103DF30CA6"/>
      <user name="John"
         password="BA56E5E0366D003E98EA1C7F04ABF8FCB3753889"/>
    </credentials>
  </forms>
</authentication>

Im folgenden Codebeispiel wird die Verwendung der AuthenticationSection-Klasse veranschaulicht.


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

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



.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.