Поделиться через


FormsAuthenticationConfiguration Класс

Определение

Настраивает приложение ASP.NET для использования модальности форм 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
Наследование
FormsAuthenticationConfiguration

Примеры

В следующем примере кода показано, как получить объект FormsAuthenticationConfiguration из файла конфигурации существующего веб-приложения. Этот объект можно использовать для доступа к его членам.

// 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

Комментарии

Класс FormsAuthenticationConfiguration предоставляет способ программного доступа и изменения элемента forms раздела конфигурации authentication.

Этот тип является частью группы, которая включает FormsAuthenticationCredentials,FormsAuthenticationUserCollectionи типы FormsAuthenticationUser. Типы, отличные от типа коллекции, напрямую влияют на базовые теги конфигурации.

Предупреждение

Хранение учетных данных пользователя в разделе credentialsнебезопасным. Вместо этого используйте Azure Key Vault.

Заметка

FormsAuthenticationConfiguration может записывать сведения в соответствующий раздел файла конфигурации в соответствии с ограничениями, определенными свойством раздела AllowDefinition, значение которого MachineToApplication. Любая попытка записи в файл конфигурации на уровне, запрещенном в иерархии, приведет к возникновению сообщения об ошибке, созданного средством синтаксического анализа. Однако этот класс можно использовать для чтения сведений о конфигурации на любом уровне иерархии. Для безопасности и масштабируемости рекомендуется использовать Azure Key Vault для хранения учетных данных пользователя.

Конструкторы

FormsAuthenticationConfiguration()

Инициализирует новый экземпляр класса FormsAuthenticationConfiguration.

Свойства

Cookieless

Возвращает или задает значение, указывающее, должна ли проверка подлинности на основе форм использовать файлы cookie.

CookieSameSite

Возвращает или задает значение атрибута SameSite файла cookie.

Credentials

Возвращает коллекцию FormsAuthenticationCredentials имен пользователей и паролей.

CurrentConfiguration

Возвращает ссылку на экземпляр верхнего уровня Configuration, представляющий иерархию конфигурации, к которой принадлежит текущий экземпляр ConfigurationElement.

(Унаследовано от ConfigurationElement)
DefaultUrl

Возвращает или задает URL-адрес по умолчанию.

Domain

Возвращает или задает доменное имя для отправки с помощью файлов cookie проверки подлинности форм.

ElementInformation

Возвращает объект ElementInformation, содержащий не настраиваемую информацию и функциональные возможности объекта ConfigurationElement.

(Унаследовано от ConfigurationElement)
ElementProperty

Возвращает объект ConfigurationElementProperty, представляющий сам объект ConfigurationElement.

(Унаследовано от ConfigurationElement)
EnableCrossAppRedirects

Получает или задает значение, указывающее, можно ли перенаправить прошедших проверку подлинности пользователей на URLS в других приложениях.

EvaluationContext

Возвращает объект ContextInformation для объекта ConfigurationElement.

(Унаследовано от ConfigurationElement)
HasContext

Возвращает значение, указывающее, является ли свойство CurrentConfigurationnull.

(Унаследовано от ConfigurationElement)
Item[ConfigurationProperty]

Возвращает или задает свойство или атрибут этого элемента конфигурации.

(Унаследовано от ConfigurationElement)
Item[String]

Возвращает или задает свойство, атрибут или дочерний элемент этого элемента конфигурации.

(Унаследовано от ConfigurationElement)
LockAllAttributesExcept

Возвращает коллекцию заблокированных атрибутов.

(Унаследовано от ConfigurationElement)
LockAllElementsExcept

Возвращает коллекцию заблокированных элементов.

(Унаследовано от ConfigurationElement)
LockAttributes

Возвращает коллекцию заблокированных атрибутов.

(Унаследовано от ConfigurationElement)
LockElements

Возвращает коллекцию заблокированных элементов.

(Унаследовано от ConfigurationElement)
LockItem

Возвращает или задает значение, указывающее, заблокирован ли элемент.

