EntityDataSource.CommandText Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Ruft einen Entity SQL-Befehl ab, der die Abfrage definiert, oder legt diesen fest.

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 darstellt.

Beispiele

Im folgenden Beispiel wird der angegebene 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 bei der SELECT-Anweisung CommandText eine Projektion der ursprünglichen Daten, die nicht aktualisierbar ist.

Wenn die CommandText Eigenschaft zugewiesen wird, sind die Funktionen aktualisieren, einfügen und löschen deaktiviert. In diesem Fall geben die Methoden CanDelete, CanInsertund CanUpdate des zugehörigen EntityDataSourceView Steuerelements alle zurück false.

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

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