CommaDelimitedStringCollection Clase

Definición

Representa una colección de elementos de cadena separados por comas.Represents a collection of string elements separated by commas. Esta clase no puede heredarse.This class cannot be inherited.

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
Herencia
CommaDelimitedStringCollection

Ejemplos

En el ejemplo de código siguiente se muestra cómo CommaDelimitedStringCollection utilizar el tipo.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();
    }
  }
}
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

Comentarios

Esta clase representa una colección de cadenas que se serializa como una lista delimitada por comas de elementos de cadena.This class represents a string collection that is serialized as a comma-delimited list of string elements.

Constructores

CommaDelimitedStringCollection()

Crea una nueva instancia de la clase CommaDelimitedStringCollection.Creates a new instance of the CommaDelimitedStringCollection class.

Propiedades

Count

Obtiene el número de cadenas incluidas en StringCollection.Gets the number of strings contained in the StringCollection.

(Heredado de StringCollection)
IsModified

Obtiene un valor que indica si se ha modificado la colección.Gets a value that specifies whether the collection has been modified.

IsReadOnly

Obtiene un valor que indica si el objeto de la colección es de sólo lectura.Gets a value indicating whether the collection object is read-only.

IsSynchronized

Obtiene un valor que indica si el acceso a la interfaz StringCollection está sincronizado (es seguro para subprocesos).Gets a value indicating whether access to the StringCollection is synchronized (thread safe).

(Heredado de StringCollection)
Item[Int32]

Obtiene o establece un elemento de cadena de la colección basándose en el índice.Gets or sets a string element in the collection based on the index.

SyncRoot

Obtiene un objeto que se puede usar para sincronizar el acceso a StringCollection.Gets an object that can be used to synchronize access to the StringCollection.

(Heredado de StringCollection)

Métodos

Add(String)

Agrega una cadena a la colección separada por comas.Adds a string to the comma-delimited collection.

AddRange(String[])

Agrega todas las cadenas de una matriz de cadenas a la colección.Adds all the strings in a string array to the collection.

Clear()

Borra la colección.Clears the collection.

Clone()

Crea una copia de la colección.Creates a copy of the collection.

Contains(String)

Determina si la cadena especificada se incluye en StringCollection.Determines whether the specified string is in the StringCollection.

(Heredado de StringCollection)
CopyTo(String[], Int32)

Copia todos los valores StringCollection en una matriz de cadenas unidimensional, comenzando por el índice especificado de la matriz de destino.Copies the entire StringCollection values to a one-dimensional array of strings, starting at the specified index of the target array.

(Heredado de StringCollection)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetEnumerator()

Devuelve una clase StringEnumerator que recorre en iteración la clase StringCollection.Returns a StringEnumerator that iterates through the StringCollection.

(Heredado de StringCollection)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IndexOf(String)

Busca la cadena especificada y devuelve el índice de base cero de la primera aparición de StringCollection.Searches for the specified string and returns the zero-based index of the first occurrence within the StringCollection.

(Heredado de StringCollection)
Insert(Int32, String)

Agrega un elemento de cadena en el índice especificado de la colección.Adds a string element to the collection at the specified index.

MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
Remove(String)

Quita un elemento de cadena de la colección.Removes a string element from the collection.

RemoveAt(Int32)

Quita la cadena del índice especificado de StringCollection.Removes the string at the specified index of the StringCollection.

(Heredado de StringCollection)
SetReadOnly()

Establece el objeto de colección como de sólo lectura.Sets the collection object to read-only.

ToString()

Devuelve una representación de cadena del objeto.Returns a string representation of the object.

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32)

Copia la totalidad de StringCollection en una matriz Array unidimensional compatible, comenzando en el índice especificado de la matriz de destino.Copies the entire StringCollection to a compatible one-dimensional Array, starting at the specified index of the target array.

(Heredado de StringCollection)
IEnumerable.GetEnumerator()

Devuelve una clase IEnumerator que recorre en iteración la clase StringCollection.Returns a IEnumerator that iterates through the StringCollection.

(Heredado de StringCollection)
IList.Add(Object)

Agrega un objeto al final de StringCollection.Adds an object to the end of the StringCollection.

(Heredado de StringCollection)
IList.Contains(Object)

Determina si un elemento se encuentra en StringCollection.Determines whether an element is in the StringCollection.

(Heredado de StringCollection)
IList.IndexOf(Object)

Busca el objeto Object especificado y devuelve el índice de base cero de la primera aparición en toda la colección StringCollection.Searches for the specified Object and returns the zero-based index of the first occurrence within the entire StringCollection.

(Heredado de StringCollection)
IList.Insert(Int32, Object)

Inserta un elemento en StringCollection en el índice especificado.Inserts an element into the StringCollection at the specified index.

(Heredado de StringCollection)
IList.IsFixedSize

Obtiene un valor que indica si el objeto StringCollection tiene un tamaño fijo.Gets a value indicating whether the StringCollection object has a fixed size.

(Heredado de StringCollection)
IList.IsReadOnly

Obtiene un valor que indica si el objeto StringCollection es de solo lectura.Gets a value indicating whether the StringCollection object is read-only.

(Heredado de StringCollection)
IList.Item[Int32]

Obtiene o establece el elemento en el índice especificado.Gets or sets the element at the specified index.

(Heredado de StringCollection)
IList.Remove(Object)

Quita la primera aparición de un objeto específico de la interfaz StringCollection.Removes the first occurrence of a specific object from the StringCollection.

(Heredado de StringCollection)

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: