StringCollection.AddRange(String[]) Método

Definición

Espacio de nombres:

System.Collections.Specialized

Ensamblado:

System.Collections.Specialized.dll

Source:

StringCollection.cs

Copia los elementos de una matriz de cadenas al final del objeto StringCollection.

C#

public void AddRange (string[] value);

Parámetros

value

String[]

Matriz de cadenas que se agregan al final de StringCollection. La propia matriz no puede ser null pero puede contener elementos que sean null.

Excepciones

ArgumentNullException

value es null.

Ejemplos

En el ejemplo de código siguiente se agregan nuevos elementos a .StringCollection

C#

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

public class SamplesStringCollection  {

   public static void Main()  {

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

      Console.WriteLine( "Initial contents of the StringCollection:" );
      PrintValues( myCol );

      // Adds 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 );

      Console.WriteLine( "After adding a range of elements:" );
      PrintValues( myCol );

      // Adds one element to the end of the StringCollection and inserts 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:" );
      PrintValues( myCol );
   }

   public static void PrintValues( IEnumerable myCol )  {
      foreach ( Object obj in myCol )
         Console.WriteLine( "   {0}", obj );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

Initial contents of the StringCollection:

After adding a range of elements:
   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

*/

Comentarios

StringCollection null acepta como un valor válido y permite elementos duplicados.

StringCollection Si puede acomodar los nuevos elementos sin aumentar la capacidad, este método es una operación O(n), donde n es el número de elementos que se van a agregar. Si es necesario aumentar la capacidad para acomodar los nuevos elementos, este método se convierte en una operación O(n + m), donde n es el número de elementos que se van a agregar y m es .Count

Se aplica a

Consulte también

• Add(String)
• IsReadOnly