CommaDelimitedStringCollection CommaDelimitedStringCollection CommaDelimitedStringCollection CommaDelimitedStringCollection Class

Definition

Stellt eine Auflistung von durch Kommas getrennten Zeichenfolgenelementen dar.Represents a collection of string elements separated by commas. Diese Klasse kann nicht vererbt werden.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
Vererbung
CommaDelimitedStringCollectionCommaDelimitedStringCollectionCommaDelimitedStringCollectionCommaDelimitedStringCollection

Beispiele

Im folgenden Codebeispiel wird die Verwendung des CommaDelimitedStringCollection -Typs veranschaulicht.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

Hinweise

Diese Klasse stellt eine Zeichen folgen Auflistung dar, die als durch Trennzeichen getrennte Liste von Zeichen folgen Elementen serialisiert wird.This class represents a string collection that is serialized as a comma-delimited list of string elements.

Konstruktoren

CommaDelimitedStringCollection() CommaDelimitedStringCollection() CommaDelimitedStringCollection() CommaDelimitedStringCollection()

Erstellt eine neue Instanz der CommaDelimitedStringCollection-Klasse.Creates a new instance of the CommaDelimitedStringCollection class.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Zeichenfolgen ab, die in der StringCollection enthalten sind.Gets the number of strings contained in the StringCollection.

(Inherited from StringCollection)
IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

Ruft einen Wert ab, der angibt, ob das StringCollection-Objekt eine feste Größe hat.Gets a value indicating whether the StringCollection object has a fixed size.

(Inherited from StringCollection)
IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly

Ruft einen Wert ab, der angibt, ob das StringCollection-Objekt schreibgeschützt ist.Gets a value indicating whether the StringCollection object is read-only.

(Inherited from StringCollection)
IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

Ruft das Element am angegebenen Index ab oder legt dieses fest.Gets or sets the element at the specified index.

(Inherited from StringCollection)
IsModified IsModified IsModified IsModified

Ruft einen Wert ab, der angibt, ob die Auflistung geändert wurde.Gets a value that specifies whether the collection has been modified.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ruft einen Wert ab, der angibt, ob das Auflistungsobjekt schreibgeschützt ist.Gets a value indicating whether the collection object is read-only.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die StringCollection synchronisiert (threadsicher) ist.Gets a value indicating whether access to the StringCollection is synchronized (thread safe).

(Inherited from StringCollection)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft ein auf dem Index basierendes Zeichenfolgenelement aus der Auflistung ab oder legt dieses fest.Gets or sets a string element in the collection based on the index.

SyncRoot SyncRoot SyncRoot SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf StringCollection synchronisiert werden kann.Gets an object that can be used to synchronize access to the StringCollection.

(Inherited from StringCollection)

Methoden

Add(String) Add(String) Add(String) Add(String)

Fügt der durch Trennzeichen getrennten Auflistung eine Zeichenfolge hinzu.Adds a string to the comma-delimited collection.

AddRange(String[]) AddRange(String[]) AddRange(String[]) AddRange(String[])

Fügt der Auflistung alle Zeichenfolgen in einem Zeichenfolgenarray hinzu.Adds all the strings in a string array to the collection.

Clear() Clear() Clear() Clear()

Löscht die Auflistung.Clears the collection.

Clone() Clone() Clone() Clone()

Erstellt eine Kopie der Auflistung.Creates a copy of the collection.

Contains(String) Contains(String) Contains(String) Contains(String)

Bestimmt, ob sich die angegebene Zeichenfolge in der StringCollection befindet.Determines whether the specified string is in the StringCollection.

(Inherited from StringCollection)
CopyTo(String[], Int32) CopyTo(String[], Int32) CopyTo(String[], Int32) CopyTo(String[], Int32)

Kopiert alle StringCollection-Werte beginnend am angegebenen Index des Zielarrays in ein eindimensionales Zeichenfolgenarray.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) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Gibt einen StringEnumerator zurück, der die StringCollection durchläuft.Returns a StringEnumerator that iterates through the StringCollection.

(Inherited from StringCollection)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(String) IndexOf(String) IndexOf(String) IndexOf(String)

Sucht nach der angegebenen Zeichenfolge und gibt den nullbasierten Index des ersten Vorkommens in der StringCollection zurück.Searches for the specified string and returns the zero-based index of the first occurrence within the StringCollection.

(Inherited from StringCollection)
Insert(Int32, String) Insert(Int32, String) Insert(Int32, String) Insert(Int32, String)

Fügt der Auflistung am angegebenen Index ein Zeichenfolgenelement hinzu.Adds a string element to the collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(String) Remove(String) Remove(String) Remove(String)

Entfernt ein Zeichenfolgenelement aus der Auflistung.Removes a string element from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Entfernt die Zeichenfolge am angegebenen Index der StringCollection.Removes the string at the specified index of the StringCollection.

(Inherited from StringCollection)
SetReadOnly() SetReadOnly() SetReadOnly() SetReadOnly()

Legt fest, dass das Auflistungsobjekt schreibgeschützt ist.Sets the collection object to read-only.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolgendarstellung des Objekts zurück.Returns a string representation of the object.

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Kopiert die gesamte StringCollection-Instanz in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.Copies the entire StringCollection to a compatible one-dimensional Array, starting at the specified index of the target array.

(Inherited from StringCollection)
IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Gibt einen IEnumerator zurück, der die StringCollection durchläuft.Returns a IEnumerator that iterates through the StringCollection.

(Inherited from StringCollection)
IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Fügt am Ende der StringCollection ein Objekt hinzu.Adds an object to the end of the StringCollection.

(Inherited from StringCollection)
IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Bestimmt, ob sich ein Element in StringCollection befindet.Determines whether an element is in the StringCollection.

(Inherited from StringCollection)
IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Sucht nach dem angegebenen Object und gibt den nullbasierten Index des ersten Vorkommens innerhalb der gesamten StringCollection zurück.Searches for the specified Object and returns the zero-based index of the first occurrence within the entire StringCollection.

(Inherited from StringCollection)
IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Fügt am angegebenen Index ein Element in die StringCollection ein.Inserts an element into the StringCollection at the specified index.

(Inherited from StringCollection)
IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Entfernt das erste Vorkommen eines angegebenen Objekts aus der StringCollection.Removes the first occurrence of a specific object from the StringCollection.

(Inherited from StringCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch