LinqDataSource Sınıf

Tanım

Bir veri nesnesinden veri almak ve değiştirmek için işaretleme metni aracılığıyla bir ASP.NET Web sayfasında Language-Integrated Sorgu (LINQ) kullanımını sağlar.

public ref class LinqDataSource : System::Web::UI::DataSourceControl, System::Web::DynamicData::IDynamicDataSource
public ref class LinqDataSource : System::Web::UI::WebControls::ContextDataSource, System::Web::DynamicData::IDynamicDataSource
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")]
public class LinqDataSource : System.Web.UI.DataSourceControl, System.Web.DynamicData.IDynamicDataSource
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")]
public class LinqDataSource : System.Web.UI.WebControls.ContextDataSource, System.Web.DynamicData.IDynamicDataSource
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")>]
type LinqDataSource = class
    inherit DataSourceControl
    interface IDynamicDataSource
    interface IDataSource
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")>]
type LinqDataSource = class
    inherit ContextDataSource
    interface IDynamicDataSource
    interface IDataSource
Public Class LinqDataSource
Inherits DataSourceControl
Implements IDynamicDataSource
Public Class LinqDataSource
Inherits ContextDataSource
Implements IDynamicDataSource
Devralma
Devralma
Öznitelikler
Uygulamalar

Örnekler

Aşağıdaki örnekte adlı Productsbir LinqDataSource varlık sınıfından veri alan bir denetim gösterilmektedir. Varlık sınıfı, O/R Tasarım Aracı veya SqlMetal.exe yardımcı programı kullanılarak oluşturulmuş olabilir. Where özelliği, yalnızca özelliğinde değeri 50'den Price büyük olan kayıtları döndürecek şekilde ayarlanır. Bir GridView denetim, verileri görüntülemek için denetime bağlıdır LinqDataSource .

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Aşağıdaki örnekte, kullanıcıların veri kaynağındaki kayıtları güncelleştirmesine, silmesine ve eklemesine olanak tanıyan bir LinqDataSource denetim gösterilmektedir. Denetim DetailsView denetime LinqDataSource bağlıdır ve kullanıcıların verileri görmesine ve değiştirmesine olanak tanır. Kayıtları seçmek, güncelleştirmek, silmek veya eklemek için sql komutu gerekmemektedir.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

Aşağıdaki örnekte, veri nesnesini Web sayfasındaki bir değere göre ayarlayan olay için Selecting bir olay işleyicisi gösterilmektedir.

public partial class Default3 : System.Web.UI.Page
{
    string[] citiesArray = 
    { 
        "Atlanta", 
        "Charlotte", 
        "Denver", 
        "New York", 
        "San Francisco" 
    };

    protected void Page_Load(object sender, EventArgs e)
    {
    }

    protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
    {
        var cities = from city in citiesArray
                     where city.CompareTo("B") > 0
                     select city;
        e.Result = cities;
        // Or we could set e.Result = citiesArray to return all rows.
    }
}
Partial Class Default3
    Inherits System.Web.UI.Page

    Dim citiesArray() As String = _
    { _
        "Atlanta", _
        "Charlotte", _
        "Denver", _
        "New York", _
        "San Francisco" _
    }


    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
       
    End Sub

    
    Protected Sub LinqDataSource_Selecting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceSelectEventArgs) Handles LinqDataSource1.Selecting
        Dim cities = From city In citiesArray _
                     Where city > "B" _
                     Select city
        e.Result = cities
        ' Or we could set e.Result = citiesArray to return all rows.
    End Sub
    
End Class

Aşağıdaki örnekte, iki sütuna göre gruplandırmak üzere yapılandırılmış bir LinqDataSource denetim gösterilmektedir. Key özelliği, ve Coloriki özelliği ProductCategory olan bir nesneye başvurur. tarafından It temsil edilen nesne olarak yeniden adlandırılır (diğer adla adlandırılır).Products Yeniden adlandırılan Products nesne, bir gruplandırmadaki tek tek kayıtların koleksiyonunu içerir. Her örnek, tablodaki tüm sütunları Products içerir.

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>
<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

Aşağıdaki örnekte, önceki örnekte yer alan denetimden verileri LinqDataSource görüntüleyen iki ListView denetim gösterilmektedir. Denetimlerden biri ListView gruplandırılmış verileri, diğer ListView denetim ise o gruba ait ürünlerin tek tek adlarını görüntüler. İç içe veriye bağlı denetimin DataSource özelliği, nesnenin diğer adı It olan olarak ayarlanırProducts.

<asp:ListView 
    DataSourceID="LinqDataSource1" 
    ID="ListView1" runat="server">

    <LayoutTemplate>
      <table id="Table1" 
          style="background-color:Teal;color:White" 
          runat="server" 
          class="Layout">
          
        <thead>
          <tr>
            <th><b>Product Category</b></th>
            <th><b>Color</b></th>
            <th><b>Highest Price</b></th>
            <th><b>Lowest Price</b></th>
          </tr>
        </thead>
        <tr runat="server" id="itemPlaceholder">
        </tr>
        
      </table>
    </LayoutTemplate>

    <ItemTemplate>
      <tr>
        <td><%# Eval("key.ProductCategory") %></td>
        <td><%# Eval("key.Color") %></td>
        <td><%# Eval("MaxListPrice") %></td>
        <td><%# Eval("MinListPrice") %></td>
      </tr>
      <tr>
        
        <td colspan="4" style="width:100%;background-color:White;color:Black">
          <asp:ListView 
            DataSource='<%# Eval("Products") %>' 
            runat="server" 
            ID="ListView2">

            <LayoutTemplate>
              <div runat="server" id="itemPlaceholder" />
            </LayoutTemplate>

            <ItemTemplate>
              <%# Eval("ProductName") %><br />
            </ItemTemplate>

          </asp:ListView> 
        </td>
      </tr>
    </ItemTemplate>
  </asp:ListView>
<asp:ListView 
   DataSourceID="LinqDataSource1" 
   ID="ListView1" runat="server">

   <LayoutTemplate>
     <table id="Table1" 
         style="background-color:Teal;color:White" 
         runat="server" 
         class="Layout">
         
       <thead>
         <tr>
           <th><b>Product Category</b></th>
           <th><b>Color</b></th>
           <th><b>Highest Price</b></th>
           <th><b>Lowest Price</b></th>
         </tr>
       </thead>
       <tr runat="server" id="itemPlaceholder">
       </tr>
       
     </table>
   </LayoutTemplate>

   <ItemTemplate>
     <tr>
       <td><%# Eval("key.ProductCategory") %></td>
       <td><%# Eval("key.Color") %></td>
       <td><%# Eval("MaxListPrice") %></td>
       <td><%# Eval("MinListPrice") %></td>
     </tr>
     <tr>
       
       <td colspan="4" style="width:100%;background-color:White;color:Black">
         <asp:ListView 
           DataSource='<%# Eval("Products") %>' 
           runat="server" 
           ID="ListView2">

           <LayoutTemplate>
             <div runat="server" id="itemPlaceholder" />
           </LayoutTemplate>

           <ItemTemplate>
             <%# Eval("ProductName") %><br />
           </ItemTemplate>

         </asp:ListView> 
       </td>
     </tr>
   </ItemTemplate>
 </asp:ListView>

Açıklamalar

Bu konuda:

Giriş

Language-Integrated Sorgusu (LINQ), dolaşma, filtreleme ve yansıtma işlemlerinin herhangi bir içinde bildirim temelli bir şekilde ifade edilmesine olanak tanıyan bir dizi sorgu işlecini tanımlayan bir sorgu söz dizimidir. NET tabanlı programlama dili. Veri nesnesi bellek içi veri koleksiyonu veya veritabanındaki verileri temsil eden bir nesne olabilir. Her işlem için SQL komutları yazmak zorunda kalmadan verileri alabilir veya değiştirebilirsiniz.

Denetim, LinqDataSource işaretleme metninde özellikleri ayarlayarak ASP.NET Web sayfasında LINQ kullanmanızı sağlar. Denetim, LinqDataSource veri komutlarını otomatik olarak oluşturmak için LINQ to SQL kullanır. LINQ to SQL hakkında daha fazla bilgi için bkz. LINQ to SQL.

Bellek içi veri koleksiyonundan veri alırken, özelliğini veri koleksiyonunu içeren sınıfa ayarlarsınız ContextTypeName . Özelliği, veri koleksiyonunu döndüren özellik veya alana ayarlarsınız TableName . Örneğin, dize Person değerleri dizisi döndüren adlı özelliği içeren adlı FavoriteCities bir sınıfınız olabilir. Bu durumda, özelliğini olarak Person ve ContextTypeName özelliğini FavoriteCitiesolarak ayarlarsınızTableName.

Veritabanını sorgularken, önce veritabanını ve tablolarını temsil eden varlık sınıfları oluşturmanız gerekir. Bu sınıfları oluşturmak için Nesne İlişkisel Tasarımcısı veya SqlMetal.exe yardımcı programını kullanabilirsiniz. Ardından ContextTypeName , özelliğini veritabanını temsil eden sınıfa ve özelliğini de veritabanı tablosunu temsil eden özelliğe ayarlarsınız TableName .

İşlemlerin Sırası

Denetim, LinqDataSource veri işlemlerini aşağıdaki sırayla uygular:

  1. Where (döndürülecek veri kayıtlarını belirtin).

  2. Sıralama Ölçütü (sıralama).

  3. Gruplandırma Ölçütü (değerleri paylaşan veri kayıtlarını toplama).

  4. Grupları Sıralama Ölçütü (gruplandırılmış verileri sıralama).

  5. Seçin (döndürülecek alanları veya özellikleri belirtin).

  6. Otomatik sıralama (veri kayıtlarını kullanıcının seçtiği özelliğe göre sıralayın).

  7. Otomatik sayfa (kullanıcı tarafından seçilen veri kayıtlarının bir alt kümesini alma).

Bir sorgudan döndürülen veri kayıtlarını filtrelemek için özelliğine koşullar Where ekleyebilirsiniz. Where Özelliği ayarlanmadıysa, LinqDataSource denetim veri nesnesinden her kaydı alır.

Verileri Sıralama

Sıralama ölçütü olarak döndürülen verilerden özelliklerin adlarını belirtmek için özelliğini kullanırsınız OrderBy .

Not

denetimi SQL Server 2000 veya SQL Server Compact 3.5 ile kullandığınızda LinqDataSource ve özelliği olarak trueayarlandığında, özelliğinde OrderBy bir AutoPage değer sağlamanız gerekir. Varsayılan olarak özelliği AutoPage şeklindedir true. özelliğine Select bir değer atarsanız, sorguda döndürülen özellikler listesine tüm kimlik sütunlarını da eklemeniz gerekir.

Verileri Gruplandırma

aynı değerlere GroupBy sahip veri kayıtlarını birleştirmek için hangi özelliklerin kullanılacağını belirtmek için özelliğini kullanırsınız. Verileri gruplandırırken, özelliğine dinamik olarak oluşturulan özellikler Select olan ve ItekleyebilirsinizKey. özelliği, Key özelliğindeki değerlere veya verileri gruplandırmak için kullanılan özelliklere başvurur. Örneğin, adlı CategoryKey bir özelliğe göre gruplandırıyorsanız, özelliği özelliğindeki Category tüm benzersiz değerleri içerir. özelliği, It bir veri grubundaki tek tek kayıtların koleksiyonunu ifade eder. Gruplandırma işleminde birleştirilmiş tek tek kayıtları almak için özelliğini yineleyebilirsiniz It . Örneğin, adlı CategoryIt bir özelliğe göre gruplandırma yaparsanız özelliği, özelliğinde Category ortak bir değeri paylaşan tüm tek tek kayıtları içerir.

Gruplandırılan verileri sıralamak için kullanılacak özellikleri belirtmek için özelliğini kullanırsınız OrderGroupsBy . Verileri gruplandırdığınızda özelliği, OrderBy gruplandırılmış veriler içindeki tek tek kayıtların nasıl sıralanacağını belirtir.

Varsayılan olarak, LinqDataSource denetim bir veri nesnesinden tüm özelliklerin değerlerini alır. Kullanılabilir özelliklerin Select bir alt kümesiyle çalışmak istiyorsanız döndürülecek özellikleri belirtmek için özelliğini kullanırsınız. Select işlemi Where, Order By ve Group By işlemlerinin ardından uygulanır. Bu nedenle, Select yan tümcesinde diğer ad oluşturursanız diğer ad diğer yan tümcelerde kullanılamaz.

Veri Değişiklikleri

, EnableInsertve EnableUpdate özelliklerini kullanarak veri değişikliklerinin EnableDeleteetkinleştirilip etkinleştirilmeyeceğini belirtebilirsiniz. Bir denetimdeki LinqDataSource verileri değiştirmek için kullanıcı arabirimi genellikle bir denetim gibi DetailsView veriye bağlı denetim aracılığıyla sağlanır. , EnableInsertveya EnableUpdate ayarına EnableDeletetrueek olarak, otomatik veri değişikliklerini etkinleştirmek için aşağıdaki koşullar gereklidir:

Veriye bağlı denetimde hangi özelliklerin görüntüleneceğini iki şekilde kısıtlayabilirsiniz. Özelliği özelliklerin Select bir alt kümesine ayarlayabilir veya denetim ekleyerek DataControlField veriye bağlı denetimin alanlarını tanımlayabilirsiniz. Ancak, özelliğini ayarlarsanız Select , bu otomatik güncelleştirme, ekleme ve silme işlemlerinin etkinleştirilemeyeceği anlamına gelir. Kullanılabilir özelliklerin bir alt kümesiyle çalışırken otomatik veri değişikliklerini etkinleştirmek istiyorsanız, özelliği ayarlamayın Select . Bunun yerine, veri nesnesinden tüm özellikleri alın ve veriye bağlı denetimi kullanarak hangilerinin görüntüleneceğini yönetin. Denetimi veya GridView denetimi kullandığınızdaDetailsView, veya AutoGenerateColumns özelliklerini falseolarak da ayarlamanız AutoGenerateRows gerekir. Bu, veriye bağlı denetimin verileri düzenlemeye ve silmeye yönelik düğmeleri otomatik olarak eklemesini önler. Veriye bağlı denetimde görüntülenmeyen tüm değerler görünüm durumunda depolanır. Bunlar, veri güncelleştirmesi gerçekleştirildiğinde veri kaynağına değiştirilmeden geçirilir.

