EntityDataSource.CommandText Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Entity.dll

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