EntityDataSource.CommandText Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.Entity.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví entity SQL příkaz, 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 objektů Product.

<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

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

CommandText Když je vlastnost přiřazená, funkce aktualizace, vložení a odstranění jsou zakázané. V tomto případě vrátí všechny metody CanDelete, CanInserta CanUpdate souvisejícího EntityDataSourceView ovládacího prvku false.

CommandText Když je vlastnost nastavena, vyvolá se výjimka, když ExecuteSelect je metoda volána ovládacím prvku, který je data svázán s ovládacím EntityDataSource prvku, pokud je hodnota EnableInsert, EnableUpdatenebo EnableDelete nastavena na true.

CommandText Pokud je parametr nastavený na dotaz, který vrací projekci vlastností (například "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p), DbDataRecord vrátí se příkaz .

Platí pro

Sdílet prostřednictvím