ParallelEnumerable.Join Method

Definition

Устанавливает параллельную корреляцию между элементами двух последовательностей на основе сопоставления ключей.Correlates in parallel the elements of two sequences based on matching keys.

Overloads

Join<TOuter,TInner,TKey,TResult>(ParallelQuery<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>)

Эту перегрузку Join вызывать не следует.This Join overload should never be called. Данный метод помечен как устаревший, при попытке его вызова всегда создается исключение NotSupportedException.This method is marked as obsolete and always throws NotSupportedException when invoked.

Join<TOuter,TInner,TKey,TResult>(ParallelQuery<TOuter>, ParallelQuery<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>)

Устанавливает параллельную корреляцию между элементами двух последовательностей на основе сопоставления ключей.Correlates in parallel the elements of two sequences based on matching keys. Для сравнения ключей используется компаратор проверки на равенство по умолчанию.The default equality comparer is used to compare keys.

Join<TOuter,TInner,TKey,TResult>(ParallelQuery<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>, IEqualityComparer<TKey>)

Эту перегрузку Join вызывать не следует.This Join overload should never be called. Данный метод помечен как устаревший, при попытке его вызова всегда создается исключение NotSupportedException.This method is marked as obsolete and always throws NotSupportedException when invoked.

Join<TOuter,TInner,TKey,TResult>(ParallelQuery<TOuter>, ParallelQuery<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>, IEqualityComparer<TKey>)

Устанавливает параллельную корреляцию между элементами двух последовательностей на основе сопоставления ключей.Correlates in parallel the elements of two sequences based on matching keys. Для сравнения ключей используется указанный компаратор IEqualityComparer<T>.A specified IEqualityComparer<T> is used to compare keys.

Join<TOuter,TInner,TKey,TResult>(ParallelQuery<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>)

Warning

This API is now obsolete.

Эту перегрузку Join вызывать не следует.This Join overload should never be called. Данный метод помечен как устаревший, при попытке его вызова всегда создается исключение NotSupportedException.This method is marked as obsolete and always throws NotSupportedException when invoked.

public:
generic <typename TOuter, typename TInner, typename TKey, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::ParallelQuery<TResult> ^ Join(System::Linq::ParallelQuery<TOuter> ^ outer, System::Collections::Generic::IEnumerable<TInner> ^ inner, Func<TOuter, TKey> ^ outerKeySelector, Func<TInner, TKey> ^ innerKeySelector, Func<TOuter, TInner, TResult> ^ resultSelector);
[System.Obsolete("The second data source of a binary operator must be of type System.Linq.ParallelQuery<T> rather than System.Collections.Generic.IEnumerable<T>. To fix this problem, use the AsParallel() extension method to convert the right data source to System.Linq.ParallelQuery<T>.")]
public static System.Linq.ParallelQuery<TResult> Join<TOuter,TInner,TKey,TResult> (this System.Linq.ParallelQuery<TOuter> outer, System.Collections.Generic.IEnumerable<TInner> inner, Func<TOuter,TKey> outerKeySelector, Func<TInner,TKey> innerKeySelector, Func<TOuter,TInner,TResult> resultSelector);
static member Join : System.Linq.ParallelQuery<'Outer> * seq<'Inner> * Func<'Outer, 'Key> * Func<'Inner, 'Key> * Func<'Outer, 'Inner, 'Result> -> System.Linq.ParallelQuery<'Result>
<Extension()>
Public Function Join(Of TOuter, TInner, TKey, TResult) (outer As ParallelQuery(Of TOuter), inner As IEnumerable(Of TInner), outerKeySelector As Func(Of TOuter, TKey), innerKeySelector As Func(Of TInner, TKey), resultSelector As Func(Of TOuter, TInner, TResult)) As ParallelQuery(Of TResult)

Type Parameters

TOuter

Этот параметр типа не используется.This type parameter is not used.

TInner

Этот параметр типа не используется.This type parameter is not used.

TKey

Этот параметр типа не используется.This type parameter is not used.

TResult

Этот параметр типа не используется.This type parameter is not used.

Parameters

outer
ParallelQuery<TOuter>

Этот параметр не используется.This parameter is not used.

inner
IEnumerable<TInner>