(Унаследовано от ConfigurationElement)
LoginUrl

Возвращает или задает URL-адрес перенаправления для запроса.

Name

Возвращает или задает имя файла cookie.

Path

Возвращает или задает путь к файлу cookie.

Properties

Возвращает коллекцию свойств.

(Унаследовано от ConfigurationElement)
Protection

Возвращает или задает тип шифрования, используемый для шифрования файла cookie.

RequireSSL

Возвращает или задает значение, указывающее, требуется ли подключение уровня SSL при передаче сведений о проверке подлинности.

SlidingExpiration

Возвращает или задает срок действия скольжения проверки подлинности.

TicketCompatibilityMode

Возвращает или задает значение, указывающее, следует ли использовать универсальное время (UTC) или местное время окончания срока действия билета.

Timeout

Возвращает или задает время ожидания проверки подлинности.

Методы

DeserializeElement(XmlReader, Boolean)

Считывает XML из файла конфигурации.

(Унаследовано от ConfigurationElement)
Equals(Object)

Сравнивает текущий экземпляр ConfigurationElement с указанным объектом.

(Унаследовано от ConfigurationElement)
GetHashCode()

Возвращает уникальное значение, представляющее текущий экземпляр ConfigurationElement.

(Унаследовано от ConfigurationElement)
GetTransformedAssemblyString(String)

Возвращает преобразованную версию указанного имени сборки.

(Унаследовано от ConfigurationElement)
GetTransformedTypeString(String)

Возвращает преобразованную версию указанного имени типа.

(Унаследовано от ConfigurationElement)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
Init()

Задает для объекта ConfigurationElement исходное состояние.

(Унаследовано от ConfigurationElement)
InitializeDefault()

Используется для инициализации набора значений по умолчанию для объекта ConfigurationElement.

(Унаследовано от ConfigurationElement)
IsModified()

Указывает, был ли изменен этот элемент конфигурации после последнего сохранения или загрузки при реализации в производном классе.

(Унаследовано от ConfigurationElement)
IsReadOnly()

Возвращает значение, указывающее, доступен ли объект ConfigurationElement только для чтения.

(Унаследовано от ConfigurationElement)
ListErrors(IList)

Добавляет ошибки недопустимого свойства в этом объекте ConfigurationElement и во все вложенные элементы в переданный список.

(Унаследовано от ConfigurationElement)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
OnDeserializeUnrecognizedAttribute(String, String)

Возвращает значение, указывающее, обнаружен ли неизвестный атрибут во время десериализации.

(Унаследовано от ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Возвращает значение, указывающее, обнаружен ли неизвестный элемент во время десериализации.

(Унаследовано от ConfigurationElement)
OnRequiredPropertyNotFound(String)

Создает исключение, если обязательное свойство не найдено.

(Унаследовано от ConfigurationElement)
PostDeserialize()

Вызывается после десериализации.

(Унаследовано от ConfigurationElement)
PreSerialize(XmlWriter)

Вызывается перед сериализацией.

(Унаследовано от ConfigurationElement)
Reset(ConfigurationElement)

Сбрасывает внутреннее состояние объекта ConfigurationElement, включая блокировки и коллекции свойств.

(Унаследовано от ConfigurationElement)
ResetModified()

Сбрасывает значение метода IsModified() на false при реализации в производном классе.

(Унаследовано от ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

Записывает содержимое этого элемента конфигурации в файл конфигурации при реализации в производном классе.

(Унаследовано от ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

Записывает внешние теги этого элемента конфигурации в файл конфигурации при реализации в производном классе.

(Унаследовано от ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Задает свойству указанное значение.

(Унаследовано от ConfigurationElement)
SetReadOnly()

Задает свойство IsReadOnly() для объекта ConfigurationElement и всех вложенных элементов.

(Унаследовано от ConfigurationElement)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Изменяет объект ConfigurationElement, чтобы удалить все значения, которые не должны быть сохранены.

(Унаследовано от ConfigurationElement)

Применяется к