Enumerable.Zip<TFirst,TSecond,TResult> Método

Definición

Espacio de nombres:
System.Linq
Ensamblados:
System.Core.dll, System.Linq.dll
Ensamblado:
System.Core.dll
Ensamblado:
System.Linq.dll
Ensamblado:
netstandard.dll

Aplica una función especificada a los elementos correspondientes de dos secuencias, lo que genera una secuencia de los resultados.

public:
generic <typename TFirst, typename TSecond, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TResult> ^ Zip(System::Collections::Generic::IEnumerable<TFirst> ^ first, System::Collections::Generic::IEnumerable<TSecond> ^ second, Func<TFirst, TSecond, TResult> ^ resultSelector);
public static System.Collections.Generic.IEnumerable<TResult> Zip<TFirst,TSecond,TResult>(this System.Collections.Generic.IEnumerable<TFirst> first, System.Collections.Generic.IEnumerable<TSecond> second, Func<TFirst,TSecond,TResult> resultSelector);
static member Zip : seq<'First> * seq<'Second> * Func<'First, 'Second, 'Result> -> seq<'Result>
<Extension()>
Public Function Zip(Of TFirst, TSecond, TResult) (first As IEnumerable(Of TFirst), second As IEnumerable(Of TSecond), resultSelector As Func(Of TFirst, TSecond, TResult)) As IEnumerable(Of TResult)

Parámetros de tipo

TFirst

Tipo de los elementos de la primera secuencia de entrada.

TSecond

Tipo de los elementos de la segunda secuencia de entrada.

TResult

Tipo de los elementos de la secuencia de resultados.

Parámetros

first
IEnumerable<TFirst>

Primera secuencia que se va a combinar.

second
IEnumerable<TSecond>

Segunda secuencia que se va a combinar.

resultSelector
Func<TFirst,TSecond,TResult>

Función que especifica cómo combinar los elementos de las dos secuencias.

Devoluciones

IEnumerable<TResult>

que IEnumerable<T> contiene elementos combinados de dos secuencias de entrada.

Excepciones

ArgumentNullException

first o second es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el Zip método para combinar dos secuencias.

int[] numbers = { 1, 2, 3, 4 };
string[] words = { "one", "two", "three" };

var numbersAndWords = numbers.Zip(words, (first, second) => first + " " + second);

foreach (var item in numbersAndWords)
    Console.WriteLine(item);

// This code produces the following output:

// 1 one
// 2 two
// 3 three

Dim numbers() As Integer = {1, 2, 3, 4}
Dim words() As String = {"one", "two", "three"}
Dim numbersAndWords = numbers.Zip(words, Function(first, second) first & " " & second)

For Each item In numbersAndWords
    Console.WriteLine(item)
Next

' This code produces the following output:

' 1 one
' 2 two
' 3 three

Comentarios

Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando directamente a su método /> en C# o en Visual Basic.

El método combina cada elemento de la primera secuencia con un elemento que tiene el mismo índice en la segunda secuencia. Si las secuencias no tienen el mismo número de elementos, el método combina secuencias hasta que llega al final de una de ellas. Por ejemplo, si una secuencia tiene tres elementos y la otra tiene cuatro, la secuencia de resultados solo tendrá tres elementos.

Se aplica a

Consulte también