QueryableExtensions.Include<T>-Methode (IQueryable<T>, String)
[Diese Seite bezieht sich auf Entity Framework Version 6. Die neueste Version ist als 'Entity Framework' NuGet-Paket verfügbar. Weitere Informationen zu Entity Framework finden Sie unter msdn.com/data/ef.]
Gibt die verbundenen Objekte an, die in die Abfrageergebnisse eingeschlossen werden sollen.
Namespace: System.Data.Entity
Assembly: EntityFramework (in EntityFramework.dll)
Syntax
'Declaration
<ExtensionAttribute> _
Public Shared Function Include(Of T) ( _
source As IQueryable(Of T), _
path As String _
) As IQueryable(Of T)
'Usage
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.
Typparameter
- T
Der Typ der abgefragten Entität.
Parameter
- source
Typ: System.Linq.IQueryable<T>
Das Quell-IQueryable<T>, für das Include aufgerufen werden soll.
- path
Typ: System.String
Die durch Punkte getrennte Liste verbundener Objekte, die in den Abfrageergebnissen zurückgegeben werden sollen.
Rückgabewert
Typ: System.Linq.IQueryable<T>
Eine neue IQueryable<T> mit dem definierten Abfragepfad.
Hinweis zur Verwendung
In Visual Basic und C# können Sie diese Methode als Instanzenmethode für ein beliebiges Objekt vom Typ IQueryable<T> aufrufen. Bei Verwendung der Syntax für Instanzenmethoden lassen Sie den ersten Parameter aus. Weitere Informationen finden Sie unter https://msdn.microsoft.com/de-de/library/bb384936(v=vs.113) oder https://msdn.microsoft.com/de-de/library/bb383977(v=vs.113).
Hinweise
Diese Erweiterungsmethode ruft die Include(String)-Methode des IQueryable<T>-Quellobjekts auf, falls diese Methode vorhanden ist. Wenn das Quell-IQueryable<T> über keine übereinstimmende Methode verfügt, führt diese Methode keine Aktion aus. Die Typen ObjectQuery<T>, ObjectSet<TEntity>, DbQuery<TResult> und DbSet<TEntity> verfügen allesamt über eine entsprechende Methode. Pfade sind allumfassend. Wird beispielsweise bei einem include-Aufruf Include("Orders.OrderLines") angegeben, wird nicht nur OrderLines einbezogen, sondern auch Orders. Beim Aufruf der Include-Methode ist der Abfragepfad nur für die zurückgegebene Instanz des IQueryable<T> gültig. Andere Instanzen von IQueryable<T> und der Objektkontext selbst werden nicht beeinflusst. Da die Include-Methode das Abfrageobjekt zurückgibt, kann diese Methode mehrmals für ein IQueryable<T> aufgerufen werden, um mehrere Pfade für die Abfrage anzugeben.