StringCollection Classe

Definizione

Spazio dei nomi:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Origine:

StringCollection.cs

Rappresenta una raccolta di stringhe.

C#

public class StringCollection : System.Collections.IList

Ereditarietà

Object

StringCollection

Derivato

System.Configuration.CommaDelimitedStringCollection

Implementazioni

ICollection IEnumerable IList

Esempio

Nell'esempio di codice seguente vengono illustrati diversi metodi e proprietà di StringCollection.

C#

using System;
using System.Collections;
using System.Collections.Specialized;

public class SamplesStringCollection  {

   public static void Main()  {

      // Create and initializes a new StringCollection.
      StringCollection myCol = new StringCollection();

      // Add a range of elements from an array to the end of the StringCollection.
      String[] myArr = new String[] { "RED", "orange", "yellow", "RED", "green", "blue", "RED", "indigo", "violet", "RED" };
      myCol.AddRange( myArr );

      // Display the contents of the collection using foreach. This is the preferred method.
      Console.WriteLine( "Displays the elements using foreach:" );
      PrintValues1( myCol );

      // Display the contents of the collection using the enumerator.
      Console.WriteLine( "Displays the elements using the IEnumerator:" );
      PrintValues2( myCol );

      // Display the contents of the collection using the Count and Item properties.
      Console.WriteLine( "Displays the elements using the Count and Item properties:" );
      PrintValues3( myCol );

      // Add one element to the end of the StringCollection and insert another at index 3.
      myCol.Add( "* white" );
      myCol.Insert( 3, "* gray" );

      Console.WriteLine( "After adding \"* white\" to the end and inserting \"* gray\" at index 3:" );
      PrintValues1( myCol );

      // Remove one element from the StringCollection.
      myCol.Remove( "yellow" );

      Console.WriteLine( "After removing \"yellow\":" );
      PrintValues1( myCol );

      // Remove all occurrences of a value from the StringCollection.
      int i = myCol.IndexOf( "RED" );
      while ( i > -1 )  {
         myCol.RemoveAt( i );
         i = myCol.IndexOf( "RED" );
      }

      // Verify that all occurrences of "RED" are gone.
      if ( myCol.Contains( "RED" ) )
         Console.WriteLine( "*** The collection still contains \"RED\"." );

      Console.WriteLine( "After removing all occurrences of \"RED\":" );
      PrintValues1( myCol );

      // Copy the collection to a new array starting at index 0.
      String[] myArr2 = new String[myCol.Count];
      myCol.CopyTo( myArr2, 0 );

      Console.WriteLine( "The new array contains:" );
      for ( i = 0; i < myArr2.Length; i++ )  {
         Console.WriteLine( "   [{0}] {1}", i, myArr2[i] );
      }
      Console.WriteLine();

      // Clears the entire collection.
      myCol.Clear();

      Console.WriteLine( "After clearing the collection:" );
      PrintValues1( myCol );
   }

   // Uses the foreach statement which hides the complexity of the enumerator.
   // NOTE: The foreach statement is the preferred way of enumerating the contents of a collection.
   public static void PrintValues1( StringCollection myCol )  {
      foreach ( Object obj in myCol )
         Console.WriteLine( "   {0}", obj );
      Console.WriteLine();
   }

   // Uses the enumerator.
   // NOTE: The foreach statement is the preferred way of enumerating the contents of a collection.
   public static void PrintValues2( StringCollection myCol )  {
      StringEnumerator myEnumerator = myCol.GetEnumerator();
      while ( myEnumerator.MoveNext() )
         Console.WriteLine( "   {0}", myEnumerator.Current );
      Console.WriteLine();
   }

