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 из файла конфигурации существующего веб-приложения. Этот объект можно использовать для доступа к его членам.
// 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 |
Возвращает значение, указывающее, является ли свойство CurrentConfiguration |
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() на |
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) |