EntityDataSource.CommandText Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Dient zum Abrufen oder Festlegen eines Entitäts-SQL-Befehls, der die Abfrage definiert.

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

public string CommandText { get; set; }

member this.CommandText : string with get, set

Public Property CommandText As String

Eigenschaftswert

String

Ein string Wert, der die Entity SQL-Abfrage ist.

Beispiele

Im folgenden Beispiel wird der bereitgestellte Entity SQL-Befehl verwendet, um eine Auflistung von Product-Objekten zurückgibt.

<asp:EntityDataSource ID="ProductDataSource" runat="server"
    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 projizierte Reihe von Spalten zurückgegeben:

<asp:EntityDataSource ID="ProductDataSource" runat="server"
    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="ProductIDMinTextBox" Type="Int32"/>
        <asp:ControlParameter Name="OrderIDMax"
                ControlID="ProductIDMaxTextBox" Type="Int32" />
    </CommandParameters>
</asp:EntityDataSource>

Hinweise

Mit CommandText der Eigenschaft des EntityDataSource Steuerelements können Sie eine Abfrage angeben, die einen benutzerdefinierten Entity SQL-Ausdruck verwendet. Erstellt wie die SELECT-Anweisung eine Projektion der ursprünglichen Daten, CommandText die nicht aktualisierbar sind.

Wenn die CommandText Eigenschaft zugewiesen ist, werden die Funktionen zum Aktualisieren, Einfügen und Löschen deaktiviert. In diesem Fall geben die Methoden CanDelete, , CanInsertund CanUpdate des zugehörigen EntityDataSourceView Steuerelements alle zurückgeben false.

Wenn die CommandText Eigenschaft festgelegt wird, wird eine Ausnahme ausgelöst, wenn die ExecuteSelect Methode von einem Steuerelement aufgerufen wird, das an ein EntityDataSource Steuerelement gebunden ist, wenn der Wert von EnableInsert, EnableUpdateoder EnableDelete auf true.

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