EntityDataSource.CommandText 속성

정의

네임스페이스:

System.Web.UI.WebControls

어셈블리:

System.Web.Entity.dll

쿼리를 정의하는 Entity SQL 명령을 가져오거나 설정합니다.

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

속성 값

String

string Entity SQL 쿼리인 값입니다.

예제

다음 예제에서는 제공된 Entity SQL 명령을 사용하여 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>

다음 예제에서는 프로젝션된 일련의 열을 반환합니다.

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

설명

CommandText 컨트롤의 EntityDataSource 속성을 사용하면 사용자 지정 Entity SQL 식을 사용하는 쿼리를 지정할 수 있습니다. SELECT 문 CommandText 과 마찬가지로, 원래 데이터를 업데이터할 수 없는 프로젝션을 만듭니다.

속성이 CommandText 할당되면 업데이트, 삽입 및 삭제 기능을 사용할 수 없습니다. 이 경우 메서드 CanDelete, CanInsert및 CanUpdate 관련 EntityDataSourceView 컨트롤의 모든 반환 false합니다.

속성이 설정되면 값이 <a0/>인 경우 컨트롤에 바인딩된 데이터인 컨트롤에서 메서드를 호출하거나 메서드를 호출할 때 예외가 throw됩니다.

속성의 CommandText 프로젝션(예: "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p")을 반환하는 쿼리로 설정된 경우 반환 DbDataRecord 됩니다.