Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo Queryable.Join<TOuter, TInner, TKey, TResult> (IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter, TKey>>, Expression<Func<TInner, TKey>>, Expression<Func<TOuter, TInner, TResult>>)

Correla gli elementi di due sequenze in base alle chiavi corrispondenti. Per confrontare le chiavi viene utilizzato l'operatore di confronto di uguaglianza predefinito.

Spazio dei nomi:  System.Linq
Assembly:  System.Core (in System.Core.dll)

public static IQueryable<TResult> Join<TOuter, TInner, TKey, TResult>(
	this IQueryable<TOuter> outer,
	IEnumerable<TInner> inner,
	Expression<Func<TOuter, TKey>> outerKeySelector,
	Expression<Func<TInner, TKey>> innerKeySelector,
	Expression<Func<TOuter, TInner, TResult>> resultSelector
)

Parametri di tipo

TOuter

Tipo degli elementi della prima sequenza.

TInner

Tipo degli elementi della seconda sequenza.

TKey

Tipo delle chiavi restituite dalle funzioni del selettore principale.

TResult

Tipo degli elementi di risultato.

Parametri

outer
Tipo: System.Linq.IQueryable<TOuter>
Prima sequenza da unire.
inner
Tipo: System.Collections.Generic.IEnumerable<TInner>
Sequenza da unire alla prima sequenza.
outerKeySelector
Tipo: System.Linq.Expressions.Expression<Func<TOuter, TKey>>
Funzione per estrarre la chiave di aggiunta da ogni elemento della prima sequenza.
innerKeySelector
Tipo: System.Linq.Expressions.Expression<Func<TInner, TKey>>
Funzione per estrarre la chiave di aggiunta da ogni elemento della seconda sequenza.
resultSelector
Tipo: System.Linq.Expressions.Expression<Func<TOuter, TInner, TResult>>
Funzione per creare un elemento di risultato da due elementi corrispondenti.

Valore restituito

Tipo: System.Linq.IQueryable<TResult>
Un oggetto IQueryable<T> che contiene elementi di tipo TResult ottenuti eseguendo un inner join sulle due sequenze.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo IQueryable<TOuter>. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

EccezioneCondizione
ArgumentNullException

outer o inner o outerKeySelector o innerKeySelector o resultSelector è null.

Nel metodo è presente almeno un parametro di tipo Expression<TDelegate> il cui argomento di tipo è costituito da uno dei tipi Func<T, TResult>. Per questi parametri è possibile passare un'espressione lambda che verrà compilata in un oggetto Expression<TDelegate>.

Il metodo Join<TOuter, TInner, TKey, TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter, TKey>>, Expression<Func<TInner, TKey>>, Expression<Func<TOuter, TInner, TResult>>) genera un oggetto MethodCallExpression che rappresenta una chiamata al metodo Join<TOuter, TInner, TKey, TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter, TKey>>, Expression<Func<TInner, TKey>>, Expression<Func<TOuter, TInner, TResult>>) stesso come un metodo generico costruito. Passa quindi MethodCallExpression al metodo CreateQuery<TElement>(Expression) di IQueryProvider rappresentato dalla proprietà Provider del parametro outer.

Il comportamento della query conseguente all'esecuzione di una struttura ad albero dell'espressione che rappresenta una chiamata a Join<TOuter, TInner, TKey, TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter, TKey>>, Expression<Func<TInner, TKey>>, Expression<Func<TOuter, TInner, TResult>>) dipende dall'implementazione del tipo del parametro outer. Il comportamento previsto è quello di un inner join. Le funzioni outerKeySelector e innerKeySelector vengono utilizzate per estrarre le chiavi da outer e inner, rispettivamente. Viene verificata l’uguaglianza di queste chiavi per associare gli elementi da ciascuna sequenza. Viene archiviata una coppia di elementi per ogni elemento in inner che corrisponde a un elemento in outer. Quindi viene richiamata la funzione resultSelector per proiettare un oggetto di risultato per ciascuna coppia di elementi corrispondenti.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare Join<TOuter, TInner, TKey, TResult>(IQueryable<TOuter>, IEnumerable<TInner>, Expression<Func<TOuter, TKey>>, Expression<Func<TInner, TKey>>, Expression<Func<TOuter, TInner, TResult>>) per eseguire un inner join delle due sequenze basato su una chiave comune.


            class Person
            {
                public string Name { get; set; }
            }

            class Pet
            {
                public string Name { get; set; }
                public Person Owner { get; set; }
            }

            public static void JoinEx1()
            {
                Person magnus = new Person { Name = "Hedlund, Magnus" };
                Person terry = new Person { Name = "Adams, Terry" };
                Person charlotte = new Person { Name = "Weiss, Charlotte" };

                Pet barley = new Pet { Name = "Barley", Owner = terry };
                Pet boots = new Pet { Name = "Boots", Owner = terry };
                Pet whiskers = new Pet { Name = "Whiskers", Owner = charlotte };
                Pet daisy = new Pet { Name = "Daisy", Owner = magnus };

                List<Person> people = new List<Person> { magnus, terry, charlotte };
                List<Pet> pets = new List<Pet> { barley, boots, whiskers, daisy };

                // Join the list of Person objects and the list of Pet objects 
                // to create a list of person-pet pairs where each element is 
                // an anonymous type that contains the name of pet and the name
                // of the person that owns the pet.
                var query = people.AsQueryable().Join(pets,
                                person => person,
                                pet => pet.Owner,
                                (person, pet) =>
                                    new { OwnerName = person.Name, Pet = pet.Name });

                foreach (var obj in query)
                {
                    Console.WriteLine(
                        "{0} - {1}",
                        obj.OwnerName,
                        obj.Pet);
                }
            }

            /*
                This code produces the following output:

                Hedlund, Magnus - Daisy
                Adams, Terry - Barley
                Adams, Terry - Boots
                Weiss, Charlotte - Whiskers
            */



.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft