CommaDelimitedStringCollection Klasse

Referenz

Definition

Namespace:: System.Configuration

Assembly:: System.Configuration.ConfigurationManager.dll

Assembly:: System.Configuration.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Auflistung von durch Kommas getrennten Zeichenfolgenelementen dar. Diese Klasse kann nicht vererbt werden.

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: Object

StringCollection
CommaDelimitedStringCollection

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie der CommaDelimitedStringCollection Typ verwendet wird.

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 Zeichenfolgenauflistung dar, die als durch Trennzeichen getrennte Liste von Zeichenfolgenelementen serialisiert wird.

Konstruktoren

CommaDelimitedStringCollection()

Erstellt eine neue Instanz der CommaDelimitedStringCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Zeichenfolgen ab, die in der StringCollection enthalten sind. (Geerbt von StringCollection)
IsModified	Ruft einen Wert ab, der angibt, ob die Auflistung geändert wurde.
IsReadOnly	Ruft einen Wert ab, der angibt, ob das Auflistungsobjekt schreibgeschützt ist.
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die StringCollection synchronisiert (threadsicher) ist. (Geerbt von StringCollection)
Item[Int32]	Ruft ein auf dem Index basierendes Zeichenfolgenelement aus der Auflistung ab oder legt dieses fest.
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf StringCollection synchronisiert werden kann. (Geerbt von StringCollection)

Methoden

Add(String)	Fügt der durch Trennzeichen getrennten Auflistung eine Zeichenfolge hinzu.
AddRange(String[])	Fügt der Auflistung alle Zeichenfolgen in einem Zeichenfolgenarray hinzu.
Clear()	Löscht die Auflistung.
Clone()	Erstellt eine Kopie der Auflistung.
Contains(String)	Bestimmt, ob sich die angegebene Zeichenfolge in der StringCollection befindet. (Geerbt von StringCollection)
CopyTo(String[], Int32)	Kopiert alle StringCollection-Werte beginnend am angegebenen Index des Zielarrays in ein eindimensionales Zeichenfolgenarray. (Geerbt von StringCollection)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Gibt einen StringEnumerator zurück, der die StringCollection durchläuft. (Geerbt von StringCollection)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(String)	Sucht nach der angegebenen Zeichenfolge und gibt den nullbasierten Index des ersten Vorkommens in der StringCollection zurück. (Geerbt von StringCollection)
Insert(Int32, String)	Fügt der Auflistung am angegebenen Index ein Zeichenfolgenelement hinzu.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Remove(String)	Entfernt ein Zeichenfolgenelement aus der Auflistung.
RemoveAt(Int32)	Entfernt die Zeichenfolge am angegebenen Index der StringCollection. (Geerbt von StringCollection)
SetReadOnly()	Legt fest, dass das Auflistungsobjekt schreibgeschützt ist.
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück.

Explizite Schnittstellenimplementierungen

ICollection.CopyTo(Array, Int32)	Kopiert die gesamte StringCollection-Instanz in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays. (Geerbt von StringCollection)
IEnumerable.GetEnumerator()	Gibt einen IEnumerator zurück, der die StringCollection durchläuft. (Geerbt von StringCollection)
IList.Add(Object)	Fügt am Ende der StringCollection ein Objekt hinzu. (Geerbt von StringCollection)
IList.Contains(Object)	Bestimmt, ob sich ein Element in StringCollection befindet. (Geerbt von StringCollection)
IList.IndexOf(Object)	Sucht nach dem angegebenen Object und gibt den nullbasierten Index des ersten Vorkommens innerhalb der gesamten StringCollection zurück. (Geerbt von StringCollection)
IList.Insert(Int32, Object)	Fügt am angegebenen Index ein Element in die StringCollection ein. (Geerbt von StringCollection)
IList.IsFixedSize	Ruft einen Wert ab, der angibt, ob das StringCollection-Objekt eine feste Größe hat. (Geerbt von StringCollection)
IList.IsReadOnly	Ruft einen Wert ab, der angibt, ob das StringCollection schreibgeschützt ist. (Geerbt von StringCollection)
IList.Item[Int32]	Ruft das Element am angegebenen Index ab oder legt dieses fest. (Geerbt von StringCollection)
IList.Remove(Object)	Entfernt das erste Vorkommen eines angegebenen Objekts aus der StringCollection. (Geerbt von StringCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für

Siehe auch

StringCollection