EntityDataSource.CommandText Properti

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.Entity.dll

Mendapatkan atau mengatur perintah Entity SQL yang menentukan kueri.

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

Nilai Properti

String

string Nilai yang merupakan kueri SQL Entitas.

Contoh

Contoh berikut menggunakan perintah SQL Entitas yang disediakan untuk mengembalikan kumpulan objek Produk.

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

Contoh berikut mengembalikan rangkaian kolom yang diproyeksikan:

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

Keterangan

Properti CommandTextEntityDataSource kontrol memungkinkan Anda menentukan kueri yang menggunakan ekspresi SQL Entitas kustom. Seperti pernyataan SELECT, CommandText membuat proyeksi data asli yang tidak dapat diperbarui.

CommandText Saat properti ditetapkan, perbarui, sisipkan, dan hapus fungsionalitas dinonaktifkan. Dalam hal ini, metode CanDelete, , dan CanUpdate kontrol terkait EntityDataSourceView semuanya mengembalikan falseCanInsert.

CommandText Ketika properti diatur, pengecualian dilemparkan ketika ExecuteSelect metode dipanggil oleh kontrol yang terikat data ke EntityDataSource kontrol jika nilai EnableInsert, EnableUpdate, atau EnableDelete diatur ke true.

CommandText Jika diatur ke kueri yang mengembalikan proyeksi properti (misalnya, "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p"), akan DbDataRecord dikembalikan.