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

Definição

Espaço de Nomes:
System.Collections.Generic
Assemblagens:
mscorlib.dll, System.Collections.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Collections.dll
Assemblagem:
netstandard.dll

Cria uma cópia superficial de um conjunto de elementos na fonte 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

O índice baseado List<T> em zero no qual o intervalo começa.

count
Int32

O número de elementos na variedade.

Devoluções

List<T>

Uma cópia superficial de um conjunto de elementos na fonte List<T>.

Exceções

ArgumentOutOfRangeException

index é inferior a 0.

-ou-

count é inferior a 0.

ArgumentException

index e count não denotam um intervalo válido de elementos no List<T>.

Exemplos

O exemplo seguinte demonstra o GetRange método e outros métodos da List<T> classe que atuam sobre os intervalos. No final do exemplo, o GetRange método é usado para obter três itens da lista, começando pela localização do índice 2. O ToArray método é chamado sobre o resultado List<T>, criando um array de três elementos. Os elementos do array são exibidos.

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

Observações

Uma cópia superficial de uma coleção de tipos de referência, ou um subconjunto dessa coleção, contém apenas as referências aos elementos da coleção. Os próprios objetos não são copiados. As referências na nova lista apontam para os mesmos objetos que as referências da lista original.

Uma cópia superficial de uma coleção de tipos de valor, ou um subconjunto dessa coleção, contém os elementos da coleção. No entanto, se os elementos da coleção conterem referências a outros objetos, esses objetos não são copiados. As referências nos elementos da nova coleção apontam para os mesmos objetos que as referências nos elementos da coleção original.

Em contraste, uma cópia profunda de uma coleção copia os elementos e tudo o que é referenciado direta ou indiretamente pelos elementos.

Este método é uma operação O(n), onde n é count.

Aplica-se a

Ver também