List<T>.GetRange(Int32, Int32) Método

Definición

Espacio de nombres:
System.Collections.Generic
Ensamblados:
mscorlib.dll, System.Collections.dll
Ensamblado:
mscorlib.dll
Ensamblado:
System.Collections.dll
Ensamblado:
netstandard.dll

Crea una copia superficial de un intervalo de elementos en el origen List<T>.

public:
 System::Collections::Generic::List<T> ^ GetRange(int index, int count);
public System.Collections.Generic.List<T> GetRange(int index, int count);
member this.GetRange : int * int -> System.Collections.Generic.List<'T>
Public Function GetRange (index As Integer, count As Integer) As List(Of T)

Parámetros

index
Int32

Índice de base List<T> cero en el que se inicia el intervalo.

count
Int32

Número de elementos del intervalo.

Devoluciones

List<T>

Copia superficial de un intervalo de elementos en el origen List<T>.

Excepciones

ArgumentOutOfRangeException

index es menor que 0.

O bien

count es menor que 0.

ArgumentException

indexy count no denotan un intervalo válido de elementos en .List<T>

Ejemplos

En el ejemplo siguiente se muestra el GetRange método y otros métodos de la List<T> clase que actúan en intervalos. Al final del ejemplo, el GetRange método se usa para obtener tres elementos de la lista, empezando por la ubicación del índice 2. Se ToArray llama al método en el resultante List<T>, creando una matriz de tres elementos. Se muestran los elementos de la matriz.

using System;
using System.Collections.Generic;

string[] input = { "Apple",
                   "Banana",
                   "Orange" };

List<string> fruits = new List<string>(input);

Console.WriteLine("\nCapacity: {0}", fruits.Capacity);
Console.WriteLine();

foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

Console.WriteLine("\nAddRange(fruits)");
fruits.AddRange(fruits);

Console.WriteLine();
foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

Console.WriteLine("\nRemoveRange(2, 2)");
fruits.RemoveRange(2, 2);

Console.WriteLine();
foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

input = new string[] { "Mango",
                       "Pineapple",
                       "Watermelon" };

Console.WriteLine("\nInsertRange(3, input)");
fruits.InsertRange(3, input);

Console.WriteLine();
foreach (string fruit in fruits)
{
    Console.WriteLine(fruit);
}

Console.WriteLine("\noutput = fruits.GetRange(2, 3).ToArray()");
string[] output = fruits.GetRange(2, 3).ToArray();

Console.WriteLine();
foreach (string fruit in output)
{
    Console.WriteLine(fruit);
}

/*
    This code example produces the following output:

    Capacity: 3

    Apple
    Banana
    Orange

    AddRange(fruits)

    Apple
    Banana
    Orange
    Apple
    Banana
    Orange

    RemoveRange(2, 2)

    Apple
    Banana
    Banana
    Orange

    InsertRange(3, input)

    Apple
    Banana
    Banana
    Mango
    Pineapple
    Watermelon
    Orange

    output = fruits.GetRange(2, 3).ToArray()

    Banana
    Mango
    Pineapple
*/

Imports System.Collections.Generic

Partial Public Class Program
    Public Shared Sub ShowFruits()

        Dim input() As String = { "Apple", _
                                  "Banana", _
                                  "Orange" }

        Dim fruits As New List(Of String)(input)

        Console.WriteLine(vbLf & "Capacity: {0}", fruits.Capacity)
        Console.WriteLine()

        For Each fruit As String In fruits
            Console.WriteLine(fruit)
        Next

        Console.WriteLine(vbLf & "AddRange(fruits)")
        fruits.AddRange(fruits)

        Console.WriteLine()
        For Each fruit As String In fruits
            Console.WriteLine(fruit)
        Next

        Console.WriteLine(vbLf & "RemoveRange(2, 2)")
        fruits.RemoveRange(2, 2)

        Console.WriteLine()
        For Each fruit As String In fruits
            Console.WriteLine(fruit)
        Next

        input = New String() { "Mango", _
                               "Pineapple", _
                               "Watermelon" }

        Console.WriteLine(vbLf & "InsertRange(3, input)")
        fruits.InsertRange(3, input)

        Console.WriteLine()
        For Each fruit As String In fruits
            Console.WriteLine(fruit)
        Next

        Console.WriteLine(vbLf & "output = fruits.GetRange(2, 3).ToArray")
        Dim output() As String = fruits.GetRange(2, 3).ToArray()

        Console.WriteLine()
        For Each fruit As String In output
            Console.WriteLine(fruit)
        Next

    End Sub
End Class

' This code example produces the following output:
'
' Capacity: 3
'
' Apple
' Banana
' Orange
'
' AddRange(fruits)
'
' Apple
' Banana
' Orange
' Apple
' Banana
' Orange
'
' RemoveRange(2, 2)
'
' Apple
' Banana
' Banana
' Orange
'
' InsertRange(3, input)
'
' Apple
' Banana
' Banana
' Mango
' Pineapple
' Watermelon
' Orange
'
' output = fruits.GetRange(2, 3).ToArray
'
' Banana
' Mango
' Pineapple

Comentarios

Una copia superficial de una colección de tipos de referencia, o un subconjunto de esa colección, contiene solo las referencias a los elementos de la colección. Los propios objetos no se copian. Las referencias de la nueva lista apuntan a los mismos objetos que las referencias de la lista original.

Una copia superficial de una colección de tipos de valor o un subconjunto de esa colección contiene los elementos de la colección. Sin embargo, si los elementos de la colección contienen referencias a otros objetos, esos objetos no se copian. Las referencias de los elementos de la nueva colección apuntan a los mismos objetos que las referencias de los elementos de la colección original.

Por el contrario, una copia profunda de una colección copia los elementos y todo lo que hacen referencia directa o indirectamente a los elementos.

Este método es una operación de O(n), donde n es count.

Se aplica a

Consulte también