EntityDataSource.Select Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Dient zum Abrufen oder Festlegen der Projektion, die die Eigenschaften definiert, die in die Abfrageergebnisse eingeschlossen werden sollen.

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 und den Wert von EnableUpdate, EnableDeleteoder EnableInsert ist .true

Beispiele

Das folgende XML-Markup verwendet die Select Eigenschaft, um eine Projektion mit sechs der 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 identisch mit dem folgenden ObjectQuery<T> Namen 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 Steuerelements enthält eine Zeichenfolge, die die SELECT-Anweisung einer Entity SQL-Abfrage darstellt. Auf diese Weise können Sie einen angegebenen Satz von Eigenschaften aus den von der Abfrage zurückgegebenen Objekten projizieren.

Diese Zeichenfolge wird ohne Änderung an die ObjectQuery<T> vom Entity Framework ausgeführte Zeichenfolge übergeben. Diese Abfrage ist die Quelle der durch das EntityDataSource Steuerelement regulierten Daten. Die für die Select Eigenschaft bereitgestellte Zeichenfolge verwendet das gleiche Format wie die Zeichenfolge, die an die Select Methode von ObjectQuery<T>übergeben wird. Beispiele für die Verwendung der SELECT-Klausel zum Definieren einer Projektion für eine Abfrage finden Sie unter How to: Execute a Query that Returns Anonymous Type Objects.

Aktualisierungen werden für projizierte Daten nicht unterstützt. Dies bedeutet, dass bei Verwendung der Select Eigenschaft zum Angeben einer Projektion keine Aktualisierungen von der gebundenen Datenbindung unterstützt werden.

Wenn Sie eine Projektion mit aktivierter Paging-Funktion definieren, müssen Sie die Eigenschaft definieren, nach der die Ergebnisse sortiert werden sollen. Dies bedeutet, dass Sie die Eigenschaft beim Festlegen der Select Eigenschaft auf eine Projektion festlegen und AutoPage auf true", sie müssen auch die Eigenschaft festlegen, um die OrderBy Reihenfolge zu definieren oder die AutoGenerateOrderByClause Eigenschaft auf true die OrderByParameters Auflistung festzulegen und einen ORDER BY-Parameter hinzuzufügen.

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

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