CommaDelimitedStringCollection Class
.NET Framework 4.5
Represents a collection of string elements separated by commas. This class cannot be inherited.
System.Object
System.Collections.Specialized.StringCollection
System.Configuration.CommaDelimitedStringCollection
System.Collections.Specialized.StringCollection
System.Configuration.CommaDelimitedStringCollection
Namespace: System.Configuration
Assembly: System.Configuration (in System.Configuration.dll)
The CommaDelimitedStringCollection type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | CommaDelimitedStringCollection | Creates a new instance of the CommaDelimitedStringCollection class. |
| Name | Description | |
|---|---|---|
![]() | Count | Gets the number of strings contained in the StringCollection. (Inherited from StringCollection.) |
![]() | IsModified | Gets a value that specifies whether the collection has been modified. |
![]() | IsReadOnly | Gets a value indicating whether the collection object is read-only. |
![]() | IsSynchronized | Gets a value indicating whether access to the StringCollection is synchronized (thread safe). (Inherited from StringCollection.) |
![]() | Item | Gets or sets a string element in the collection based on the index. |
![]() | SyncRoot | Gets an object that can be used to synchronize access to the StringCollection. (Inherited from StringCollection.) |
| Name | Description | |
|---|---|---|
![]() | Add | Adds a string to the comma-delimited collection. |
![]() | AddRange | Adds all the strings in a string array to the collection. |
![]() | Clear | Clears the collection. |
![]() | Clone | Creates a copy of the collection. |
![]() | Contains | Determines whether the specified string is in the StringCollection. (Inherited from StringCollection.) |
![]() | CopyTo | Copies the entire StringCollection values to a one-dimensional array of strings, starting at the specified index of the target array. (Inherited from StringCollection.) |
![]() | Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
![]() | GetEnumerator | Returns a StringEnumerator that iterates through the StringCollection. (Inherited from StringCollection.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | IndexOf | Searches for the specified string and returns the zero-based index of the first occurrence within the StringCollection. (Inherited from StringCollection.) |
![]() | Insert | Adds a string element to the collection at the specified index. |
![]() | Remove | Removes a string element from the collection. |
![]() | RemoveAt | Removes the string at the specified index of the StringCollection. (Inherited from StringCollection.) |
![]() | SetReadOnly | Sets the collection object to read-only. |
![]() | ToString | Returns a string representation of the object. (Overrides Object.ToString().) |
| Name | Description | |
|---|---|---|
![]() ![]() | ICollection.CopyTo | Copies the entire StringCollection to a compatible one-dimensional Array, starting at the specified index of the target array. (Inherited from StringCollection.) |
![]() ![]() | IEnumerable.GetEnumerator | Returns a IEnumerator that iterates through the StringCollection. (Inherited from StringCollection.) |
![]() ![]() | IList.Add | Adds an object to the end of the StringCollection. (Inherited from StringCollection.) |
![]() ![]() | IList.Contains | Determines whether an element is in the StringCollection. (Inherited from StringCollection.) |
![]() ![]() | IList.IndexOf | Searches for the specified Object and returns the zero-based index of the first occurrence within the entire StringCollection. (Inherited from StringCollection.) |
![]() ![]() | IList.Insert | Inserts an element into the StringCollection at the specified index. (Inherited from StringCollection.) |
![]() ![]() | IList.IsFixedSize | Gets a value indicating whether the StringCollection object has a fixed size. (Inherited from StringCollection.) |
![]() ![]() | IList.IsReadOnly | Gets a value indicating whether the StringCollection object is read-only. (Inherited from StringCollection.) |
![]() ![]() | IList.Item | Gets or sets the element at the specified index. (Inherited from StringCollection.) |
![]() ![]() | IList.Remove | Removes the first occurrence of a specific object from the StringCollection. (Inherited from StringCollection.) |
The following code example demonstrates how to use the CommaDelimitedStringCollection type.
using System; using System.Collections.Generic; using System.Text; using System.Configuration; using System.Collections; using System.Web; using System.Web.Configuration; using System.Collections.Specialized; namespace Samples.AspNet.Config { class CommaDelimitedStrCollection { static void Main(string[] args) { // Display title and info. Console.WriteLine("ASP.NET Configuration Info"); Console.WriteLine("Type: CommaDelimitedStringCollection"); Console.WriteLine(); // Set the path of the config file. string configPath = "/aspnet"; // Get the Web application configuration object. Configuration config = WebConfigurationManager.OpenWebConfiguration(configPath); // Get the section related object. AuthorizationSection configSection = (AuthorizationSection)config.GetSection("system.web/authorization"); // Get the authorization rule collection. AuthorizationRuleCollection authorizationRuleCollection = configSection.Rules; // Create a CommaDelimitedStringCollection object. CommaDelimitedStringCollection myStrCollection = new CommaDelimitedStringCollection(); for (int i = 0; i < authorizationRuleCollection.Count; i++) { if (authorizationRuleCollection.Get(i).Action.ToString().ToLower() == "allow") { // Add values to the CommaDelimitedStringCollection object. myStrCollection.AddRange( authorizationRuleCollection.Get(i).Users.ToString().Split( ",".ToCharArray())); } } Console.WriteLine("Allowed Users: {0}", myStrCollection.ToString()); // Count the elements in the collection. Console.WriteLine("Allowed User Count: {0}", myStrCollection.Count); // Call the Contains method. Console.WriteLine("Contains 'userName1': {0}", myStrCollection.Contains("userName1")); // Determine the index of an element // in the collection. Console.WriteLine("IndexOf 'userName0': {0}", myStrCollection.IndexOf("userName0")); // Call IsModified. Console.WriteLine("IsModified: {0}", myStrCollection.IsModified); // Call IsReadyOnly. Console.WriteLine("IsReadOnly: {0}", myStrCollection.IsReadOnly); Console.WriteLine(); Console.WriteLine("Add a user name to the collection."); // Insert a new element in the collection. myStrCollection.Insert(myStrCollection.Count, "userNameX"); Console.WriteLine("Collection Value: {0}", myStrCollection.ToString()); Console.WriteLine(); Console.WriteLine("Remove a user name from the collection."); // Remove an element of the collection. myStrCollection.Remove("userNameX"); Console.WriteLine("Collection Value: {0}", myStrCollection.ToString()); // Display and wait Console.ReadLine(); } } }
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.




