CommaDelimitedStringCollection Klasse
Definition
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 Zeichenfolgenelementen dar, die durch Kommas getrennt sind. 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
Beispiele
Im folgenden Codebeispiel wird die Verwendung des Typs CommaDelimitedStringCollection veranschaulicht.
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
| Name | Beschreibung |
|---|---|
| CommaDelimitedStringCollection() |
Erstellt eine neue Instanz der CommaDelimitedStringCollection Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Count |
Ruft die Anzahl der Zeichenfolgen ab, die in der StringCollection. (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 wird (Threadsicher). (Geerbt von StringCollection) |
| Item[Int32] |
Dient zum Abrufen oder Festlegen eines Zeichenfolgenelements in der Auflistung basierend auf dem Index. |
| SyncRoot |
Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die StringCollectionverwendet werden kann. (Geerbt von StringCollection) |
Methoden
| Name | Beschreibung |
|---|---|
| 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. (Geerbt von StringCollection) |
| CopyTo(String[], Int32) |
Kopiert die gesamten StringCollection Werte in ein eindimensionales Array von Zeichenfolgen, beginnend am angegebenen Index des Zielarrays. (Geerbt von StringCollection) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetEnumerator() |
Gibt einen StringEnumerator Wert zurück, der durch die StringCollection. (Geerbt von StringCollection) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IndexOf(String) |
Sucht nach der angegebenen Zeichenfolge und gibt den nullbasierten Index des ersten Vorkommens innerhalb des StringCollection. (Geerbt von StringCollection) |
| Insert(Int32, String) |
Fügt der Auflistung am angegebenen Index ein Zeichenfolgenelement hinzu. |
| MemberwiseClone() |
Erstellt eine flache Kopie der 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 das Auflistungsobjekt auf schreibgeschützt fest. |
| ToString() |
Gibt eine Zeichenfolgendarstellung des Objekts zurück. |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| ICollection.CopyTo(Array, Int32) |
Kopiert das Gesamte StringCollection in einen kompatiblen eindimensionalen Array, beginnend am angegebenen Index des Zielarrays. (Geerbt von StringCollection) |
| IEnumerable.GetEnumerator() |
Gibt einen IEnumerator Wert zurück, der durch die StringCollection. (Geerbt von StringCollection) |
| IList.Add(Object) |
Fügt ein Objekt am Ende der .StringCollection (Geerbt von StringCollection) |
| IList.Contains(Object) |
Bestimmt, ob sich ein Element in der StringCollection. (Geerbt von StringCollection) |
| IList.IndexOf(Object) |
Sucht nach dem angegebenen Object Und gibt den nullbasierten Index des ersten Vorkommens innerhalb des gesamten StringCollectionzurück. (Geerbt von StringCollection) |
| IList.Insert(Int32, Object) |
Fügt ein Element in den StringCollection angegebenen Index ein. (Geerbt von StringCollection) |
| IList.IsFixedSize |
Ruft einen Wert ab, der angibt, ob das StringCollection Objekt eine feste Größe aufweist. (Geerbt von StringCollection) |
| IList.IsReadOnly |
Ruft einen Wert ab, der angibt, ob das StringCollection Objekt schreibgeschützt ist. (Geerbt von StringCollection) |
| IList.Item[Int32] |
Ruft das Element am angegebenen Index ab oder legt es fest. (Geerbt von StringCollection) |
| IList.Remove(Object) |
Entfernt das erste Vorkommen eines bestimmten Objekts aus dem StringCollection. (Geerbt von StringCollection) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| AsParallel(IEnumerable) |
Aktiviert die Parallelisierung einer Abfrage. |
| AsQueryable(IEnumerable) |
Wandelt eine IEnumerable in eine IQueryableum. |
| Cast<TResult>(IEnumerable) |
Wandelt die Elemente eines IEnumerable in den angegebenen Typ um. |
| OfType<TResult>(IEnumerable) |
Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ. |