Metodo QueryableExtensions.Include (IQueryable, 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 ( _
source As IQueryable, _
path As String _
) As IQueryable
'Utilizzo
Dim source As IQueryable
Dim path As String
Dim returnValue As IQueryable
returnValue = source.Include(path)
public static IQueryable Include(
this IQueryable source,
string path
)
[ExtensionAttribute]
public:
static IQueryable^ Include(
IQueryable^ source,
String^ path
)
static member Include :
source:IQueryable *
path:string -> IQueryable
public static function Include(
source : IQueryable,
path : String
) : IQueryable
Parametri
- source
Tipo: System.Linq.IQueryable
Oggetto IQueryable 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
Nuovo oggetto IQueryable 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. 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 di origine, se tale metodo esiste. Se l'oggetto IQueryable di origine non dispone di un metodo corrispondente, questo metodo non esegue alcuna operazione. Tutti i tipi ObjectQuery, ObjectSet<TEntity>, DbQuery e DbSet 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. Le altre istanze di IQueryable 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 per specificare più percorsi per la query.