StringCollection.AddRange(String[]) Método

Definição

Copia os elementos de uma matriz de cadeia de caracteres para o final do StringCollection.

public void AddRange (string[] value);

Parâmetros

value
String[]

Uma matriz de cadeias de caracteres para adicionar ao final de StringCollection. A matriz em si não pode ser null, mas pode conter elementos que são null.

Exceções

value é null.

Exemplos

O exemplo de código a seguir adiciona novos elementos ao StringCollection.

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

*/

Comentários

StringCollectionnull aceita como um valor válido e permite elementos duplicados.

Se o StringCollection puder acomodar os novos elementos sem aumentar a capacidade, esse método será uma operação O(n), em n que é o número de elementos a serem adicionados. Se a capacidade precisar ser aumentada para acomodar os novos elementos, esse método se tornará uma operação O(n + m), em n que é o número de elementos a serem adicionados e m é Count.

Aplica-se a

Confira também