Aracılığıyla paylaş


LinqDataSource Sınıf

Tanım

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

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ımcısı 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ğına 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ıracak şekilde yapılandırılmış bir LinqDataSource denetim gösterilmektedir. Key özelliği, ProductCategory ve Colorolmak üzere iki özelliği 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 örnekteki denetimden LinqDataSource verileri görüntüleyen iki ListView denetim gösterilmektedir. Denetimlerden biri ListView gruplandırılmış verileri, diğer ListView denetim ise bu gruba ait olan ürünlerin adlarını tek tek görüntüler. İç içe veri 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:

Introduction

Language-Integrated Sorgusu (LINQ), herhangi bir içinde dolaşma, filtreleme ve yansıtma işlemlerinin 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 metnindeki ö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ğini, veri koleksiyonunu döndüren özellik veya alana ayarlarsınız TableName . Örneğin, dize Person değerleri dizisi döndüren adlı bir özelliği içeren adlı FavoriteCities bir sınıfınız olabilir. Bu durumda, özelliğini olarak ve ContextTypeName özelliğini olarak FavoriteCitiesayarlarsınızTableName.Person

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ı'nı veya SqlMetal.exe yardımcı programını kullanabilirsiniz. Ardından, özelliğini veritabanını temsil eden sınıfa ve ContextTypeName özelliğini de veritabanı tablosunu temsil eden özelliğe ayarlarsınız TableName .

İşlem 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 bir ö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ü OrderBy olarak döndürülen verilerden özelliklerin adlarını belirtmek için özelliğini kullanırsınız.

Uyarı

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, AutoPage özelliği true değerindedir. Ö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 verileri gruplandırmak için kullanılan özellik veya özelliklerdeki değerlere 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ılmış 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 tümcelerde diğer ad kullanılamaz.

Veri Değişiklikleri

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

Veri bağlama denetiminde hangi özelliklerin görüntüleneceğini iki yolla kısıtlayabilirsiniz. Özelliği özelliklerin Select bir alt kümesine ayarlayabilir veya denetimler ekleyerek DataControlField veriye bağlı denetimin alanlarını tanımlayabilirsiniz. Ancak özelliğini ayarlarsanız Select 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üzenleme ve silme düğmelerini 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ıralama, filtreleme veya gruplandırma için çalışma zamanında değerleri değerlendirmeniz gerekiyorsa, , GroupByParameters, OrderGroupsByParametersveya OrderByParameters koleksiyonlarına WhereParametersparametreler ekleyebilirsiniz.

Varsayılan değerleri belirtmek istiyorsanız, koleksiyona InsertParameters parametreler 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şleyebilir.

Saklı Yordamlarla Çalışma

Denetimi, LinqDataSource olay için bir olay işleyicisi oluşturarak saklı yordamdan veri almak için Selecting kullanırsınız. Olay işleyicisinde, saklı yordamı temsil eden veri bağlamı sınıfında yöntemini çağırır ve sonucu nesnesinin 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 özelliğinde belirtilen türle TableName eşleşmelidir. 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ımcısı).

Bildirim Temelli Söz Dizimi

<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

Name Description
LinqDataSource()

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

Özellikler

Name Description
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 LinqDataSource değerleri temel alan bir Order By yan tümcesi oluşturup oluşturmadığını gösteren bir değer OrderByParameters alır veya ayarlar.

AutoGenerateWhereClause

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

AutoPage

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

AutoSort

Denetimin çalışma zamanında verileri sıralamayı LinqDataSource destekleyip desteklemediğini 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

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

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

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

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

Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına 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 gösteren 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 gösteren 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 okunurdur.

(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ı gösteren 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 parametrelerin koleksiyonunu alır.

IsChildControlStateCleared

Bu denetimin içindeki denetimlerin denetim durumuna sahip olup olmadığını gösteren bir değer alır.

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

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

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

Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini gösteren 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ı gösteren bir değer alır.

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

Aynı ID ö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 başvuru alır.

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

Alınan verileri sıralamak için hangi alanların kullanılacağı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şisinde 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 DataSourceControl cildi 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 gösteren 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 duyarsız 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ülenmediğini belirten bir değer alır veya ayarlar.

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

Alınan verilere bir kaydın 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

Name Description
AddedControl(Control, Int32)

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

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

Xml veya HTML gibi bir öğenin ayrıştırıldığını sunucu denetimine 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ı izlemeye başlar.

(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 eder Trace .

(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 çağrılarak, 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 kullanı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()

Bir sunucu denetiminin bellekten çıkmadan önce son temizlemeyi gerçekleştirmesini sağlar.

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

İşleme verilerinin tasarım zamanı izlemeyi 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, Int32)

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

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

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

(Devralındığı yer: DataSourceControl)
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()

Geçerli örneğin Type 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)

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

Bir sanal yolun mutlak veya göreli olarak eşlenin fiziksel yolunu alır.

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

Geçerli Objectbasit bir kopyasını oluşturur.

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

Sunucu denetimi olayının sayfanın UI 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)

Nesnesini başlatır LinqDataSource .

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)

Nesne koleksiyonundan Controls bir alt denetim 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, istemcide işlenecek içeriği yazan sağlanan HtmlTextWriter bir nesneye gönderir.

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

Sağlanan bir nesneyi kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye gönderir.

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

Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye gönderir ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

(Devralındığı yer: DataSourceControl)
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 url'ye dönüştürür.

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

Sayfanın sunucuya geri gönderildiği zamandan 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, Object)

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

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

İzleme veri anahtarını ve izleme verisi 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 bir dize 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)

Bir güncelleştirme işlemi gerçekleştirir.

UpdateParameterVales()

Önceki istek sonrasında değişen parametre değerlerini güncelleştirir.

(Devralındığı yer: QueryableDataSource)

Ekinlikler

Name Description
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ü nesnesi atmadan ö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 sayfası 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 ve 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ı

Name Description
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ü desteklerken, diğerleri birden fazla 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ı

Name Description
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-SQL veri kaynağının değerini, tüm yabancı anahtar varlıklarının yüklenmeye zorlanması için ayarlar.

LoadWithForeignKeys(LinqDataSource, Type)

DataLoadOptions LINQ-SQL veri kaynağının değerini, tüm yabancı anahtar varlıklarının yüklenmeye zorlanması için ayarlar.

TryGetMetaTable(IDataSource, MetaTable)

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

Şunlara uygulanır

Ayrıca bkz.