   // Uses the Count and Item properties.
   public static void PrintValues3( StringCollection myCol )  {
      for ( int i = 0; i < myCol.Count; i++ )
         Console.WriteLine( "   {0}", myCol[i] );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

Displays the elements using foreach:
   RED
   orange
   yellow
   RED
   green
   blue
   RED
   indigo
   violet
   RED

Displays the elements using the IEnumerator:
   RED
   orange
   yellow
   RED
   green
   blue
   RED
   indigo
   violet
   RED

Displays the elements using the Count and Item properties:
   RED
   orange
   yellow
   RED
   green
   blue
   RED
   indigo
   violet
   RED

After adding "* white" to the end and inserting "* gray" at index 3:
   RED
   orange
   yellow
   * gray
   RED
   green
   blue
   RED
   indigo
   violet
   RED
   * white

After removing "yellow":
   RED
   orange
   * gray
   RED
   green
   blue
   RED
   indigo
   violet
   RED
   * white

After removing all occurrences of "RED":
   orange
   * gray
   green
   blue
   indigo
   violet
   * white

The new array contains:
   [0] orange
   [1] * gray
   [2] green
   [3] blue
   [4] indigo
   [5] violet
   [6] * white

After clearing the collection:

*/

Commenti

StringCollection accetta null come valore valido e consente elementi duplicati.

Per i confronti tra stringhe viene fatta distinzione tra maiuscole e minuscole.

È possibile accedere a elementi di questa raccolta usando un indice integer. Gli indici in questa raccolta sono in base zero.

Costruttori

StringCollection()

Inizializza una nuova istanza della classe StringCollection.

Proprietà

Count	Ottiene il numero di stringhe contenute in StringCollection.
IsReadOnly	Ottiene un valore che indica se StringCollection è di sola lettura.
IsSynchronized	Ottiene un valore che indica se l'accesso a StringCollection è sincronizzato (thread-safe).
Item[Int32]	Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.
SyncRoot	Ottiene un oggetto che può essere usato per sincronizzare l'accesso a StringCollection.

Metodi

Add(String)	Aggiunge una stringa alla fine di StringCollection.
AddRange(String[])	Copia gli elementi di una matrice di stringhe alla fine di StringCollection.
Clear()	Rimuove tutte le stringhe da StringCollection.
Contains(String)	Determina se la stringa specificata è inclusa in StringCollection.
CopyTo(String[], Int32)	Copia tutti i valori di StringCollection in una matrice unidimensionale di stringhe, a partire dall'indice specificato della matrice di destinazione.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetEnumerator()	Restituisce un oggetto StringEnumerator che consente di scorrere l'insieme StringCollection.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IndexOf(String)	Cerca la stringa specificata e restituisce l'indice in base zero della prima occorrenza all'interno di StringCollection.
Insert(Int32, String)	Inserisce una stringa in StringCollection, in corrispondenza dell'indice specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Remove(String)	Rimuove la prima occorrenza di una stringa specifica da StringCollection.
RemoveAt(Int32)	Rimuove la stringa in corrispondenza dell'indice specificato di StringCollection.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)	Copia l'intero oggetto StringCollection in un oggetto Array compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.
IEnumerable.GetEnumerator()	Restituisce un oggetto IEnumerator che consente di scorrere l'insieme StringCollection.
IList.Add(Object)	Aggiunge un oggetto alla fine di StringCollection.
IList.Contains(Object)	Determina se un elemento è incluso in StringCollection.
IList.IndexOf(Object)	Cerca l'oggetto Object specificato e restituisce l'indice in base zero della prima occorrenza all'interno dell'intero StringCollection.
IList.Insert(Int32, Object)	Inserisce un elemento in StringCollection in corrispondenza dell'indice specificato.
IList.IsFixedSize	Ottiene un valore che indica se le dimensioni dell'oggetto StringCollection sono fisse.
IList.IsReadOnly	Ottiene un valore che indica se l'oggetto StringCollection è di sola lettura.
IList.Item[Int32]	Ottiene o imposta l'elemento in corrispondenza dell'indice specificato.
IList.Remove(Object)	Rimuove la prima occorrenza di un oggetto specifico da StringCollection.

Metodi di estensione

Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)	Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a

Thread safety

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Questa implementazione non fornisce un wrapper sincronizzato (thread-safe) per un StringCollectionoggetto , ma le classi derivate possono creare le proprie versioni sincronizzate dell'oggetto StringCollection usando la SyncRoot proprietà .

L'enumerazione tramite una raccolta non è intrinsecamente una procedura thread-safe. Anche se una raccolta è sincronizzata, è possibile che venga modificata da altri thread, con conseguente generazione di un'eccezione da parte dell'enumeratore. Per garantire la protezione dei thread durante l'enumerazione, è possibile bloccare la raccolta per l'intera enumerazione oppure intercettare le eccezioni determinate dalle modifiche apportate da altri thread.

Vedi anche

• Esecuzione di operazioni sulle stringhe indipendenti dalle impostazioni cultura