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


FormsAuthenticationUser Класс

Определение

Настраивает учетные данные пользователя для веб-приложений, использующих проверку подлинности на основе форм.

public ref class FormsAuthenticationUser sealed : System::Configuration::ConfigurationElement
public sealed class FormsAuthenticationUser : System.Configuration.ConfigurationElement
type FormsAuthenticationUser = class
    inherit ConfigurationElement
Public NotInheritable Class FormsAuthenticationUser
Inherits ConfigurationElement
Наследование
FormsAuthenticationUser

Примеры

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

Примечание

Если вы используете элемент учетных данных для форм для проверки подлинности (ASP.NET схема параметров), обязательно следуйте рекомендациям, описанным в разделе проверка подлинности ASP.NET. Для обеспечения масштабируемости и повышения безопасности рекомендуется использовать внешнюю базу данных для хранения учетных данных пользователей. Дополнительные сведения о создании безопасных приложений ASP.NET см. в статьях Защита приложений ASP.NET и Создание безопасных приложений ASP.NET: проверка подлинности, авторизация и безопасный обмен данными.

В этом примере используется SHA1. Из-за конфликта с SHA1 корпорация Майкрософт рекомендует использовать SHA256.

<authentication mode="Forms">
  <forms name="MyAppCookieName" loginUrl="/login.aspx">
    defaultUrl="formsdefault.aspx"
    protection="Encryption" timeout="5" path="aspnet"
    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(
    "/aspnet");
// Get the section.
AuthenticationSection authenticationSection = 
    (AuthenticationSection)configuration.GetSection(
    "system.web/authentication");
// Get the users collection.
FormsAuthenticationUserCollection formsAuthenticationUsers =
    authenticationSection.Forms.Credentials.Users;
' Get the Web application configuration.
  Dim configuration _
  As System.Configuration.Configuration = _
  WebConfigurationManager.OpenWebConfiguration( _
  "/aspnet")
' Get the section.
  Dim authenticationSection _
  As AuthenticationSection = _
  CType(configuration.GetSection( _
  "system.web/authentication"), AuthenticationSection)
' Get the users collection.
  Dim formsAuthenticationUsers _
  As FormsAuthenticationUserCollection = _
  authenticationSection.Forms.Credentials.Users

Комментарии

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

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

Примечание

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

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

FormsAuthenticationUser(String, String)

Инициализирует новый экземпляр класса FormsAuthenticationUser с помощью переданных параметров.

Свойства

CurrentConfiguration

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Получает или задает имя пользователя при входе в систему.

Password

Получает или задает пароль пользователя.

Properties

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

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

Методы

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)

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

См. также раздел