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

Entity SQL 쿼리인 string 값입니다.

예제

다음 예에서는 제공 된 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 합니다.

CommandText속성이 설정 된 경우 ExecuteSelect EntityDataSource EnableInsert , 또는의 값 EnableUpdate EnableDelete 이로 설정 된 경우 컨트롤에 바인딩된 컨트롤에서 메서드를 호출 하면 예외가 throw 됩니다 true .

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