Çalışma Zamanında Değerleri Değerlendirme

Değerleri sıralamak, filtrelemek veya gruplandırmak için çalışma zamanında değerlendirmeniz gerekiyorsa, , GroupByParameters, OrderGroupsByParametersveya OrderByParameters koleksiyonlarına WhereParametersparametre ekleyebilirsiniz.

Varsayılan değerleri belirtmek istiyorsanız koleksiyona InsertParameters parametre ekleyebilirsiniz.

Veri işlemi yürütülmeden önce değerleri incelemek veya değiştirmek istiyorsanız , Inserting, Selectingveya Updating olaylarını Deletingişleyebilirsiniz. Veri işlemini iptal etmek veya kullanıcı girişine göre veri sınıfında özellikleri ayarladığınızda oluşan doğrulama hatalarını incelemek için de bu olayları işleyebilirsiniz.

Veri işlemi tamamlandıktan sonra değerleri incelemek için , Inserted, Selectedveya Updated olaylarını Deletedişleyebilirsiniz.

Saklı Yordamlarla Çalışma

Denetimi, olay için bir olay işleyicisi oluşturarak saklı yordamdan veri almak için Selecting kullanırsınızLinqDataSource. Olay işleyicisinde, saklı yordamı temsil eden veri bağlamı sınıfında yöntemini çağırır ve sonucu nesnenin ResultLinqDataSourceSelectEventArgs özelliğine ayarlarsınız. Veriler için otomatik güncelleştirme, ekleme ve silme işlemlerini etkinleştirmek istiyorsanız, yönteminden döndürülen türün özelliğinde belirtilen türle TableName eşleşmesi gerekir. Veri bağlamı yöntemleri oluşturma hakkında daha fazla bilgi için bkz. Nasıl yapılır: Saklı yordamlara ve işlevlere eşlenen DataContext yöntemleri oluşturma (O/R Tasarım Aracı).

Tanımlayıcı Sözdizimi

<asp:LinqDataSource  
    AutoGenerateOrderByClause="True|False"  
    AutoGenerateWhereClause="True|False"  
    AutoPage="True|False"  
    AutoSort="True|False"  
    ContextTypeName="string"  
    EnableDelete="True|False"  
    EnableInsert="True|False"  
    EnableTheming="True|False"  
    EnableUpdate="True|False"  
    EnableViewState="True|False"  
    GroupBy="string"  
    ID="string"  
    OnContextCreated="ContextCreated event handler"  
    OnContextCreating="ContextCreating event handler"  
    OnContextDisposing="ContextDisposing event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDeleted="Deleted event handler"  
    OnDeleting="Deleting event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnInserted="Inserted event handler"  
    OnInserting="Inserting event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnSelected="Selected event handler"  
    OnSelecting="Selecting event handler"  
    OnUnload="Unload event handler"  
    OnUpdated="Updated event handler"  
    OnUpdating="Updating event handler"  
    OrderBy="string"  
    runat="server"  
    Select="string"  
    SkinID="string"  
    StoreOriginalValuesInViewState="True|False"  
    TableName="string"  
    Visible="True|False"  
    Where="string"  
>  
        <GroupByParameters />  
        <InsertParameters />  
        <OrderByParameters />  
        <SelectParameters />  
        <WhereParameters />  
</asp:LinqDataSource>  

Oluşturucular

LinqDataSource()

LinqDataSource sınıfının yeni bir örneğini başlatır.

Özellikler

Adapter

Denetim için tarayıcıya özgü bağdaştırıcıyı alır.

(Devralındığı yer: Control)
AppRelativeTemplateSourceDirectory

Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar.

(Devralındığı yer: Control)
AutoGenerateOrderByClause

Denetimin koleksiyondaki LinqDataSourceOrderByParameters değerleri temel alan bir Order By yan tümcesini dinamik olarak oluşturup oluşturmadığını belirten bir değer alır veya ayarlar.

AutoGenerateWhereClause

Denetimin koleksiyonda LinqDataSourceWhereParameters tanımlanan değerlere göre dinamik olarak where yan tümcesi oluşturup oluşturmadığını belirten bir değer alır veya ayarlar.

AutoPage

Denetimin çalışma zamanında verilerin bölümleri arasında gezinmeyi destekleyip desteklemediğini LinqDataSource belirten bir değer alır veya ayarlar.

AutoSort

Denetimin çalışma zamanında verileri sıralamayı destekleyip desteklemediğini LinqDataSource belirten bir değer alır veya ayarlar.

BindingContainer

Bu denetimin veri bağlamasını içeren denetimi alır.

(Devralındığı yer: Control)
ChildControlsCreated

Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ClientID

ASP.NET tarafından oluşturulan sunucu denetim tanımlayıcısını alır.

