EntityDataSource.CommandText Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.Entity.dll

Pobiera lub ustawia polecenie Entity SQL definiujące zapytanie.

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

Wartość właściwości

String

string Wartość, która jest zapytaniem Entity SQL.

Przykłady

W poniższym przykładzie użyto podanego polecenia Entity SQL, aby zwrócić kolekcję obiektów 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>

Poniższy przykład zwraca rzutowaną serię kolumn:

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

Uwagi

Właściwość CommandText kontrolki EntityDataSource umożliwia określenie zapytania, które używa niestandardowego wyrażenia SQL jednostki. Podobnie jak instrukcja SELECT, CommandText tworzy projekcję oryginalnych danych, które nie są możliwe do zaktualizowania.

Po CommandText przypisaniu właściwości, aktualizowaniu, wstawiania i usuwaniu są wyłączone. W tym przypadku metody CanDelete, CanInserti CanUpdate powiązanej EntityDataSourceView kontrolki zwracają falsewartość .

CommandText Gdy właściwość jest ustawiona, zgłaszany jest wyjątek, gdy ExecuteSelect metoda jest wywoływana przez kontrolkę, która jest danymi powiązanymi z kontrolkąEntityDataSource, jeśli wartość EnableInsert, EnableUpdatelub EnableDelete jest ustawiona na true.

Jeśli parametr CommandText jest ustawiony na zapytanie zwracające projekcję właściwości (na przykład "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p"), DbDataRecord zostanie zwrócona wartość .