The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

FormsAuthenticationUserCollection Class

.NET Framework (current version)

Other Versions

Represents a collection of FormsAuthenticationUser objects. This class cannot be inherited.

Namespace: System.Web.Configuration
Assembly: System.Web (in System.Web.dll)

Inheritance Hierarchy

System::Object
System.Configuration::ConfigurationElement
System.Configuration::ConfigurationElementCollection
System.Web.Configuration::FormsAuthenticationUserCollection

Syntax

C++

[ConfigurationCollectionAttribute((FormsAuthenticationUser^::typeid), 
	AddItemName = "user", CollectionType = ConfigurationElementCollectionType::BasicMap)]
public ref class FormsAuthenticationUserCollection sealed : ConfigurationElementCollection

Constructors

	Name	Description
	FormsAuthenticationUserCollection()	This API supports the product infrastructure and is not intended to be used directly from your code. Initializes a new instance of the FormsAuthenticationUserCollection class.

Properties

	Name	Description
	AddElementName	Gets or sets the name of the ConfigurationElement to associate with the add operation in the ConfigurationElementCollection when overridden in a derived class. (Inherited from ConfigurationElementCollection.)
	AllKeys	Gets all the collection's keys.
	ClearElementName	Gets or sets the name for the ConfigurationElement to associate with the clear operation in the ConfigurationElementCollection when overridden in a derived class. (Inherited from ConfigurationElementCollection.)
	CollectionType	Gets the type of the FormsAuthenticationUserCollection.(Overrides ConfigurationElementCollection::CollectionType.)
	Count	Gets the number of elements in the collection.(Inherited from ConfigurationElementCollection.)
	CurrentConfiguration	Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.(Inherited from ConfigurationElement.)
	ElementInformation	Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object. (Inherited from ConfigurationElement.)
	ElementProperty	Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.(Inherited from ConfigurationElement.)
	EmitClear	Gets or sets a value that specifies whether the collection has been cleared.(Inherited from ConfigurationElementCollection.)
	IsSynchronized	Gets a value indicating whether access to the collection is synchronized.(Inherited from ConfigurationElementCollection.)
	Item[ConfigurationProperty^]	Gets or sets a property or attribute of this configuration element.(Inherited from ConfigurationElement.)
	Item[Int32]	Gets the FormsAuthenticationUser at the specified index.
	Item[String^]	Gets the FormsAuthenticationUser with the specified name.
	LockAllAttributesExcept	Gets the collection of locked attributes.(Inherited from ConfigurationElement.)
	LockAllElementsExcept	Gets the collection of locked elements.(Inherited from ConfigurationElement.)
	LockAttributes	Gets the collection of locked attributes (Inherited from ConfigurationElement.)
	LockElements	Gets the collection of locked elements.(Inherited from ConfigurationElement.)
	LockItem	Gets or sets a value indicating whether the element is locked.(Inherited from ConfigurationElement.)
	Properties	Gets the collection of properties.(Inherited from ConfigurationElement.)
	RemoveElementName	Gets or sets the name of the ConfigurationElement to associate with the remove operation in the ConfigurationElementCollection when overridden in a derived class. (Inherited from ConfigurationElementCollection.)
	SyncRoot	Gets an object used to synchronize access to the ConfigurationElementCollection.(Inherited from ConfigurationElementCollection.)

