EntityDataSource.CommandText Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Entity.dll

Získá nebo nastaví příkaz Entity SQL, který definuje dotaz.

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

Hodnota vlastnosti

String

Hodnota string , která je dotazem Entity SQL.

Příklady

Následující příklad používá zadaný příkaz Entity SQL k vrácení kolekce product objekty.

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

Následující příklad vrátí projektovanou řadu sloupců:

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

Poznámky

CommandText Vlastnost EntityDataSource ovládacího prvku umožňuje zadat dotaz, který používá vlastní výraz Entity SQL. Podobně jako příkaz CommandText SELECT vytvoří projekci původních dat, která nelze aktualizovat.

CommandText Když je vlastnost přiřazena, aktualizovat, vložit a odstranit funkce jsou zakázány. V tomto případě metody CanDelete, CanInserta CanUpdate související EntityDataSourceView ovládací prvek všechny vrátit false.

CommandText Pokud je vlastnost nastavena, je vyvolána výjimka, když ExecuteSelect metoda je volána ovládacím prvek, který je vázán na EntityDataSource ovládací prvek, pokud hodnota EnableInsert, EnableUpdatenebo EnableDelete je nastavena na true.

CommandText Pokud je nastavena na dotaz, který vrací projekci vlastností (například "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p"), bude vrácenaDbDataRecord.