EntityDataSource.CommandText Egenskap

Definition

Namnområde:
System.Web.UI.WebControls
Sammansättning:
System.Web.Entity.dll

Hämtar eller anger ett entitets-SQL-kommando som definierar frågan.

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

Egenskapsvärde

String

Ett string värde som är entitets-SQL-frågan.

Exempel

I följande exempel används det angivna Entity SQL-kommandot för att returnera en samling produktobjekt.

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

I följande exempel returneras en beräknad serie kolumner:

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

Kommentarer

Med CommandText kontrollens EntityDataSource egenskap kan du ange en fråga som använder ett anpassat SQL-uttryck för entitet. Precis som SELECT-instruktionen CommandText skapar en projektion av de ursprungliga data som inte är uppdateringsbara.

När egenskapen CommandText har tilldelats inaktiveras funktionerna uppdatera, infoga och ta bort. I det här fallet returnerar metoderna CanDelete, CanInsertoch CanUpdate för den relaterade EntityDataSourceView kontrollen alla .false

När egenskapen CommandText har angetts utlöses ett undantag när ExecuteSelect metoden anropas av en kontroll som är databunden till en EntityDataSource kontroll om värdet EnableInsertför , EnableUpdateeller EnableDelete är inställt på true.

CommandText Om är inställt på en fråga som returnerar en projektion av egenskaper (till exempel "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p"), returneras enDbDataRecord.

Gäller för