Methods

	Name	Description
	Add(FormsAuthenticationUser^)	Adds a FormsAuthenticationUser object to the collection.
	BaseAdd(ConfigurationElement^, Boolean)	Adds a configuration element to the configuration element collection.(Inherited from ConfigurationElementCollection.)
	BaseClear()	Removes all configuration element objects from the collection.(Inherited from ConfigurationElementCollection.)
	BaseGet(Int32)	Gets the configuration element at the specified index location.(Inherited from ConfigurationElementCollection.)
	BaseGet(Object^)	Returns the configuration element with the specified key.(Inherited from ConfigurationElementCollection.)
	BaseGetAllKeys()	Returns an array of the keys for all of the configuration elements contained in the ConfigurationElementCollection.(Inherited from ConfigurationElementCollection.)
	BaseGetKey(Int32)	Gets the key for the ConfigurationElement at the specified index location.(Inherited from ConfigurationElementCollection.)
	BaseIsRemoved(Object^)	Indicates whether the ConfigurationElement with the specified key has been removed from the ConfigurationElementCollection.(Inherited from ConfigurationElementCollection.)
	BaseRemove(Object^)	Removes a ConfigurationElement from the collection.(Inherited from ConfigurationElementCollection.)
	BaseRemoveAt(Int32)	Removes the ConfigurationElement at the specified index location.(Inherited from ConfigurationElementCollection.)
	Clear()	Removes all FormsAuthenticationUser objects from the collection.
	CopyTo(array<ConfigurationElement^>^, Int32)	Copies the contents of the ConfigurationElementCollection to an array.(Inherited from ConfigurationElementCollection.)
	DeserializeElement(XmlReader^, Boolean)	Reads XML from the configuration file.(Inherited from ConfigurationElement.)
	Equals(Object^)	Compares the ConfigurationElementCollection to the specified object.(Inherited from ConfigurationElementCollection.)
	Get(Int32)	Gets the FormsAuthenticationUser collection element at the specified index.
	Get(String^)	Gets the FormsAuthenticationUser collection element with the specified name.
	GetEnumerator()	This API supports the product infrastructure and is not intended to be used directly from your code. Gets an IEnumerator which is used to iterate through the ConfigurationElementCollection.(Inherited from ConfigurationElementCollection.)
	GetHashCode()	Gets a unique value representing the ConfigurationElementCollection instance.(Inherited from ConfigurationElementCollection.)
	GetKey(Int32)	Gets the key at the specified FormsAuthenticationUserCollection collection index.
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	Init()	Sets the ConfigurationElement object to its initial state.(Inherited from ConfigurationElement.)
	InitializeDefault()	Used to initialize a default set of values for the ConfigurationElement object.(Inherited from ConfigurationElement.)
	IsModified()	Indicates whether this ConfigurationElementCollection has been modified since it was last saved or loaded when overridden in a derived class.(Inherited from ConfigurationElementCollection.)
	IsReadOnly()	Indicates whether the ConfigurationElementCollection object is read only.(Inherited from ConfigurationElementCollection.)
	Remove(String^)	Removes a FormsAuthenticationUser object from the collection.
	RemoveAt(Int32)	Removes a FormsAuthenticationUser object at the specified index from the collection.
	Reset(ConfigurationElement^)	Resets the ConfigurationElementCollection to its unmodified state when overridden in a derived class.(Inherited from ConfigurationElementCollection.)
	ResetModified()	Resets the value of the IsModified property to false when overridden in a derived class.(Inherited from ConfigurationElementCollection.)
	SerializeElement(XmlWriter^, Boolean)	Writes the configuration data to an XML element in the configuration file when overridden in a derived class.(Inherited from ConfigurationElementCollection.)
	SerializeToXmlElement(XmlWriter^, String^)	Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.(Inherited from ConfigurationElement.)
	Set(FormsAuthenticationUser^)	Modifies the specified FormsAuthenticationUser object contained in the collection.
	SetReadOnly()	This API supports the product infrastructure and is not intended to be used directly from your code. Sets the IsReadOnly property for the ConfigurationElementCollection object and for all sub-elements.(Inherited from ConfigurationElementCollection.)
	ToString()	Returns a string that represents the current object.(Inherited from Object.)
	Unmerge(ConfigurationElement^, ConfigurationElement^, ConfigurationSaveMode)	This API supports the product infrastructure and is not intended to be used directly from your code. Reverses the effect of merging configuration information from different levels of the configuration hierarchy (Inherited from ConfigurationElementCollection.)

Explicit Interface Implementations

	Name	Description
	ICollection::CopyTo(Array^, Int32)	Copies the ConfigurationElementCollection to an array.(Inherited from ConfigurationElementCollection.)

Extension Methods

	Name	Description
	AsParallel()	Overloaded. Enables parallelization of a query.(Defined by ParallelEnumerable.)
	AsQueryable()	Overloaded. Converts an IEnumerable to an IQueryable.(Defined by Queryable.)
	Cast<TResult>()	Casts the elements of an IEnumerable to the specified type.(Defined by Enumerable.)
	OfType<TResult>()	Filters the elements of an IEnumerable based on a specified type.(Defined by Enumerable.)

The FormsAuthenticationCredentials uses the FormsAuthenticationUserCollection to programmatically access and modify the users element of the credentials section in the forms section of the authorization configuration section.

This type is part of a group that includes the FormsAuthenticationConfiguration, the FormsAuthenticationCredentials, and the FormsAuthenticationUser types.

Examples

The following code example shows how to obtain the FormsAuthenticationUserCollection object from the configuration file of an existing Web application.

Note
If you use the credentials element be sure to follow the guidelines explained at ASP.NET Authentication. For scalability and better security, it is recommended you use an external database to store the users' credentials. For more information about building secure ASP.NET applications, search the Microsoft MSDN Web site (msdn.microsoft.com) for "Securing Your ASP.NET Application" and "Building Secure ASP.NET Applications: Authentication, Authorization, and Secure Communication."

Note

If you use the credentials element be sure to follow the guidelines explained at ASP.NET Authentication. For scalability and better security, it is recommended you use an external database to store the users' credentials. For more information about building secure ASP.NET applications, search the Microsoft MSDN Web site (msdn.microsoft.com) for "Securing Your ASP.NET Application" and "Building Secure ASP.NET Applications: Authentication, Authorization, and Secure Communication."

C++

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 2.0

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

English	Dansk	Deutsch	Español
Français	Italiano	Nederlands	Polski
Português	Svenska	Türkçe	Pусский
日本語	한국어	简体中文	繁體中文