ClientTargetCollection Class
.NET Framework 4.5
Represents a collection of ClientTarget objects. This class cannot be inherited.
System.Object
System.Configuration.ConfigurationElement
System.Configuration.ConfigurationElementCollection
System.Web.Configuration.ClientTargetCollection
System.Configuration.ConfigurationElement
System.Configuration.ConfigurationElementCollection
System.Web.Configuration.ClientTargetCollection
Namespace: System.Web.Configuration
Assembly: System.Web (in System.Web.dll)
The ClientTargetCollection type exposes the following members.
| Name | Description | |
|---|---|---|
 | ClientTargetCollection | Infrastructure. Initializes a new instance of the ClientTargetCollection class. |
| 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 | Returns an array of the keys for all the configuration elements contained in the ClientTargetCollection collection. |
| 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 ConfigurationElementCollection. (Inherited from ConfigurationElementCollection.) |
| 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 ClientTarget object at the specified index. |
| Item[String] | Gets the ClientTarget object 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.) |
| Name | Description | |
|---|---|---|
| Add | Adds the specified ClientTarget 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 | Gets the key for the ConfigurationElement at the specified index location. (Inherited from ConfigurationElementCollection.) |
| BaseIsRemoved | Indicates whether the ConfigurationElement with the specified key has been removed from the ConfigurationElementCollection. (Inherited from ConfigurationElementCollection.) |
| BaseRemove | Removes a ConfigurationElement from the collection. (Inherited from ConfigurationElementCollection.) |
| BaseRemoveAt | Removes the ConfigurationElement at the specified index location. (Inherited from ConfigurationElementCollection.) |
| Clear | Removes all the ClientTarget objects from the collection. |
| CopyTo | Copies the contents of the ConfigurationElementCollection to an array. (Inherited from ConfigurationElementCollection.) |
| DeserializeElement | Reads XML from the configuration file. (Inherited from ConfigurationElement.) |
| Equals | Compares the ConfigurationElementCollection to the specified object. (Inherited from ConfigurationElementCollection.) |
| GetEnumerator | Infrastructure. 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 | Gets the collection key for the specified element. |
| 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(ClientTarget) | Removes the specified ClientTarget object from the collection. |
| Remove(String) | Removes the ClientTarget object with the specified alias from the collection. |
| RemoveAt | Removes the ClientTarget object with the specified collection index. |
| Reset | 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 | Writes the configuration data to an XML element in the configuration file when overridden in a derived class. (Inherited from ConfigurationElementCollection.) |
| SerializeToXmlElement | Writes the outer tags of this configuration element to the configuration file when implemented in a derived class. (Inherited from ConfigurationElement.) |
| SetReadOnly | Infrastructure. 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 | Infrastructure. Reverses the effect of merging configuration information from different levels of the configuration hierarchy (Inherited from ConfigurationElementCollection.) |
| Name | Description | |
|---|---|---|
| ICollection.CopyTo | Copies the ConfigurationElementCollection to an array. (Inherited from ConfigurationElementCollection.) |
The ClientTargetCollection type allows access to the ClientTarget elements of the ClientTargetSection section element collection.
It belongs to a group that includes ClientTarget and ClientTargetSection.
The following code example shows how to obtain the ClientTargetCollection object from the configuration file of an existing Web application.
// Get the Web application configuration.
System.Configuration.Configuration configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest");
// Get the <clientTarget> section.
ClientTargetSection clientTargetSection =
(ClientTargetSection)configuration.GetSection(
"system.web/clientTarget");
// Get the client target collection.
ClientTargetCollection clientTargets =
clientTargetSection.ClientTargets;
The following example shows an excerpt from the configuration file.
<clientTarget>
<add alias=
"uplevel"
userAgent="Mozilla/5.0 (compatible;MSIE 6.0;Windows NT 5.1)"/>
<add alias="downlevel" userAgent="Generic Downlevel"/>
</clientTarget>
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
