EntityDataSource.CommandText Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Entity.dll

Sorguyu tanımlayan bir Entity SQL komutunu alır veya ayarlar.

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

Özellik Değeri

String

string Entity SQL sorgusu olan bir değer.

Örnekler

Aşağıdaki örnek, Product nesnelerinin bir koleksiyonunu döndürmek için sağlanan Entity SQL komutunu kullanır.

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

Aşağıdaki örnek, öngörülen bir sütun serisi döndürür:

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

Açıklamalar

Denetimin CommandTextEntityDataSource özelliği, özel Entity SQL ifadesi kullanan bir sorgu belirtmenizi sağlar. SELECT deyiminde olduğu gibi, CommandText güncelleştirilebilir olmayan özgün verilerin bir projeksiyonunu oluşturur.

CommandText Özellik atandığında, güncelleştirme, ekleme ve silme işlevleri devre dışı bırakılır. Bu durumda, ilgili EntityDataSourceView denetimin , CanInsertve CanUpdate yöntemlerinin CanDeletetümü döndürürfalse.

CommandText özelliği ayarlandığında, , veya EnableDelete değeri EnableUpdateEnableInsertolarak ayarlandıysatrue, yöntemi bir denetime bağlı olan bir denetim tarafından çağrıldığında bir EntityDataSource özel durum oluşturulurExecuteSelect.

, özelliklerin CommandText projeksiyonunu döndüren bir sorguya ayarlanırsa (örneğin, "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p"), döndürülür DbDataRecord .