QueryableExtensions.Include-Methode (IQueryable, 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 ( _
source As IQueryable, _
path As String _
) As IQueryable
'Usage
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
Parameter
- source
Typ: System.Linq.IQueryable
Das Quell-IQueryable, 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
Eine neue IQueryable 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 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-Quellobjekts auf, falls diese Methode vorhanden ist. Wenn das Quell-IQueryable über keine übereinstimmende Methode verfügt, führt diese Methode keine Aktion aus. Die Typen ObjectQuery, ObjectSet<TEntity>, DbQuery und DbSet 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 gültig. Andere Instanzen von IQueryable und der Objektkontext selbst werden nicht beeinflusst. Da die Include-Methode das Abfrageobjekt zurückgibt, kann diese Methode mehrmals für ein IQueryable aufgerufen werden, um mehrere Pfade für die Abfrage anzugeben.