EntityDataSource.CommandText Tulajdonság

Definíció

Névtér:

System.Web.UI.WebControls

Szerelvény:

System.Web.Entity.dll

Lekéri vagy beállítja a lekérdezést meghatározó Entity SQL-parancsot.

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

Tulajdonság értéke

String

Az string Entity SQL-lekérdezést tartalmazó érték.

Példák

Az alábbi példa a megadott Entity SQL-parancsot használja a Termékobjektumok gyűjteményének visszaadásához.

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

Az alábbi példa egy előre jelzett oszlopsorozatot ad vissza:

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

Megjegyzések

A CommandText vezérlő tulajdonsága EntityDataSource lehetővé teszi egy egyéni Entity SQL-kifejezést használó lekérdezés megadását. A SELECT utasításhoz CommandText hasonlóan létrehoz egy előrejelzést az eredeti adatokról, amelyek nem frissíthetők.

A tulajdonság hozzárendelésekor a rendszer letiltja a CommandText frissítési, beszúrási és törlési funkciókat. Ebben az esetben a metódusok CanDeleteCanInsertés CanUpdate a kapcsolódó EntityDataSourceView vezérlőelemek mind visszatérnek false.

Ha a CommandText tulajdonság be van állítva, a rendszer kivételt jelez, ha a ExecuteSelect metódust egy vezérlőelemhez EntityDataSource kötött vezérlőelem hívja meg, ha a metódus értéke EnableInsert, EnableUpdatevagy EnableDelete értéke truea következő.

Ha az CommandText érték egy olyan lekérdezésre van beállítva, amely a tulajdonságok vetületét adja vissza (például ""SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p), DbDataRecord a függvény a függvényt adja vissza.