CommaDelimitedStringCollection Classe

Définition

Espace de noms:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Paquet:

System.Configuration.ConfigurationManager v8.0.0

Source:

StringAttributeCollection.cs

Représente une collection d’éléments de chaîne séparés par des virgules. Cette classe ne peut pas être héritée.

public ref class CommaDelimitedStringCollection sealed : System::Collections::Specialized::StringCollection

public sealed class CommaDelimitedStringCollection : System.Collections.Specialized.StringCollection

type CommaDelimitedStringCollection = class
    inherit StringCollection

Public NotInheritable Class CommaDelimitedStringCollection
Inherits StringCollection

Héritage

Object

StringCollection

CommaDelimitedStringCollection

Exemples

L’exemple de code suivant montre comment utiliser le 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();
    }
  }
}

Imports System.Collections.Generic
Imports System.Text
Imports System.Configuration
Imports System.Collections
Imports System.Web
Imports System.Web.Configuration
Imports System.Collections.Specialized

Namespace Samples.AspNet.Config
  Class CommaDelimitedStrCollection
    Shared Sub Main(ByVal args() As String)
      ' Display title and info.
      Console.WriteLine("ASP.NET Configuration Info")
      Console.WriteLine("Type: CommaDelimitedStringCollection")
      Console.WriteLine()

      ' Set the path of the config file.
      Dim configPath As String = "/aspnet"

      ' Get the Web application configuration object.
      Dim config As Configuration = _
      WebConfigurationManager.OpenWebConfiguration(configPath)

      ' Get the section related object.
      Dim configSection As AuthorizationSection = _
      CType(config.GetSection("system.web/authorization"), AuthorizationSection)

      ' Get the authorization rule collection.
      Dim authorizationRuleCollection As AuthorizationRuleCollection = _
      configSection.Rules()

      ' Create a CommaDelimitedStringCollection object.
      Dim myStrCollection As CommaDelimitedStringCollection = _
        New CommaDelimitedStringCollection()

      Dim i As Integer
      For i = 0 To authorizationRuleCollection.Count - 1 Step i + 1
        If authorizationRuleCollection.Get(i).Action.ToString().ToLower() _
          = "allow" Then
          ' Add values to the CommaDelimitedStringCollection object.
          myStrCollection.AddRange( _
            authorizationRuleCollection.Get(i).Users.ToString().Split( _
            ",".ToCharArray()))
        End If
      Next

      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()
    End Sub
  End Class
End Namespace

Remarques

Cette classe représente une collection de chaînes sérialisée en tant que liste délimitée par des virgules d’éléments de chaîne.

Constructeurs

CommaDelimitedStringCollection()

Crée une instance de la classe CommaDelimitedStringCollection.

Propriétés

Count	Obtient le nombre de chaînes contenues dans StringCollection. (Hérité de StringCollection)
IsModified	Obtient une valeur qui spécifie si la collection a été modifiée.
IsReadOnly	Obtient une valeur indiquant si l'objet de la collection est en lecture seule.
IsSynchronized	Obtient une valeur indiquant si l’accès à StringCollection est synchronisé (thread-safe). (Hérité de StringCollection)
Item[Int32]	Obtient ou définit un élément de chaîne dans la collection en fonction de l'index.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à StringCollection. (Hérité de StringCollection)

Méthodes

Add(String)	Ajoute une chaîne à la collection délimitée par des virgules.
AddRange(String[])	Ajoute toutes les chaînes d'un tableau de chaînes à la collection.
Clear()	Efface la collection.
Clone()	Crée une copie de la collection.
Contains(String)	Détermine si la chaîne spécifiée est dans le StringCollection. (Hérité de StringCollection)
CopyTo(String[], Int32)	Copie les valeurs de StringCollection dans son intégralité dans un tableau unidimensionnel de chaînes, en commençant à l'index spécifié du tableau cible. (Hérité de StringCollection)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetEnumerator()	Retourne un StringEnumerator qui itère au sein de StringCollection. (Hérité de StringCollection)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IndexOf(String)	Recherche la chaîne spécifiée et retourne l'index de base zéro de la première occurrence dans StringCollection. (Hérité de StringCollection)
Insert(Int32, String)	Ajoute un élément de chaîne à la collection au niveau de l'index spécifié.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(String)	Supprime un élément de chaîne de la collection.
RemoveAt(Int32)	Supprime la chaîne à l'index spécifié dans StringCollection. (Hérité de StringCollection)
SetReadOnly()	Définit l'objet de la collection qui doit être en lecture seule.
ToString()	Retourne une représentation de l'objet sous forme de chaîne.

Méthodes d’extension

Voir aussi

• StringCollection