EntityDataSource.Include 속성

정의

네임스페이스:

System.Web.UI.WebControls

어셈블리:

System.Web.Entity.dll

쿼리 결과에 포함할 관련 개체를 지정하는 식을 가져오거나 설정합니다.

public:
 property System::String ^ Include { System::String ^ get(); void set(System::String ^ value); };

public string Include { get; set; }

member this.Include : string with get, set

Public Property Include As String

속성 값

String

쿼리 결과에 반환할 쉼표로 구분된 쿼리 경로 목록입니다.

예제

다음 XML 태그는 SalesOrderHeader 반환 된 개체와 관련 된 개체를 반환 하는 쿼리 경로를 정의 합니다 Contact . 각각 SalesOrderHeader 의 관련 SalesOrderDetail 및 Address 개체도 반환 됩니다.

<asp:EntityDataSource ID="ContactDataSource" runat="server"
    AutoGenerateWhereClause="True" ConnectionString="name=AdventureWorksEntities"
    DefaultContainerName="AdventureWorksEntities" EnableDelete="True"
    EnableInsert="True" EnableUpdate="True" EntitySetName="Contact"
    Include="SalesOrderHeader.SalesOrderDetail, SalesOrderHeader.Address">
    <WhereParameters>
        <asp:ControlParameter ControlID="customerId" Name="ContactID"
            PropertyName="Text" />
    </WhereParameters>
</asp:EntityDataSource>

이전 XML 예제는 다음의 명명 된와 동일 ObjectQuery<T> 합니다 customers .

ObjectQuery<Contact> customers =
      context.Contact
       .Where("it.ContactID = @ContactID",
         new ObjectParameter("ContactID", customerId))
        .Include("SalesOrderHeader.SalesOrderDetail")
        .Include("SalesOrderHeader.Address");

설명

Include컨트롤의 속성은 구체적으로 쿼리 된 EntityDataSource 개체와 함께 반환 되는 개체를 정의 하는 쉼표로 구분 된 쿼리 경로 목록을 지정 합니다. 문자열의 쉼표로 구분 된 각 값은 수정 없이 Include Entity Framework에서 실행 되는의 메서드에 대 한 별도의 호출로 전달 됩니다 ObjectQuery<T> . 이 쿼리는 컨트롤에 의해 규제 되는 데이터의 소스입니다 EntityDataSource . Include속성은 실행 되기 전에에 적용 되는 인수입니다 ObjectQuery<T> .

속성에 제공 된 문자열은 Include 의 메서드에 전달 된 문자열과 동일한 형식을 사용 합니다 Include ObjectQuery<T> . 쿼리 경로를 사용 하 여 관련 개체를 자동으로 로드 하는 방법에 대 한 예제 는 방법: 쿼리 경로를 사용 하 여 결과 모양표시를 참조 하세요.

Include속성이 쿼리 경로를 지정 하는 데 사용 되는 경우 관련 엔터티의 속성은 읽기 전용 데이터 바인딩에만 사용할 수 있습니다. 쿼리 경로에 관련 개체가 명시적으로 포함 되어 있지 않으면 속성 설명자를 데이터 바인딩에 계속 사용할 수 있지만 속성 자체가 null 값을 반환 합니다. 이 경우 해당 값을 표시 하려면 관련 개체를 명시적으로 로드 해야 합니다. 자세한 내용은 관련 개체 로드를 참조 하세요.