(Devralındığı yer: DataSourceControl)
ClientIDMode

Bu özellik veri kaynağı denetimleri için kullanılmaz.

(Devralındığı yer: DataSourceControl)
ClientIDSeparator

özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır.

(Devralındığı yer: Control)
Context

HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır.

(Devralındığı yer: Control)
ContextTypeName

Değeri almak istediğiniz verileri içeren özelliği içeren türün adını alır veya ayarlar.

Controls

Kullanıcı arabirimi hiyerarşisinde belirtilen sunucu ControlCollection denetimi için alt denetimleri temsil eden bir nesnesi alır.

(Devralındığı yer: DataSourceControl)
DataItemContainer

Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DataKeysContainer

Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DeleteParameters

Bu özellik sınıfı tarafından LinqDataSource kullanılmaz.

DesignMode

Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
EnableDelete

Veri kayıtlarının denetim aracılığıyla LinqDataSource silinip silinemeyeceğini belirten bir değer alır veya ayarlar.

EnableInsert

Veri kayıtlarının denetim aracılığıyla eklenip eklenemeyeceğini LinqDataSource belirten bir değer alır veya ayarlar.

EnableObjectTracking

Veri bağlamı nesnesinde yapılan değişikliklerin izlenip izlenmediğini gösteren değeri alır veya ayarlar.

EnableTheming

Bu denetimin temaları destekleyip desteklemediğini belirten bir değer alır.

(Devralındığı yer: DataSourceControl)
EnableUpdate

Veri kayıtlarının denetim aracılığıyla LinqDataSource güncelleştirilip güncelleştirilemeyeceğini belirten bir değer alır veya ayarlar.

EnableViewState

Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip taşımadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
EntitySetName

Veri toplamayı temsil eden veri kaynağı nesnesindeki özelliğin veya alanın adını alır veya ayarlar.

(Devralındığı yer: ContextDataSource)
EntityTypeName

Ekle, Sil ve Güncelleştir işlemleri için oluşturulan türün adını alır veya ayarlar.

(Devralındığı yer: ContextDataSource)
Events

Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır.

(Devralındığı yer: Control)
GroupBy

Alınan verileri gruplandırma için hangi özelliklerin kullanılacağını belirten bir değer alır veya ayarlar.

GroupByParameters

Group By yan tümcesini oluşturmak için kullanılan parametre koleksiyonunu alır.

HasChildViewState

Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: Control)
ID

Sunucu denetimine atanan programlı tanımlayıcıyı alır veya ayarlar.

(Devralındığı yer: Control)
IdSeparator

Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır.

(Devralındığı yer: Control)
InsertParameters

Ekleme işlemi sırasında kullanılan parametre koleksiyonunu alır.

IsChildControlStateCleared

Bu denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: Control)
IsTrackingViewState

Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini belirten bir değer alır.

(Devralındığı yer: Control)
IsViewStateEnabled

Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: Control)
LoadViewStateByID

Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
NamingContainer

Aynı özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına ID başvuru alır.

(Devralındığı yer: Control)
OrderBy

Alınan verileri sıralamak için hangi alanların kullanıldığını belirten bir değer alır veya ayarlar.

OrderByParameters

Order By yan tümcesini oluşturmak için kullanılan parametre koleksiyonunu alır.

OrderGroupsBy

Gruplandırılmış verileri sıralamak için kullanılan alanları alır veya ayarlar.

OrderGroupsByParameters

Order Groups By yan tümcesini oluşturmak için kullanılan parametre koleksiyonunu alır.

Page

Sunucu denetimini içeren örneğe başvuru Page alır.

(Devralındığı yer: Control)
Parent

Sayfa denetimi hiyerarşisindeki sunucu denetiminin üst denetimine başvuru alır.

(Devralındığı yer: Control)
RenderingCompatibility

HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır.

(Devralındığı yer: Control)
Select

Alınan verilere dahil edilen özellikleri ve hesaplanan değerleri alır veya ayarlar.

SelectParameters

Veri alma işlemi sırasında kullanılan parametrelerin koleksiyonunu alır.

Site

Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır.

(Devralındığı yer: Control)
SkinID

Denetime uygulanacak kaplamayı DataSourceControl alır.

(Devralındığı yer: DataSourceControl)
StoreOriginalValuesInViewState

Verilerin güncelleştirilmeden veya silinmeden önce başka bir işlem tarafından değiştirilmediğinden emin olmak için veri kaynağındaki verilerin görünüm durumunda depolanması gerekip gerekmediğini belirten bir değer alır veya ayarlar.

TableName

Veri toplamayı temsil eden veri bağlamı sınıfında özelliğin veya alanın adını alır veya ayarlar.

TemplateControl

Bu denetimi içeren şablona başvuru alır veya ayarlar.

(Devralındığı yer: Control)
TemplateSourceDirectory

geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır.

