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

stringEntity SQL sorgusu olan bir değer.

Örnekler

Aşağıdaki örnek, bir ürün nesneleri koleksiyonunu geri 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, yansıtılan bir sütun serisini 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

CommandTextDenetimin özelliği, EntityDataSource özel bir Entity SQL ifadesi kullanan bir sorgu belirtmenize olanak sağlar. SELECT ifadesine benzer şekilde, CommandText güncelleştirilemez olmayan özgün verilerin bir projeksiyonu oluşturur.

CommandTextÖzellik atandığında, Update, INSERT ve delete işlevleri devre dışıdır. Bu durumda, CanDelete CanInsert ve CanUpdate ilgili EntityDataSourceView denetimin yöntemlerinin hepsi döndürülür false .

Özellik ayarlandığında,,, CommandText ExecuteSelect EntityDataSource EnableInsert veya değeri EnableUpdate EnableDelete olarak ayarlanmışsa, yöntemi denetime bağlanan bir denetim tarafından çağrıldığında bir özel durum oluşturulur true .

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