Freigeben über


Benutzerdefinierter Befehlstext (EntityDataSource)

Aktualisiert: November 2007

Die CommandText-Eigenschaft des EntityDataSource-Steuerelements ermöglicht Ihnen, eine Abfrage mit einem benutzerdefinierten Entity SQL-Ausdruck anzugeben. Ähnlich wie die SELECT-Anweisung erstellt der Entity SQL-Ausdruck in der CommandText-Eigenschaft eine Projektion der Originaldaten, die nicht aktualisiert werden kann.

Wenn Sie dem EntityDataSource-Steuerelement die CommandText-Eigenschaft zuweisen, können Sie mit dem Steuerelement keine Daten mehr aktualisieren, einfügen oder löschen. In diesem Fall geben die Methoden CanDelete, CanInsert und CanUpdate des zugehörigen EntityDataSourceView-Steuerelements alle false zurück.

Beispiele

Im folgenden Beispiel wird ein Entity SQL-Befehl verwendet, der an die CommandText-Eigenschaft übergeben wurde, um eine Auflistung von Entitäten zurückzugeben.

<asp:EntityDataSource ID="ProductDataSource"  
    CommandText="SELECT value p FROM Products AS p
        WHERE p.ProductID
        BETWEEN @OrderIdMin AND @OrderIdMax"
    ConnectionString="name=AdventureWorksEntities" 
    DefaultContainerName="AdventureWorksEntities" >
    <CommandParameters>
        <asp:ControlParameter Name="OrderIdMin" 
            ControlID="ProductIdMin" Type="Int32"/>
        <asp:ControlParameter Name="OrderIdMax" 
            ControlID="ProductIdMax" Type="Int32" />
    </CommandParameters>
</asp:EntityDataSource>

Im folgenden Beispiel wird eine Projektion mehrerer Spalten zurückgegeben:

    <asp:EntityDataSource ID="ProductDataSource"  
        CommandText="SELECT p.ProductID, p.ProductName, p.UnitsOnOrder
              FROM Products AS p 
              WHERE p.ProductID BETWEEN @OrderIDMin AND @OrderIDMax" 
              ContextTypeName="AdventureWorksModel. AdventureWorksEntities">
        <CommandParameters>
            <asp:ControlParameter Name="OrderIDMin" 
                    ControlID="ProductIDMin" Type="Int32"/>
            <asp:ControlParameter Name="OrderIDMax" 
                    ControlID="ProductIDMax" Type="Int32" />
        </CommandParameters>
    </asp:EntityDataSource>
 

Siehe auch

Konzepte

Datenprojektionen (EntityDataSource)

Konfigurieren des EntityDataSource-Steuerelements

Filtern von Daten (EntityDataSource)

EntityDataSource-Designer

Weitere Ressourcen

Objektabfragen (Entity Framework)