(Devralındığı yer: Control)
UniqueID

Sunucu denetimi için benzersiz, hiyerarşik nitelenmiş tanımlayıcıyı alır.

(Devralındığı yer: Control)
UpdateParameters

Bu koleksiyon sınıfı tarafından LinqDataSource kullanılmaz.

ValidateRequestMode

Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini gösteren bir değer alır veya ayarlar.

(Devralındığı yer: Control)
ViewState

Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır.

(Devralındığı yer: Control)
ViewStateIgnoresCase

Nesnenin StateBag büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ViewStateMode

Bu denetimin görünüm durumu modunu alır veya ayarlar.

(Devralındığı yer: Control)
Visible

Denetimin görsel olarak görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: DataSourceControl)
Where

Bir kaydın alınan verilere dahil edilmesi için hangi koşulların doğru olması gerektiğini belirten bir değer alır veya ayarlar.

WhereParameters

Where yan tümcesini oluşturmak için kullanılan parametre koleksiyonunu alır.

Yöntemler

AddedControl(Control, Int32)

Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control .

(Devralındığı yer: Control)
AddParsedSubObject(Object)

Sunucu denetimine XML veya HTML gibi bir öğenin ayrıştırıldığını bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler.

(Devralındığı yer: Control)
ApplyStyleSheetSkin(Page)

Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular.

(Devralındığı yer: DataSourceControl)
BeginRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini başlatır.

(Devralındığı yer: Control)
BuildProfileTree(String, Boolean)

Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim Trace eder.

(Devralındığı yer: Control)
ClearCachedClientID()

Önbelleğe alınan ClientID değeri olarak nullayarlar.

(Devralındığı yer: Control)
ClearChildControlState()

Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildViewState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearEffectiveClientIDMode()

ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar.

(Devralındığı yer: Control)
CreateChildControls()

ASP.NET sayfa çerçevesi tarafından, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere oluşturma tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır.

(Devralındığı yer: Control)
CreateControlCollection()

Alt denetimleri depolamak için bir koleksiyon oluşturur.

(Devralındığı yer: DataSourceControl)
CreateQueryableView()

Sorgulanabilir bir görünüm döndürür.

CreateView()

Bu denetimle ilişkili sınıfının yeni bir örneğini LinqDataSourceView oluşturur.

DataBind()

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.

(Devralındığı yer: Control)
DataBind(Boolean)

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar.

(Devralındığı yer: Control)
DataBindChildren()

Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar.

(Devralındığı yer: Control)
Delete(IDictionary, IDictionary)

Silme işlemi gerçekleştirir.

Dispose()

Sunucu denetiminin bellekten çıkmadan önce son temizleme işlemini gerçekleştirmesini sağlar.

(Devralındığı yer: Control)
EndRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini sonlandırır.

(Devralındığı yer: Control)
EnsureChildControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur.

(Devralındığı yer: Control)
EnsureID()

Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur.

(Devralındığı yer: Control)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
FindControl(String)

Belirtilen id parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.

(Devralındığı yer: DataSourceControl)
FindControl(String, Int32)

Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde pathOffset belirtilen id bir tamsayı ile bir sunucu denetimi arar ve bu da aramaya yardımcı olur. Yönteminin bu sürümünü FindControl geçersiz kılmamalısınız.

(Devralındığı yer: Control)
Focus()

Giriş odağını denetime ayarlar.

(Devralındığı yer: DataSourceControl)
GetDesignModeState()

Denetim için tasarım zamanı verilerini alır.

(Devralındığı yer: Control)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetRouteUrl(Object)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(RouteValueDictionary)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, Object)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, RouteValueDictionary)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
GetUniqueIDRelativeTo(Control)

Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür.

(Devralındığı yer: Control)
GetView(String)

Nesnesiyle LinqDataSource ilişkili veri kaynağı görünümünü döndürür.

GetView(String)

Nesnesiyle QueryableDataSource ilişkili veri kaynağı görünümünü alır.

(Devralındığı yer: QueryableDataSource)
GetViewNames()

Denetimle LinqDataSource ilişkili görünüm nesnelerinin listesini temsil eden bir ad koleksiyonu döndürür.

GetViewNames()

Denetimle QueryableDataSource ilişkili görünümleri temsil eden bir ad koleksiyonu alır.

(Devralındığı yer: QueryableDataSource)
HasControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler.

(Devralındığı yer: DataSourceControl)
HasEvents()

Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini belirten bir değer döndürür.

(Devralındığı yer: Control)
Insert(IDictionary)

Ekleme işlemi gerçekleştirir.

IsLiteralContent()

Sunucu denetiminin yalnızca değişmez içeriği barındırdığını belirler.

(Devralındığı yer: Control)
LoadControlState(Object)

yöntemi tarafından SaveControlState() kaydedilen önceki bir sayfa isteğinden denetim durumu bilgilerini geri yükler.

