EntityDataSource.Select Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Ruft die Projektion ab, die die Eigenschaften definiert, die in die Abfrageergebnisse eingeschlossen werden sollen, oder legt sie fest.

public:
 property System::String ^ Select { System::String ^ get(); void set(System::String ^ value); };

public string Select { get; set; }

member this.Select : string with get, set

Public Property Select As String

Eigenschaftswert

String

Die Parameter, die zum Erstellen der ORDER BY-Klausel verwendet werden.

Ausnahmen

InvalidOperationException

Wenn die Select-Eigenschaft eine Abfrageprojektion angibt, und der Wert von EnableUpdate, EnableDelete oder EnableInserttrue ist.

Beispiele

Im folgenden XML-Markup wird die- Select Eigenschaft verwendet, um eine Projektion mit sechs Eigenschaften des Produkttyps anzugeben:

<asp:EntityDataSource ID="ProductDataSource" runat="server"
    ConnectionString="name=AdventureWorksEntities"
    DefaultContainerName="AdventureWorksEntities"
    EntitySetName="Product" OrderBy="it.[ProductID]"
    Select="it.[ProductID], it.[Name], it.[ListPrice],
    it.[Size], it.[Style], it.[Weight]">
</asp:EntityDataSource>

Das vorherige XML-Beispiel ist mit dem folgenden ObjectQuery<T> Namen identisch products :

ObjectQuery<Product> products = context.Product
    .Select(it.[ProductID], it.[Name], it.[ListPrice],
      it.[Size], it.[Style], it.[Weight])
    .OrderBy("it.[ProductID]");

Hinweise

Die- Select Eigenschaft des- EntityDataSource Steuer Elements enthält eine Zeichenfolge, die die Select -Anweisung einer Entity SQL Abfrage darstellt. Dies ermöglicht es Ihnen, einen angegebenen Satz von Eigenschaften aus den von der Abfrage zurückgegebenen Objekten zu projizieren.

Diese Zeichenfolge wird unverändert an die-Anweisung übermittelt, die ObjectQuery<T> vom Entity Framework ausgeführt wird. Diese Abfrage ist die Quelle der Daten, die vom-Steuerelement reguliert werden EntityDataSource . Die für die-Eigenschaft angegebene Zeichenfolge Select verwendet das gleiche Format wie die Zeichenfolge, die an die- Select Methode von übergeben wird ObjectQuery<T> . Beispiele für die Verwendung der SELECT-Klausel zum Definieren einer Projektion für eine Abfrage finden Sie unter Gewusst wie: Ausführen einer Abfrage, die Objekte anonymer Typen zurückgibt.

Updates werden für projizierte Daten nicht unterstützt. Dies bedeutet, dass bei Verwendung der- Select Eigenschaft zum Angeben einer Projektion die gebundene Datenbindung keine Updates unterstützt.

Wenn Sie eine Projektion mit aktiviertem Paging definieren, müssen Sie die Eigenschaft definieren, nach der die Ergebnisse sortiert werden sollen. Dies bedeutet, dass beim Festlegen der Select -Eigenschaft auf die Definition einer Projektion und AutoPage auf festgelegt true ist, dass Sie auch die-Eigenschaft festlegen müssen OrderBy , um die Reihenfolge zu definieren, oder die AutoGenerateOrderByClause -Eigenschaft auf festlegen true und der Auflistung einen Order by-Parameter hinzufügen OrderByParameters .

Select kann nicht festgelegt werden EnableUpdate , wenn, EnableDelete oder EnableInsert aktiviert ist.

Wenn Select auf eine Abfrage festgelegt ist, die eine Projektion von Eigenschaften zurückgibt (z SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p . b.), DbDataRecord wird eine zurückgegeben.