Metodo QueryableExtensions.Include<T> (IQueryable<T>, String)
[Questa pagina è specifica della versione 6 di Entity Framework. La versione più recente è disponibile come pacchetto NuGet per "Entity Framework". Per ulteriori informazioni su Entity Framework, vedere la pagina msdn.com/data/ef.]
Specifica gli oggetti correlati da includere nei risultati della query.
Spazio dei nomi: System.Data.Entity
Assembly: EntityFramework (in EntityFramework.dll)
Sintassi
'Dichiarazione
<ExtensionAttribute> _
Public Shared Function Include(Of T) ( _
source As IQueryable(Of T), _
path As String _
) As IQueryable(Of T)
'Utilizzo
Dim source As IQueryable(Of T)
Dim path As String
Dim returnValue As IQueryable(Of T)
returnValue = source.Include(path)
public static IQueryable<T> Include<T>(
this IQueryable<T> source,
string path
)
[ExtensionAttribute]
public:
generic<typename T>
static IQueryable<T>^ Include(
IQueryable<T>^ source,
String^ path
)
static member Include :
source:IQueryable<'T> *
path:string -> IQueryable<'T>
JScript does not support generic types and methods.
Parametri di tipo
- T
Tipo di entità per la quale viene eseguita una query.
Parametri
- source
Tipo: System.Linq.IQueryable<T>
Oggetto IQueryable<T> di origine sul quale chiamare Include.
- path
Tipo: System.String
Elenco di oggetti correlati separato da punti da restituire nei risultati della query.
Valore restituito
Tipo: System.Linq.IQueryable<T>
Nuovo oggetto IQueryable<T> con il percorso della query definito.
Nota sull'utilizzo
In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo IQueryable<T>. Per chiamare il metodo usando la sintassi del metodo di istanza, omettere il primo parametro. Per altre informazioni, vedere https://msdn.microsoft.com/it-it/library/bb384936(v=vs.113) o https://msdn.microsoft.com/it-it/library/bb383977(v=vs.113).
Note
Questo metodo di estensione chiama il metodo Include(String) dell'oggetto IQueryable<T> di origine, se tale metodo esiste. Se l'oggetto IQueryable<T> di origine non dispone di un metodo corrispondente, questo metodo non esegue alcuna operazione. Tutti i tipi ObjectQuery<T>, ObjectSet<TEntity>, DbQuery<TResult> e DbSet<TEntity> dispongono di un metodo Include appropriato da chiamare. I percorsi sono inclusivi. Ad esempio, se tramite una chiamata di inclusione viene incluso Include("Orders.OrderLines"), non verrà incluso solo OrderLines, ma anche Orders. Quando si chiama il metodo Include, il percorso della query è valido solo nell'istanza restituita dell'oggetto IQueryable<T>. Le altre istanze di IQueryable<T> e il contesto dell'oggetto stesso non sono interessati. Poiché tramite il metodo Include viene restituito l'oggetto query, è possibile chiamare questo metodo più volte su un oggetto IQueryable<T> per specificare più percorsi per la query.