Этот параметр не используется.This parameter is not used.

outerKeySelector
Func<TOuter,TKey>

Этот параметр не используется.This parameter is not used.

innerKeySelector
Func<TInner,TKey>

Этот параметр не используется.This parameter is not used.

resultSelector
Func<TOuter,TInner,TResult>

Этот параметр не используется.This parameter is not used.

Returns

ParallelQuery<TResult>

Данная перегрузка всегда создает исключение NotSupportedException.This overload always throws a NotSupportedException.

Attributes

Exceptions

Исключение, которое возникает при вызове этого метода.The exception that occurs when this method is called.

Remarks

Эта перегрузка существует для запрета объединения использования с источником данных типа ParallelQuery<TSource> и с нужным источником данных типа IEnumerable<T>.This overload exists to disallow usage Join with a left data source of type ParallelQuery<TSource> and a right data source of type IEnumerable<T>. В противном случае оператор JOIN будет выглядеть как привязка к параллельной реализации, но в действительности будет привязана к последовательной реализации.Otherwise, the Join operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.

See also

Join<TOuter,TInner,TKey,TResult>(ParallelQuery<TOuter>, ParallelQuery<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>)

Устанавливает параллельную корреляцию между элементами двух последовательностей на основе сопоставления ключей.Correlates in parallel the elements of two sequences based on matching keys. Для сравнения ключей используется компаратор проверки на равенство по умолчанию.The default equality comparer is used to compare keys.

public:
generic <typename TOuter, typename TInner, typename TKey, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::ParallelQuery<TResult> ^ Join(System::Linq::ParallelQuery<TOuter> ^ outer, System::Linq::ParallelQuery<TInner> ^ inner, Func<TOuter, TKey> ^ outerKeySelector, Func<TInner, TKey> ^ innerKeySelector, Func<TOuter, TInner, TResult> ^ resultSelector);
public static System.Linq.ParallelQuery<TResult> Join<TOuter,TInner,TKey,TResult> (this System.Linq.ParallelQuery<TOuter> outer, System.Linq.ParallelQuery<TInner> inner, Func<TOuter,TKey> outerKeySelector, Func<TInner,TKey> innerKeySelector, Func<TOuter,TInner,TResult> resultSelector);
static member Join : System.Linq.ParallelQuery<'Outer> * System.Linq.ParallelQuery<'Inner> * Func<'Outer, 'Key> * Func<'Inner, 'Key> * Func<'Outer, 'Inner, 'Result> -> System.Linq.ParallelQuery<'Result>
<Extension()>
Public Function Join(Of TOuter, TInner, TKey, TResult) (outer As ParallelQuery(Of TOuter), inner As ParallelQuery(Of TInner), outerKeySelector As Func(Of TOuter, TKey), innerKeySelector As Func(Of TInner, TKey), resultSelector As Func(Of TOuter, TInner, TResult)) As ParallelQuery(Of TResult)

Type Parameters

TOuter

Тип элементов первой последовательности.The type of the elements of the first sequence.

TInner

Тип элементов второй последовательности.The type of the elements of the second sequence.

TKey

Тип ключей, возвращаемых функциями селектора ключа.The type of the keys returned by the key selector functions.

TResult

Тип результирующих элементов.The type of the result elements.

Parameters

outer
ParallelQuery<TOuter>

Первая последовательность для соединения.The first sequence to join.

inner
ParallelQuery<TInner>

Последовательность, соединяемая с первой последовательностью.The sequence to join to the first sequence.

outerKeySelector
Func<TOuter,TKey>

Функция, извлекающая ключ соединения из каждого элемента первой последовательности.A function to extract the join key from each element of the first sequence.

innerKeySelector
Func<TInner,TKey>

Функция, извлекающая ключ соединения из каждого элемента второй последовательности.A function to extract the join key from each element of the second sequence.

resultSelector
Func<TOuter,TInner,TResult>

Функция для создания результирующего элемента для пары соответствующих элементов.A function to create a result element from two matching elements.

Returns

ParallelQuery<TResult>

Последовательность, которая содержит элементы типа TResult, полученные в результате внутреннего соединения двух последовательностей.A sequence that has elements of type TResult that are obtained by performing an inner join on two sequences.

Exceptions

Запрос отменен с использованием маркера, переданного через WithCancellation.The query was canceled with the token passed in through WithCancellation.

Параметр source или action — это пустая ссылка (Nothing в Visual Basic).source or action is a null reference (Nothing in Visual Basic).

При оценке запроса получено одно или несколько исключений.One or more exceptions occurred during the evaluation of the query.

See also

Join<TOuter,TInner,TKey,TResult>(ParallelQuery<TOuter>, IEnumerable<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>, IEqualityComparer<TKey>)

Warning

This API is now obsolete.

Эту перегрузку Join вызывать не следует.This Join overload should never be called. Данный метод помечен как устаревший, при попытке его вызова всегда создается исключение NotSupportedException.This method is marked as obsolete and always throws NotSupportedException when invoked.

public:
generic <typename TOuter, typename TInner, typename TKey, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::ParallelQuery<TResult> ^ Join(System::Linq::ParallelQuery<TOuter> ^ outer, System::Collections::Generic::IEnumerable<TInner> ^ inner, Func<TOuter, TKey> ^ outerKeySelector, Func<TInner, TKey> ^ innerKeySelector, Func<TOuter, TInner, TResult> ^ resultSelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
[System.Obsolete("The second data source of a binary operator must be of type System.Linq.ParallelQuery<T> rather than System.Collections.Generic.IEnumerable<T>. To fix this problem, use the AsParallel() extension method to convert the right data source to System.Linq.ParallelQuery<T>.")]
public static System.Linq.ParallelQuery<TResult> Join<TOuter,TInner,TKey,TResult> (this System.Linq.ParallelQuery<TOuter> outer, System.Collections.Generic.IEnumerable<TInner> inner, Func<TOuter,TKey> outerKeySelector, Func<TInner,TKey> innerKeySelector, Func<TOuter,TInner,TResult> resultSelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);
static member Join : System.Linq.ParallelQuery<'Outer> * seq<'Inner> * Func<'Outer, 'Key> * Func<'Inner, 'Key> * Func<'Outer, 'Inner, 'Result> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Linq.ParallelQuery<'Result>
<Extension()>
Public Function Join(Of TOuter, TInner, TKey, TResult) (outer As ParallelQuery(Of TOuter), inner As IEnumerable(Of TInner), outerKeySelector As Func(Of TOuter, TKey), innerKeySelector As Func(Of TInner, TKey), resultSelector As Func(Of TOuter, TInner, TResult), comparer As IEqualityComparer(Of TKey)) As ParallelQuery(Of TResult)

Type Parameters

TOuter

Этот параметр типа не используется.This type parameter is not used.

TInner

Этот параметр типа не используется.This type parameter is not used.

TKey

Этот параметр типа не используется.This type parameter is not used.

TResult

Этот параметр типа не используется.This type parameter is not used.

Parameters

outer
ParallelQuery<TOuter>

Этот параметр не используется.This parameter is not used.

inner
IEnumerable<TInner>

Этот параметр не используется.This parameter is not used.

outerKeySelector
Func<TOuter,TKey>

Этот параметр не используется.This parameter is not used.

innerKeySelector
Func<TInner,TKey>

Этот параметр не используется.This parameter is not used.

resultSelector
Func<TOuter,TInner,TResult>

Этот параметр не используется.This parameter is not used.

comparer
IEqualityComparer<TKey>

Этот параметр не используется.This parameter is not used.

Returns

ParallelQuery<TResult>

Данная перегрузка всегда создает исключение NotSupportedException.This overload always throws a NotSupportedException.

Attributes

Exceptions

Исключение, которое возникает при вызове этого метода.The exception that occurs when this method is called.

Remarks

Эта перегрузка существует, чтобы запретить использование объединения с левым источником данных типа ParallelQuery<TSource> и правильным источником данных типа IEnumerable<T>.This overload exists to disallow usage of Join with a left data source of type ParallelQuery<TSource> and a right data source of type IEnumerable<T>. В противном случае оператор JOIN будет выглядеть как привязка к параллельной реализации, но в действительности будет привязана к последовательной реализации.Otherwise, the Join operator would appear to be binding to the parallel implementation, but would in reality bind to the sequential implementation.

See also

Join<TOuter,TInner,TKey,TResult>(ParallelQuery<TOuter>, ParallelQuery<TInner>, Func<TOuter,TKey>, Func<TInner,TKey>, Func<TOuter,TInner,TResult>, IEqualityComparer<TKey>)

Устанавливает параллельную корреляцию между элементами двух последовательностей на основе сопоставления ключей.Correlates in parallel the elements of two sequences based on matching keys. Для сравнения ключей используется указанный компаратор IEqualityComparer<T>.A specified IEqualityComparer<T> is used to compare keys.

public:
generic <typename TOuter, typename TInner, typename TKey, typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::ParallelQuery<TResult> ^ Join(System::Linq::ParallelQuery<TOuter> ^ outer, System::Linq::ParallelQuery<TInner> ^ inner, Func<TOuter, TKey> ^ outerKeySelector, Func<TInner, TKey> ^ innerKeySelector, Func<TOuter, TInner, TResult> ^ resultSelector, System::Collections::Generic::IEqualityComparer<TKey> ^ comparer);
public static System.Linq.ParallelQuery<TResult> Join<TOuter,TInner,TKey,TResult> (this System.Linq.ParallelQuery<TOuter> outer, System.Linq.ParallelQuery<TInner> inner, Func<TOuter,TKey> outerKeySelector, Func<TInner,TKey> innerKeySelector, Func<TOuter,TInner,TResult> resultSelector, System.Collections.Generic.IEqualityComparer<TKey> comparer);
static member Join : System.Linq.ParallelQuery<'Outer> * System.Linq.ParallelQuery<'Inner> * Func<'Outer, 'Key> * Func<'Inner, 'Key> * Func<'Outer, 'Inner, 'Result> * System.Collections.Generic.IEqualityComparer<'Key> -> System.Linq.ParallelQuery<'Result>
<Extension()>
Public Function Join(Of TOuter, TInner, TKey, TResult) (outer As ParallelQuery(Of TOuter), inner As ParallelQuery(Of TInner), outerKeySelector As Func(Of TOuter, TKey), innerKeySelector As Func(Of TInner, TKey), resultSelector As Func(Of TOuter, TInner, TResult), comparer As IEqualityComparer(Of TKey)) As ParallelQuery(Of TResult)

Type Parameters

TOuter

Тип элементов первой последовательности.The type of the elements of the first sequence.

TInner

Тип элементов второй последовательности.The type of the elements of the second sequence.

TKey

Тип ключей, возвращаемых функциями селектора ключа.The type of the keys returned by the key selector functions.

TResult

Тип результирующих элементов.The type of the result elements.

Parameters

outer
ParallelQuery<TOuter>

Первая последовательность для соединения.The first sequence to join.

inner
ParallelQuery<TInner>

Последовательность, соединяемая с первой последовательностью.The sequence to join to the first sequence.

outerKeySelector
Func<TOuter,TKey>

Функция, извлекающая ключ соединения из каждого элемента первой последовательности.A function to extract the join key from each element of the first sequence.

innerKeySelector
Func<TInner,TKey>

Функция, извлекающая ключ соединения из каждого элемента второй последовательности.A function to extract the join key from each element of the second sequence.

resultSelector
Func<TOuter,TInner,TResult>

Функция для создания результирующего элемента для пары соответствующих элементов.A function to create a result element from two matching elements.

comparer
IEqualityComparer<TKey>

Компаратор IEqualityComparer<T>, используемый для хэширования и сравнения ключей.An IEqualityComparer<T> to hash and compare keys.

Returns

ParallelQuery<TResult>

Последовательность, которая содержит элементы типа TResult, полученные в результате внутреннего соединения двух последовательностей.A sequence that has elements of type TResult that are obtained by performing an inner join on two sequences.

Exceptions

Запрос отменен с использованием маркера, переданного через WithCancellation.The query was canceled with the token passed in through WithCancellation.

Параметр source или action — это пустая ссылка (Nothing в Visual Basic).source or action is a null reference (Nothing in Visual Basic).

При оценке запроса получено одно или несколько исключений.One or more exceptions occurred during the evaluation of the query.

See also

Applies to