(Devralındığı yer: Control)
LoadViewState(Object)

Denetimdeki kalıcı olması gereken değerlerin LinqDataSource durumunu yükler.

LoadViewState(Object)

Denetimdeki kalıcı olması gereken değerlerin QueryableDataSource durumunu yükler.

(Devralındığı yer: QueryableDataSource)
MapPathSecure(String)

Mutlak veya göreli bir sanal yolun eşlendiğini fiziksel yolu alır.

(Devralındığı yer: Control)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnBubbleEvent(Object, EventArgs)

Sunucu denetimi olayının sayfanın kullanıcı arabirimi sunucu denetimi hiyerarşisine geçirilip geçirilmeyeceğini belirler.

(Devralındığı yer: Control)
OnDataBinding(EventArgs)

Olayı tetikler DataBinding .

(Devralındığı yer: Control)
OnInit(EventArgs)

LinqDataSource Nesnesini başlatır.

OnLoad(EventArgs)

Olayı tetikler Load .

(Devralındığı yer: Control)
OnPreRender(EventArgs)

Olayı tetikler PreRender .

(Devralındığı yer: Control)
OnUnload(EventArgs)

Olayı tetikler Unload .

OpenFile(String)

Stream Bir dosyayı okumak için kullanılan alır.

(Devralındığı yer: Control)
RaiseBubbleEvent(Object, EventArgs)

Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar.

(Devralındığı yer: Control)
RaiseDataSourceChangedEvent(EventArgs)

Olayı tetikler DataSourceChanged .

(Devralındığı yer: DataSourceControl)
RaiseViewChanged()

OnDataSourceViewChanged(EventArgs) sınıfının yöntemini DataSourceView çağırır.

(Devralındığı yer: QueryableDataSource)
RemovedControl(Control)

Bir alt denetim nesne koleksiyonundan Controls kaldırıldıktan sonra çağrılır Control .

(Devralındığı yer: Control)
Render(HtmlTextWriter)

Sunucu denetimi içeriğini, istemcide işlenecek içeriği yazan sağlanan HtmlTextWriter bir nesneye gönderir.

(Devralındığı yer: Control)
RenderChildren(HtmlTextWriter)

Sunucu denetiminin alt öğelerinin içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve istemcide işlenecek içeriği yazar.

(Devralındığı yer: Control)
RenderControl(HtmlTextWriter)

Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

