EntityDataSource.Include Özellik

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Entity.dll

Sorgu sonuçlarına eklenecek ilgili nesneleri belirten ifadeyi alır veya ayarlar.

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

Özellik Değeri

String

Sorgu sonuçlarında döndürülecek sorgu yollarının virgülle ayrılmış listesi.

Örnekler

Aşağıdaki XML işaretlemesi, döndürülen Contact nesneyle ilgili nesneleri döndüren SalesOrderHeader bir sorgu yolunu tanımlar. Her SalesOrderHeaderile ilgili SalesOrderDetail ve Address nesneleri de döndürülür.

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

Önceki XML örneği, adlı customersaşağıdakiyle ObjectQuery<T> aynıdır:

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

Açıklamalar

Include denetimin EntityDataSource özelliği, özellikle sorgulanan nesneyle birlikte döndürülen nesneleri tanımlayan sorgu yollarının virgülle ayrılmış bir listesini belirtir. Dizedeki her virgülle ayrılmış değer, Entity Framework tarafından yürütülen bir ObjectQuery<T> yöntemine Include ayrı bir çağrı olarak değiştirilmeden geçirilir. Bu sorgu, denetim tarafından düzenlenen verilerin kaynağıdır EntityDataSource . Include özelliği yürütülmeden önce öğesine ObjectQuery<T> uygulanan bağımsız değişkendir.

özelliğine sağlanan dize, yöntemine IncludeObjectQuery<T>geçirilen Include dizeyle aynı biçimi kullanır. İlgili nesneleri otomatik olarak yüklemek için sorgu yollarını kullanma örnekleri için bkz . Nasıl yapılır: Şekil Sonuçları için Sorgu Yollarını Kullanma.

Include özelliği sorgu yollarını belirtmek için kullanıldığında, ilgili varlıkların özellikleri yalnızca salt okunur veri bağlama için kullanılabilir. İlişkili nesneler sorgu yoluna açıkça dahil edilmediyse, özellik tanımlayıcıları veri bağlama için hala kullanılabilir, ancak özelliklerin kendileri null değerler döndürür. Bu durumda, değerlerini görüntülemek için ilgili nesnelerin açıkça yüklenmesi gerekir. Daha fazla bilgi için bkz . İlgili Nesneleri Yükleme.