Enumerable.Zip Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.dll

Sobrecargas

Zip<TFirst,TSecond,TResult>(IEnumerable<TFirst>, IEnumerable<TSecond>, Func<TFirst,TSecond,TResult>)	Aplica la función especificada a los elementos correspondientes de dos secuencias, lo que genera una secuencia de resultados.
Zip<TFirst,TSecond,TThird>(IEnumerable<TFirst>, IEnumerable<TSecond>, IEnumerable<TThird>)	Genera una secuencia de tuplas con elementos de las tres secuencias especificadas.
Zip<TFirst,TSecond>(IEnumerable<TFirst>, IEnumerable<TSecond>)	Genera una secuencia de tuplas con elementos a partir de las dos secuencias especificadas.

Zip<TFirst,TSecond,TResult>(IEnumerable<TFirst>, IEnumerable<TSecond>, Func<TFirst,TSecond,TResult>)

Source:

Zip.cs

Aplica la función especificada a los elementos correspondientes de dos secuencias, lo que genera una secuencia de 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>

IEnumerable<T> que contiene elementos combinados de las 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 GetEnumerator método o mediante foreach en C# o For Each 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 tendrá solo tres elementos.

Consulte también

• Operaciones de proyección: Zip

Zip<TFirst,TSecond,TThird>(IEnumerable<TFirst>, IEnumerable<TSecond>, IEnumerable<TThird>)

Source:

Zip.cs

Genera una secuencia de tuplas con elementos de las tres secuencias especificadas.

public:
generic <typename TFirst, typename TSecond, typename TThird>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<ValueTuple<TFirst, TSecond, TThird>> ^ Zip(System::Collections::Generic::IEnumerable<TFirst> ^ first, System::Collections::Generic::IEnumerable<TSecond> ^ second, System::Collections::Generic::IEnumerable<TThird> ^ third);

public static System.Collections.Generic.IEnumerable<(TFirst First, TSecond Second, TThird Third)> Zip<TFirst,TSecond,TThird> (this System.Collections.Generic.IEnumerable<TFirst> first, System.Collections.Generic.IEnumerable<TSecond> second, System.Collections.Generic.IEnumerable<TThird> third);

static member Zip : seq<'First> * seq<'Second> * seq<'hird> -> seq<ValueTuple<'First, 'Second, 'hird>>

<Extension()>
Public Function Zip(Of TFirst, TSecond, TThird) (first As IEnumerable(Of TFirst), second As IEnumerable(Of TSecond), third As IEnumerable(Of TThird)) As IEnumerable(Of ValueTuple(Of TFirst, TSecond, TThird))

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.

TThird

Tipo de los elementos de la tercera secuencia de entrada.

Parámetros

first

IEnumerable<TFirst>

Primera secuencia que se va a combinar.

second

IEnumerable<TSecond>

Segunda secuencia que se va a combinar.

third

IEnumerable<TThird>

Tercera secuencia que se va a combinar.

Devoluciones

IEnumerable<ValueTuple<TFirst,TSecond,TThird>>

Secuencia de tuplas con elementos tomados de la primera, segunda y tercera secuencia, en ese orden.

Consulte también

• Operaciones de proyección: Zip

Zip<TFirst,TSecond>(IEnumerable<TFirst>, IEnumerable<TSecond>)

Source:

Zip.cs

Genera una secuencia de tuplas con elementos a partir de las dos secuencias especificadas.

public:
generic <typename TFirst, typename TSecond>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<ValueTuple<TFirst, TSecond>> ^ Zip(System::Collections::Generic::IEnumerable<TFirst> ^ first, System::Collections::Generic::IEnumerable<TSecond> ^ second);

public static System.Collections.Generic.IEnumerable<(TFirst First, TSecond Second)> Zip<TFirst,TSecond> (this System.Collections.Generic.IEnumerable<TFirst> first, System.Collections.Generic.IEnumerable<TSecond> second);

static member Zip : seq<'First> * seq<'Second> -> seq<ValueTuple<'First, 'Second>>

<Extension()>
Public Function Zip(Of TFirst, TSecond) (first As IEnumerable(Of TFirst), second As IEnumerable(Of TSecond)) As IEnumerable(Of ValueTuple(Of TFirst, TSecond))

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.

Parámetros

first

IEnumerable<TFirst>

Primera secuencia que se va a combinar.

second

IEnumerable<TSecond>

Segunda secuencia que se va a combinar.

Devoluciones

IEnumerable<ValueTuple<TFirst,TSecond>>

Secuencia de tuplas con elementos tomados de la primera y la segunda secuencia, en ese orden.

Consulte también

• Operaciones de proyección: Zip