(Devralındığı yer: DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Sağlanan bir nesneyi kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye aktarır.

(Devralındığı yer: Control)
ResolveAdapter()

Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır.

(Devralındığı yer: Control)
ResolveClientUrl(String)

Tarayıcı tarafından kullanılabilecek bir URL alır.

(Devralındığı yer: Control)
ResolveUrl(String)

URL'yi istekte bulunan istemcide kullanılabilen bir URL'ye dönüştürür.

(Devralındığı yer: Control)
SaveControlState()

Sayfa sunucuya geri gönderildiğinden bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder.

(Devralındığı yer: Control)
SaveViewState()

Denetimin geçerli görünüm durumunu LinqDataSource kaydeder.

SaveViewState()

Denetimin geçerli görünüm durumunu QueryableDataSource kaydeder.

(Devralındığı yer: QueryableDataSource)
SetDesignModeState(IDictionary)

Denetim için tasarım zamanı verilerini ayarlar.

(Devralındığı yer: Control)
SetRenderMethodDelegate(RenderMethod)

Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar.

(Devralındığı yer: Control)
SetTraceData(Object, Object)

İzleme veri anahtarını ve izleme veri değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
SetTraceData(Object, Object, Object)

İzlenen nesneyi, izleme veri anahtarını ve izleme veri değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TrackViewState()

Değişikliklerin denetimin LinqDataSource nesnesinde depolanabilmesi için denetimdeki StateBag görünüm durumu değişikliklerini izler.

TrackViewState()

Değişikliklerin denetimin QueryableDataSource nesnesinde depolanabilmesi için denetimin StateBag görünüm durumu değişikliklerini izler.

(Devralındığı yer: QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)

Güncelleştirme işlemi gerçekleştirir.

UpdateParameterVales()

Önceki isteklerden bu yana değişen parametre değerlerini Güncelleştirmeler.

(Devralındığı yer: QueryableDataSource)

Ekinlikler

ContextCreated

Bağlam türü nesnesinin bir örneği oluşturulduktan sonra gerçekleşir.

ContextCreating

Bağlam türü nesnesinin bir örneği oluşturulmadan önce gerçekleşir.

ContextDisposing

Bağlam türü nesnesini yok etmeden önce gerçekleşir.

DataBinding

Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir.

(Devralındığı yer: Control)
Deleted

Silme işlemi tamamlandığında gerçekleşir.

Deleting

Silme işleminden önce gerçekleşir.

Disposed

ASP.NET bir sayfa istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir.

(Devralındığı yer: Control)
Init

Sunucu denetimi başlatıldığında gerçekleşir. Bu, yaşam döngüsünün ilk adımıdır.

(Devralındığı yer: Control)
Inserted

Ekleme işlemi tamamlandığında gerçekleşir.

Inserting

Ekleme işleminden önce gerçekleşir.

Load

Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir.

(Devralındığı yer: Control)
PreRender

Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir.

(Devralındığı yer: Control)
QueryCreated

Veri kaynağı denetimine bir sorgu eklendiğinde veya bu denetimden kaldırıldığında gerçekleşir.

(Devralındığı yer: QueryableDataSource)
Selected

Veri alma işlemi tamamlandığında gerçekleşir.

Selecting

Veri alma işleminden önce gerçekleşir.

Unload

Sunucu denetimi bellekten kaldırıldığında gerçekleşir.

(Devralındığı yer: Control)
Updated

Güncelleştirme işlemi tamamlandığında gerçekleşir.

Updating

Güncelleştirme işleminden önce gerçekleşir.

Belirtik Arabirim Kullanımları

IControlBuilderAccessor.ControlBuilder

Bu üyenin açıklaması için bkz ControlBuilder. .

(Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()

Bu üyenin açıklaması için bkz GetDesignModeState(). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Bu üyenin açıklaması için bkz SetOwnerControl(Control). .

(Devralındığı yer: Control)
IControlDesignerAccessor.UserData

Bu üyenin açıklaması için bkz UserData. .

(Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings

Bu üyenin açıklaması için bkz DataBindings. .

(Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings

Bu üyenin açıklaması için bkz HasDataBindings. .

(Devralındığı yer: Control)
IDataSource.DataSourceChanged

Veri kaynağı denetimi, veriye bağlı denetimleri etkileyecek şekilde değiştiğinde gerçekleşir.

(Devralındığı yer: DataSourceControl)
IDataSource.GetView(String)

Denetimle DataSourceControl ilişkili adlandırılmış DataSourceView nesneyi alır. Bazı veri kaynağı denetimleri yalnızca bir görünümü, bazıları ise birden çok görünümü destekler.

(Devralındığı yer: DataSourceControl)
IDataSource.GetViewNames()

Denetimle DataSourceControl ilişkili nesnelerin listesini DataSourceView temsil eden bir ad koleksiyonu alır.

(Devralındığı yer: DataSourceControl)
IDynamicDataSource.ContextType

Bu üyenin açıklaması için bkz IDynamicDataSource. .

IDynamicDataSource.EntitySetName

Bu üyenin açıklaması için bkz IDynamicDataSource. .

IDynamicDataSource.Exception

Bu üyenin açıklaması için bkz IDynamicDataSource. .

IExpressionsAccessor.Expressions

Bu üyenin açıklaması için bkz Expressions. .

(Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions

Bu üyenin açıklaması için bkz HasExpressions. .

(Devralındığı yer: Control)
IListSource.ContainsListCollection

Veri kaynağı denetiminin bir veya daha fazla veri listesiyle ilişkili olup olmadığını gösterir.

(Devralındığı yer: DataSourceControl)
IListSource.GetList()

Veri listesi kaynağı olarak kullanılabilecek veri kaynağı denetimlerinin listesini alır.

(Devralındığı yer: DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Bu üyenin açıklaması için bkz AddParsedSubObject(Object). .

(Devralındığı yer: Control)

Uzantı Metotları

ExpandDynamicWhereParameters(IDynamicDataSource)

Dinamik filtreleri veri kaynağı tarafından kullanılabilen parametrelere genişletir Where .

FindDataSourceControl(Control)

Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür.

FindFieldTemplate(Control, String)

Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür.

FindMetaTable(Control)

İçeren veri denetimi için meta tablo nesnesini döndürür.

GetDefaultValues(IDataSource)

Belirtilen veri kaynağı için varsayılan değerlerin koleksiyonunu alır.

GetMetaTable(IDataSource)

Belirtilen veri kaynağı nesnesindeki bir tablonun meta verilerini alır.

GetTable(IDynamicDataSource)

MetaTable Belirtilen veri kaynağı denetimiyle ilişkili nesneyi döndürür.

LoadWith<TEntity>(LinqDataSource)

DataLoadOptions LinQ-to-SQL veri kaynağının değerini, tüm yabancı anahtar varlıklarının yüklenmesini zorunlu kılacak şekilde ayarlar.

LoadWithForeignKeys(LinqDataSource, Type)

DataLoadOptions LinQ-to-SQL veri kaynağının değerini, tüm yabancı anahtar varlıklarının yüklenmesini zorunlu kılacak şekilde ayarlar.

TryGetMetaTable(IDataSource, MetaTable)

Tablo meta verilerinin kullanılabilir olup olmadığını belirler.

Şunlara uygulanır

Ayrıca bkz.