CommaDelimitedStringCollection Classe

Definição

Representa uma coleção de elementos de cadeia de caracteres separados por vírgulas.Represents a collection of string elements separated by commas. Esta classe não pode ser herdada.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
Herança
CommaDelimitedStringCollection

Exemplos

O exemplo de código a seguir demonstra como usar o tipo de CommaDelimitedStringCollection.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

Comentários

Essa classe representa uma coleção de cadeia de caracteres que é serializada como uma lista delimitada por vírgulas de elementos de cadeia de caracteres.This class represents a string collection that is serialized as a comma-delimited list of string elements.

Construtores

CommaDelimitedStringCollection()

Cria uma nova instância da classe CommaDelimitedStringCollection.Creates a new instance of the CommaDelimitedStringCollection class.

Propriedades

Count

Obtém o número de cadeias de caracteres contidas no StringCollection.Gets the number of strings contained in the StringCollection.

(Herdado de StringCollection)
IsModified

Obtém um valor que especifica se a coleção foi modificada.Gets a value that specifies whether the collection has been modified.

IsReadOnly

Obtém um valor que indica se o objeto da coleção é somente leitura.Gets a value indicating whether the collection object is read-only.

IsSynchronized

Obtém um valor que indica se o acesso à StringCollection é sincronizado (thread-safe).Gets a value indicating whether access to the StringCollection is synchronized (thread safe).

(Herdado de StringCollection)
Item[Int32]

Obtém ou define um elemento de cadeia de caracteres na coleção com base no índice.Gets or sets a string element in the collection based on the index.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao StringCollection.Gets an object that can be used to synchronize access to the StringCollection.

(Herdado de StringCollection)

Métodos

Add(String)

Adiciona uma cadeia de caracteres à coleção delimitada por vírgulas.Adds a string to the comma-delimited collection.

AddRange(String[])

Adiciona todas as cadeias de caracteres em uma matriz de cadeias de caracteres à coleção.Adds all the strings in a string array to the collection.

Clear()

Limpa a coleção.Clears the collection.

Clone()

Cria uma cópia da coleção.Creates a copy of the collection.

Contains(String)

Determina se a cadeia de caracteres especificada está na StringCollection.Determines whether the specified string is in the StringCollection.

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

Copia todo os valores de StringCollection em uma matriz unidimensional de cadeias de caracteres, começando no índice especificado da matriz de destino.Copies the entire StringCollection values to a one-dimensional array of strings, starting at the specified index of the target array.

(Herdado de StringCollection)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetEnumerator()

Retorna um StringEnumerator que itera por meio de StringCollection.Returns a StringEnumerator that iterates through the StringCollection.

(Herdado de StringCollection)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
IndexOf(String)

Pesquisa a cadeia de caracteres especificada e retorna o índice de base zero da primeira ocorrência dentro da StringCollection.Searches for the specified string and returns the zero-based index of the first occurrence within the StringCollection.

(Herdado de StringCollection)
Insert(Int32, String)

Adiciona um elemento de cadeia de caracteres à coleção no índice especificado.Adds a string element to the collection at the specified index.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Remove(String)

Remove um elemento de cadeia de caracteres da coleção.Removes a string element from the collection.

RemoveAt(Int32)

Remove a cadeia de caracteres no índice especificado do StringCollection.Removes the string at the specified index of the StringCollection.

(Herdado de StringCollection)
SetReadOnly()

Define o objeto de coleção como somente leitura.Sets the collection object to read-only.

ToString()

Retorna uma representação de cadeia de caracteres do objeto.Returns a string representation of the object.

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)

Copia todo o StringCollection em um Array unidimensional compatível, começando no índice especificado da matriz de destino.Copies the entire StringCollection to a compatible one-dimensional Array, starting at the specified index of the target array.

(Herdado de StringCollection)
IEnumerable.GetEnumerator()

Retorna um IEnumerator que itera por meio de StringCollection.Returns a IEnumerator that iterates through the StringCollection.

(Herdado de StringCollection)
IList.Add(Object)

Adiciona um objeto ao final do StringCollection.Adds an object to the end of the StringCollection.

(Herdado de StringCollection)
IList.Contains(Object)

Determina se um elemento está no StringCollection.Determines whether an element is in the StringCollection.

(Herdado de StringCollection)
IList.IndexOf(Object)

Pesquisa o Object especificado e retorna o índice de base zero da primeira ocorrência dentro de todo o StringCollection.Searches for the specified Object and returns the zero-based index of the first occurrence within the entire StringCollection.

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

Insere um elemento no StringCollection, no índice especificado.Inserts an element into the StringCollection at the specified index.

(Herdado de StringCollection)
IList.IsFixedSize

Obtém um valor que indica se o objeto StringCollection tem um tamanho fixo.Gets a value indicating whether the StringCollection object has a fixed size.

(Herdado de StringCollection)
IList.IsReadOnly

Obtém um valor que indica se o objeto StringCollection é somente leitura.Gets a value indicating whether the StringCollection object is read-only.

(Herdado de StringCollection)
IList.Item[Int32]

Obtém ou define o elemento no índice especificado.Gets or sets the element at the specified index.

(Herdado de StringCollection)
IList.Remove(Object)

Remove a primeira ocorrência de um objeto específico do StringCollection.Removes the first occurrence of a specific object from the StringCollection.

(Herdado de StringCollection)

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Veja também