Share via


LinqDataSource Kelas

Definisi

Memungkinkan penggunaan Language-Integrated Query (LINQ) di halaman web ASP.NET melalui teks markup untuk mengambil dan memodifikasi data dari objek data.

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
Warisan
Warisan
Atribut
Penerapan

Contoh

Contoh berikut menunjukkan LinqDataSource kontrol yang mengambil data dari kelas entitas bernama Products. Kelas entitas dapat dihasilkan dengan menggunakan Designer O/R atau utilitas SqlMetal.exe. Properti Where diatur untuk mengembalikan hanya rekaman yang memiliki nilai dalam Price properti yang lebih besar dari 50. GridView Kontrol terikat ke LinqDataSource kontrol untuk menampilkan data.

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

Contoh berikut menunjukkan LinqDataSource kontrol yang memungkinkan pengguna memperbarui, menghapus, dan menyisipkan rekaman di sumber data. DetailsView Kontrol terikat pada LinqDataSource kontrol dan memungkinkan pengguna untuk melihat dan memodifikasi data. Perhatikan bahwa tidak ada perintah SQL yang diperlukan untuk memilih, memperbarui, menghapus, atau menyisipkan rekaman.

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

Contoh berikut menunjukkan penanganan aktivitas untuk Selecting peristiwa yang mengatur objek data berdasarkan nilai di halaman Web.

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

Contoh berikut menunjukkan LinqDataSource kontrol yang dikonfigurasi untuk mengelompokkan menurut dua kolom. Properti Key mereferensikan objek yang memiliki dua properti, ProductCategory dan Color. Objek yang diwakili oleh It diganti namanya (alias) menjadi Products. Objek yang diganti Products namanya berisi kumpulan rekaman individual dalam pengelompokan. Setiap instans akan berisi semua kolom dari Products tabel.

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

Contoh berikut menunjukkan dua ListView kontrol yang menampilkan data dari LinqDataSource kontrol dalam contoh sebelumnya. Satu ListView kontrol menampilkan data yang dikelompokkan, dan kontrol lainnya ListView menampilkan nama individual produk yang termasuk dalam grup tersebut. Properti kontrol DataSource terikat data berlapis diatur ke Products, yang merupakan alias untuk It objek .

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

Keterangan

Dalam topik ini:

Pengantar

Language-Integrated Query (LINQ) adalah sintaks kueri yang menentukan sekumpulan operator kueri yang memungkinkan operasi traversal, filter, dan proyeksi dinyatakan dengan cara deklaratif dalam apa pun . Bahasa pemrograman berbasis NET. Objek data dapat menjadi pengumpulan data dalam memori atau objek yang mewakili data dari database. Anda dapat mengambil atau memodifikasi data tanpa harus menulis perintah SQL untuk setiap operasi.

Kontrol memungkinkan LinqDataSource Anda menggunakan LINQ di halaman web ASP.NET dengan mengatur properti dalam teks markup. Kontrol LinqDataSource menggunakan LINQ ke SQL untuk menghasilkan perintah data secara otomatis. Untuk informasi selengkapnya tentang LINQ ke SQL, lihat LINQ ke SQL.

Saat mengambil data dari pengumpulan data dalam memori, Anda mengatur ContextTypeName properti ke kelas yang berisi pengumpulan data. Anda mengatur TableName properti ke properti atau bidang yang mengembalikan pengumpulan data. Misalnya, Anda mungkin memiliki kelas bernama Person yang berisi properti bernama FavoriteCities yang mengembalikan array nilai string. Dalam hal ini, Anda mengatur ContextTypeName properti ke Person dan mengatur TableName properti ke FavoriteCities.

Saat Anda mengkueri database, Anda harus terlebih dahulu membuat kelas entitas yang mewakili database dan tabelnya. Anda dapat menggunakan Designer Relasional Objek atau utilitas SqlMetal.exe untuk menghasilkan kelas-kelas ini. Anda kemudian mengatur ContextTypeName properti ke kelas yang mewakili database dan mengatur TableName properti ke properti yang mewakili tabel database.

Urutan Operasi

Kontrol LinqDataSource menerapkan operasi data dalam urutan berikut:

  1. Di mana (tentukan rekaman data mana yang akan dikembalikan).

  2. Urutkan Berdasar (urutkan).

  3. Kelompokkan Menurut (rekaman data agregat yang berbagi nilai).

  4. Urutkan Grup Menurut (urutkan data yang dikelompokkan).

  5. Pilih (tentukan bidang atau properti mana yang akan dikembalikan).

  6. Mengurutkan otomatis (mengurutkan rekaman data menurut properti yang telah dipilih pengguna).

  7. Halaman otomatis (ambil subset rekaman data yang dipilih oleh pengguna).

Anda bisa menambahkan kondisi ke Where properti untuk memfilter rekaman data yang dikembalikan dari kueri. Where Jika properti tidak diatur, LinqDataSource kontrol mengambil setiap rekaman dari objek data.

Mengurutkan Data

Anda menggunakan OrderBy properti untuk menentukan nama properti dari data yang dikembalikan untuk diurutkan.

Catatan

Saat Anda menggunakan LinqDataSource kontrol dengan SQL Server 2000 atau SQL Server Compact 3.5 dan AutoPage properti diatur ke true, Anda harus memberikan nilai dalam OrderBy properti . Secara default, AutoPage properti adalah true. Jika Anda menetapkan nilai ke Select properti , Anda juga harus menyertakan semua kolom identitas dalam daftar properti yang dikembalikan dalam kueri.

Mengelompokkan Data

Anda menggunakan GroupBy properti untuk menentukan properti mana yang digunakan untuk mengonsolidasikan rekaman data yang memiliki nilai yang sama. Saat mengelompokkan data, Anda dapat menyertakan Key dan It, yang merupakan properti yang dibuat secara dinamis, di Select properti . Properti Key mengacu pada nilai dalam properti atau properti yang digunakan untuk mengelompokkan data. Misalnya, jika Anda mengelompokkan menurut properti bernama Category, Key properti akan berisi semua nilai unik dalam Category properti . Properti It mengacu pada kumpulan rekaman individual dalam pengelompokan data. Anda dapat melakukan iterasi melalui It properti untuk mengambil catatan individual yang telah dikonsolidasikan dalam operasi pengelompokan. Misalnya, jika Anda mengelompokkan menurut properti bernama Category, It properti berisi semua rekaman individual yang berbagi nilai umum dalam Category properti .

Anda menggunakan OrderGroupsBy properti untuk menentukan properti yang akan digunakan untuk mengurutkan data yang dikelompokkan. Saat Anda mengelompokkan data, OrderBy properti menentukan bagaimana rekaman individual dalam data yang dikelompokkan diurutkan.

Secara default, LinqDataSource kontrol mengambil nilai untuk semua properti dari objek data. Anda menggunakan Select properti untuk menentukan properti mana yang akan dikembalikan jika Anda ingin bekerja dengan subset properti yang tersedia. Operasi Pilih diterapkan setelah operasi Where, Order By, dan Group By. Oleh karena itu, jika Anda membuat nama alias dalam klausa Pilih, alias tidak tersedia di klausa lain.

Modifikasi Data

Anda dapat menentukan apakah modifikasi data diaktifkan dengan menggunakan EnableDeleteproperti , EnableInsert, dan EnableUpdate . Antarmuka pengguna untuk memodifikasi data dari LinqDataSource kontrol biasanya disediakan melalui kontrol terikat data, seperti DetailsView kontrol. Selain mengatur EnableDelete, , EnableInsertatau EnableUpdate ke true, kondisi berikut diperlukan untuk mengaktifkan modifikasi data otomatis:

Anda dapat membatasi properti mana yang ditampilkan dalam kontrol terikat data dengan dua cara. Anda dapat mengatur Select properti ke subset properti, atau Anda bisa menentukan bidang untuk kontrol terikat data dengan menambahkan DataControlField kontrol. Namun, jika Anda mengatur Select properti , itu berarti bahwa operasi pembaruan otomatis, sisipkan, dan hapus tidak dapat diaktifkan. Jika Anda ingin mengaktifkan modifikasi data otomatis saat Bekerja dengan subset properti yang tersedia, jangan atur Select properti . Sebagai gantinya, ambil semua properti dari objek data dan kelola mana yang ditampilkan dengan menggunakan kontrol terikat data. Saat Anda menggunakan DetailsView kontrol atau GridView kontrol, Anda juga harus mengatur AutoGenerateRows properti atau AutoGenerateColumns ke false. Ini mencegah kontrol terikat data secara otomatis menyertakan tombol untuk mengedit dan menghapus data. Nilai apa pun yang tidak ditampilkan dalam kontrol terikat data disimpan dalam status tampilan. Mereka diteruskan tidak berubah ke sumber data saat pembaruan data dilakukan.

Mengevaluasi Nilai pada Run Time

Jika Anda harus mengevaluasi nilai pada durasi untuk mengurutkan, memfilter, atau mengelompokkan nilai, Anda dapat menambahkan parameter ke WhereParameterskoleksi , , GroupByParametersOrderGroupsByParameters, atau OrderByParameters .

Jika Anda ingin menentukan nilai default, Anda dapat menambahkan parameter ke InsertParameters koleksi.

Jika Anda ingin memeriksa atau memodifikasi nilai sebelum operasi data dijalankan, Anda dapat menangani Deletingperistiwa , Inserting, Selecting, atau Updating . Anda juga dapat menangani peristiwa ini untuk membatalkan operasi data atau untuk memeriksa kesalahan validasi yang terjadi saat Anda mengatur properti di kelas data berdasarkan input pengguna.

Untuk memeriksa nilai setelah operasi data selesai, tangani Deletedperistiwa , , InsertedSelected, atau Updated .

Bekerja dengan Prosedur Tersimpan

Anda menggunakan LinqDataSource kontrol untuk mengambil data dari prosedur tersimpan dengan membuat penanganan aktivitas untuk peristiwa tersebut Selecting . Di penanganan aktivitas, Anda memanggil metode di kelas konteks data yang mewakili prosedur tersimpan dan mengatur hasilnya ke Result properti LinqDataSourceSelectEventArgs objek. Jika Anda ingin mengaktifkan operasi pembaruan, sisipkan, dan hapus otomatis untuk data, jenis yang dikembalikan dari metode harus cocok dengan jenis yang ditentukan dalam TableName properti . Untuk informasi selengkapnya tentang membuat metode konteks data, lihat Cara: Membuat metode DataContext yang dipetakan ke prosedur dan fungsi tersimpan (Designer O/R).

Sintaks Deklaratif

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

Konstruktor

LinqDataSource()

Menginisialisasi instans baru kelas LinqDataSource.

Properti

Adapter

Mendapatkan adaptor khusus browser untuk kontrol.

(Diperoleh dari Control)
AppRelativeTemplateSourceDirectory

Mendapatkan atau mengatur direktori virtual relatif aplikasi dari Page objek atau UserControl yang berisi kontrol ini.

(Diperoleh dari Control)
AutoGenerateOrderByClause

Mendapatkan atau menetapkan nilai yang menunjukkan apakah LinqDataSource kontrol secara dinamis membuat klausa Order By berdasarkan nilai dalam OrderByParameters koleksi.

AutoGenerateWhereClause

Mendapatkan atau menetapkan nilai yang menunjukkan apakah LinqDataSource kontrol secara dinamis membuat klausa Where berdasarkan nilai yang ditentukan dalam WhereParameters koleksi.

AutoPage

Mendapatkan atau menetapkan nilai yang menunjukkan apakah LinqDataSource kontrol mendukung navigasi melalui bagian data pada durasi.

AutoSort

Mendapatkan atau menetapkan nilai yang menunjukkan apakah LinqDataSource kontrol mendukung pengurutan data pada durasi.

BindingContainer

Mendapatkan kontrol yang berisi pengikatan data kontrol ini.

(Diperoleh dari Control)
ChildControlsCreated

Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server telah dibuat.

(Diperoleh dari Control)
ClientID

Mendapatkan pengidentifikasi kontrol server yang dihasilkan oleh ASP.NET.

(Diperoleh dari DataSourceControl)
ClientIDMode

Properti ini tidak digunakan untuk kontrol sumber data.

(Diperoleh dari DataSourceControl)
ClientIDSeparator

Mendapatkan nilai karakter yang mewakili karakter pemisah yang digunakan dalam ClientID properti .

(Diperoleh dari Control)
Context

Mendapatkan objek yang HttpContext terkait dengan kontrol server untuk permintaan Web saat ini.

(Diperoleh dari Control)
ContextTypeName

Mendapatkan atau mengatur nama jenis yang berisi properti yang nilainya memiliki data yang ingin Anda ambil.

Controls

ControlCollection Mendapatkan objek yang mewakili kontrol anak untuk kontrol server tertentu dalam hierarki UI.

(Diperoleh dari DataSourceControl)
DataItemContainer

Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataItemContainer.

(Diperoleh dari Control)
DataKeysContainer

Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataKeysControl.

(Diperoleh dari Control)
DeleteParameters

Properti ini tidak digunakan oleh LinqDataSource kelas .

DesignMode

Mendapatkan nilai yang menunjukkan apakah kontrol sedang digunakan pada permukaan desain.

(Diperoleh dari Control)
EnableDelete

Mendapatkan atau menetapkan nilai yang menunjukkan apakah rekaman data dapat dihapus melalui LinqDataSource kontrol.

EnableInsert

Mendapatkan atau menetapkan nilai yang menunjukkan apakah rekaman data dapat disisipkan melalui LinqDataSource kontrol.

EnableObjectTracking

Mendapatkan atau mengatur nilai yang menunjukkan apakah perubahan pada objek konteks data dilacak.

EnableTheming

Mendapatkan nilai yang menunjukkan apakah kontrol ini mendukung tema.

(Diperoleh dari DataSourceControl)
EnableUpdate

Mendapatkan atau menetapkan nilai yang menunjukkan apakah rekaman data dapat diperbarui melalui LinqDataSource kontrol.

EnableViewState

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server mempertahankan status tampilannya, dan status tampilan setiap kontrol anak yang dikandungnya, ke klien yang meminta.

(Diperoleh dari Control)
EntitySetName

Mendapatkan atau mengatur nama properti atau bidang di objek sumber data yang mewakili pengumpulan data.

(Diperoleh dari ContextDataSource)
EntityTypeName

Mendapatkan atau mengatur nama jenis yang dibuat untuk operasi Sisipkan, Hapus, dan Perbarui.

(Diperoleh dari ContextDataSource)
Events

Mendapatkan daftar delegasi penanganan aktivitas untuk kontrol. Properti ini bersifat hanya baca.

(Diperoleh dari Control)
GroupBy

Mendapatkan atau menetapkan nilai yang menentukan properti mana yang digunakan untuk mengelompokkan data yang diambil.

GroupByParameters

Mendapatkan kumpulan parameter yang digunakan untuk membuat klausa Kelompokkan Menurut.

HasChildViewState

Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server saat ini memiliki pengaturan status tampilan yang disimpan.

(Diperoleh dari Control)
ID

Mendapatkan atau mengatur pengidentifikasi terprogram yang ditetapkan ke kontrol server.

(Diperoleh dari Control)
IdSeparator

Mendapatkan karakter yang digunakan untuk memisahkan pengidentifikasi kontrol.

(Diperoleh dari Control)
InsertParameters

Mendapatkan kumpulan parameter yang digunakan selama operasi penyisipan.

IsChildControlStateCleared

Mendapatkan nilai yang menunjukkan apakah kontrol yang terkandung dalam kontrol ini memiliki status kontrol.

(Diperoleh dari Control)
IsTrackingViewState

Mendapatkan nilai yang menunjukkan apakah kontrol server menyimpan perubahan pada status tampilannya.

(Diperoleh dari Control)
IsViewStateEnabled

Mendapatkan nilai yang menunjukkan apakah status tampilan diaktifkan untuk kontrol ini.

(Diperoleh dari Control)
LoadViewStateByID

Mendapatkan nilai yang menunjukkan apakah kontrol berpartisipasi dalam memuat status tampilannya dengan ID bukan indeks.

(Diperoleh dari Control)
NamingContainer

Mendapatkan referensi ke kontainer penamaan kontrol server, yang membuat namespace unik untuk membedakan antara kontrol server dengan nilai properti yang sama ID .

(Diperoleh dari Control)
OrderBy

Mendapatkan atau menetapkan nilai yang menentukan bidang mana yang digunakan untuk mengurutkan data yang diambil.

OrderByParameters

Mendapatkan kumpulan parameter yang digunakan untuk membuat klausa Order By.

OrderGroupsBy

Mendapatkan atau mengatur bidang yang digunakan untuk mengurutkan data yang dikelompokkan.

OrderGroupsByParameters

Mendapatkan kumpulan parameter yang digunakan untuk membuat klausul Order Groups By.

Page

Mendapatkan referensi ke Page instans yang berisi kontrol server.

(Diperoleh dari Control)
Parent

Mendapatkan referensi ke kontrol induk kontrol server dalam hierarki kontrol halaman.

(Diperoleh dari Control)
RenderingCompatibility

Mendapatkan nilai yang menentukan versi ASP.NET yang akan kompatibel dengan HTML yang dirender.

(Diperoleh dari Control)
Select

Mendapatkan atau mengatur properti dan nilai terhitung yang disertakan dalam data yang diambil.

SelectParameters

Mendapatkan kumpulan parameter yang digunakan selama operasi pengambilan data.

Site

Mendapatkan informasi tentang kontainer yang menghosting kontrol saat ini saat dirender pada permukaan desain.

(Diperoleh dari Control)
SkinID

Mendapatkan kulit untuk diterapkan pada DataSourceControl kontrol.

(Diperoleh dari DataSourceControl)
StoreOriginalValuesInViewState

Mendapatkan atau menetapkan nilai yang menunjukkan apakah data dari sumber data harus disimpan dalam status tampilan untuk memastikan bahwa data belum diubah oleh proses lain sebelum diperbarui atau dihapus.

TableName

Mendapatkan atau mengatur nama properti atau bidang di kelas konteks data yang mewakili pengumpulan data.

TemplateControl

Mendapatkan atau mengatur referensi ke templat yang berisi kontrol ini.

(Diperoleh dari Control)
TemplateSourceDirectory

Mendapatkan direktori Page virtual dari atau UserControl yang berisi kontrol server saat ini.

(Diperoleh dari Control)
UniqueID

Mendapatkan pengidentifikasi unik yang memenuhi syarat secara hierarkis untuk kontrol server.

(Diperoleh dari Control)
UpdateParameters

Koleksi ini tidak digunakan oleh LinqDataSource kelas .

ValidateRequestMode

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol memeriksa input klien dari browser untuk nilai yang berpotensi berbahaya.

(Diperoleh dari Control)
ViewState

Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status tampilan kontrol server di beberapa permintaan untuk halaman yang sama.

(Diperoleh dari Control)
ViewStateIgnoresCase

Mendapatkan nilai yang menunjukkan apakah StateBag objek tidak peka huruf besar/kecil.

(Diperoleh dari Control)
ViewStateMode

Mendapatkan atau mengatur mode view-state kontrol ini.

(Diperoleh dari Control)
Visible

Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol ditampilkan secara visual.

(Diperoleh dari DataSourceControl)
Where

Mendapatkan atau menetapkan nilai yang menentukan kondisi apa yang harus benar agar rekaman disertakan dalam data yang diambil.

WhereParameters

Mendapatkan kumpulan parameter yang digunakan untuk membuat klausa Where.

Metode

AddedControl(Control, Int32)

Dipanggil setelah kontrol anak ditambahkan ke Controls koleksi Control objek.

(Diperoleh dari Control)
AddParsedSubObject(Object)

Memberi tahu kontrol server bahwa elemen, baik XML atau HTML, diurai, dan menambahkan elemen ke objek kontrol ControlCollection server.

(Diperoleh dari Control)
ApplyStyleSheetSkin(Page)

Menerapkan properti gaya yang ditentukan dalam lembar gaya halaman ke kontrol.

(Diperoleh dari DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Memulai pelacakan waktu desain untuk merender data.

(Diperoleh dari Control)
BuildProfileTree(String, Boolean)

Mengumpulkan informasi tentang kontrol server dan mengirimkannya ke properti yang Trace akan ditampilkan saat pelacakan diaktifkan untuk halaman.

(Diperoleh dari Control)
ClearCachedClientID()

Mengatur nilai yang di-cache ClientID ke null.

(Diperoleh dari Control)
ClearChildControlState()

Menghapus informasi status-kontrol untuk kontrol anak kontrol server.

(Diperoleh dari Control)
ClearChildState()

Menghapus informasi status-tampilan dan status-kontrol untuk semua kontrol turunan kontrol server.

(Diperoleh dari Control)
ClearChildViewState()

Menghapus informasi status tampilan untuk semua kontrol anak kontrol server.

(Diperoleh dari Control)
ClearEffectiveClientIDMode()

Mengatur properti instans ClientIDMode kontrol saat ini dan kontrol turunan apa pun ke Inherit.

(Diperoleh dari Control)
CreateChildControls()

Dipanggil oleh kerangka kerja halaman ASP.NET untuk memberi tahu kontrol server yang menggunakan implementasi berbasis komposisi untuk membuat kontrol anak apa pun yang dikandungnya sebagai persiapan untuk memposting kembali atau merender.

(Diperoleh dari Control)
CreateControlCollection()

Membuat koleksi untuk menyimpan kontrol anak.

(Diperoleh dari DataSourceControl)
CreateQueryableView()

Mengembalikan tampilan yang dapat dikueri.

CreateView()

Membuat instans baru kelas LinqDataSourceView yang terkait dengan kontrol ini.

DataBind()

Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya.

(Diperoleh dari Control)
DataBind(Boolean)

Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya dengan opsi untuk menaikkan DataBinding peristiwa.

(Diperoleh dari Control)
DataBindChildren()

Mengikat sumber data ke kontrol anak kontrol server.

(Diperoleh dari Control)
Delete(IDictionary, IDictionary)

Melakukan operasi penghapusan.

Dispose()

Memungkinkan kontrol server untuk melakukan pembersihan akhir sebelum dilepaskan dari memori.

(Diperoleh dari Control)
EndRenderTracing(TextWriter, Object)

Mengakhiri pelacakan waktu desain penyajian data.

(Diperoleh dari Control)
EnsureChildControls()

Menentukan apakah kontrol server memuat kontrol turunan. Jika tidak, ia membuat kontrol anak.

(Diperoleh dari Control)
EnsureID()

Membuat pengidentifikasi untuk kontrol yang tidak memiliki pengidentifikasi yang ditetapkan.

(Diperoleh dari Control)
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
FindControl(String)

Mencari kontainer penamaan saat ini untuk kontrol server dengan parameter yang ditentukan id .

(Diperoleh dari DataSourceControl)
FindControl(String, Int32)

Mencari kontainer penamaan saat ini untuk kontrol server dengan bilangan bulat dan yang ditentukan id , yang ditentukan dalam pathOffset parameter , yang membantu dalam pencarian. Anda tidak boleh mengambil alih versi FindControl metode ini.

(Diperoleh dari Control)
Focus()

Mengatur fokus input ke kontrol.

(Diperoleh dari DataSourceControl)
GetDesignModeState()

Mendapatkan data waktu desain untuk kontrol.

(Diperoleh dari Control)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetRouteUrl(Object)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute.

(Diperoleh dari Control)
GetRouteUrl(RouteValueDictionary)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute.

(Diperoleh dari Control)
GetRouteUrl(String, Object)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute.

(Diperoleh dari Control)
GetRouteUrl(String, RouteValueDictionary)

Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute.

(Diperoleh dari Control)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
GetUniqueIDRelativeTo(Control)

Mengembalikan bagian awalan dari UniqueID properti kontrol yang ditentukan.

(Diperoleh dari Control)
GetView(String)

Mengembalikan tampilan sumber data yang terkait dengan LinqDataSource objek.

GetView(String)

Mendapatkan tampilan sumber data yang terkait dengan QueryableDataSource objek .

(Diperoleh dari QueryableDataSource)
GetViewNames()

Mengembalikan kumpulan nama yang mewakili daftar objek tampilan yang terkait dengan LinqDataSource kontrol.

GetViewNames()

Mendapatkan kumpulan nama yang mewakili tampilan yang terkait dengan QueryableDataSource kontrol.

(Diperoleh dari QueryableDataSource)
HasControls()

Menentukan apakah kontrol server berisi kontrol anak apa pun.

(Diperoleh dari DataSourceControl)
HasEvents()

Mengembalikan nilai yang menunjukkan apakah peristiwa terdaftar untuk kontrol atau kontrol turunan apa pun.

(Diperoleh dari Control)
Insert(IDictionary)

Melakukan operasi penyisipan.

IsLiteralContent()

Menentukan apakah kontrol server hanya menyimpan konten harfiah.

(Diperoleh dari Control)
LoadControlState(Object)

Memulihkan informasi status kontrol dari permintaan halaman sebelumnya yang disimpan oleh SaveControlState() metode .

(Diperoleh dari Control)
LoadViewState(Object)

Memuat status nilai dalam LinqDataSource kontrol yang harus dipertahankan.

LoadViewState(Object)

Memuat status nilai dalam QueryableDataSource kontrol yang harus dipertahankan.

(Diperoleh dari QueryableDataSource)
MapPathSecure(String)

Mengambil jalur fisik tempat jalur virtual, baik absolut atau relatif, dipetakan.

(Diperoleh dari Control)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
OnBubbleEvent(Object, EventArgs)

Menentukan apakah peristiwa untuk kontrol server diteruskan ke hierarki kontrol server UI halaman.

(Diperoleh dari Control)
OnDataBinding(EventArgs)

Memunculkan kejadian DataBinding.

(Diperoleh dari Control)
OnInit(EventArgs)

Menginisialisasi objek LinqDataSource.

OnLoad(EventArgs)

Memunculkan kejadian Load.

(Diperoleh dari Control)
OnPreRender(EventArgs)

Memunculkan kejadian PreRender.

(Diperoleh dari Control)
OnUnload(EventArgs)

Memunculkan kejadian Unload.

OpenFile(String)

Stream Terbiasa membaca file.

(Diperoleh dari Control)
RaiseBubbleEvent(Object, EventArgs)

Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol.

(Diperoleh dari Control)
RaiseDataSourceChangedEvent(EventArgs)

Memunculkan kejadian DataSourceChanged.

(Diperoleh dari DataSourceControl)
RaiseViewChanged()

OnDataSourceViewChanged(EventArgs) Memanggil metode DataSourceView kelas .

(Diperoleh dari QueryableDataSource)
RemovedControl(Control)

Dipanggil setelah kontrol anak dihapus dari Controls koleksi Control objek.

(Diperoleh dari Control)
Render(HtmlTextWriter)

Mengirim konten kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien.

(Diperoleh dari Control)
RenderChildren(HtmlTextWriter)

Menghasilkan konten turunan kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien.

(Diperoleh dari Control)
RenderControl(HtmlTextWriter)

Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan.

(Diperoleh dari DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter .

(Diperoleh dari Control)
ResolveAdapter()

Mendapatkan adaptor kontrol yang bertanggung jawab untuk merender kontrol yang ditentukan.

(Diperoleh dari Control)
ResolveClientUrl(String)

Mendapatkan URL yang dapat digunakan oleh browser.

(Diperoleh dari Control)
ResolveUrl(String)

Mengonversi URL menjadi URL yang dapat digunakan pada klien yang meminta.

(Diperoleh dari Control)
SaveControlState()

Menyimpan perubahan status kontrol server apa pun yang telah terjadi sejak halaman diposting kembali ke server.

(Diperoleh dari Control)
SaveViewState()

Menyimpan status LinqDataSource tampilan kontrol saat ini.

SaveViewState()

Menyimpan status QueryableDataSource tampilan kontrol saat ini.

(Diperoleh dari QueryableDataSource)
SetDesignModeState(IDictionary)

Mengatur data waktu desain untuk kontrol.

(Diperoleh dari Control)
SetRenderMethodDelegate(RenderMethod)

Menetapkan delegasi penanganan aktivitas untuk merender kontrol server dan kontennya ke dalam kontrol induknya.

(Diperoleh dari Control)
SetTraceData(Object, Object)

Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan kunci data pelacakan dan nilai data pelacakan.

(Diperoleh dari Control)
SetTraceData(Object, Object, Object)

Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan objek yang dilacak, kunci data pelacakan, dan nilai data pelacakan.

(Diperoleh dari Control)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)
TrackViewState()

Melacak perubahan status tampilan ke LinqDataSource kontrol sehingga perubahan dapat disimpan dalam StateBag objek untuk kontrol.

TrackViewState()

Melacak perubahan QueryableDataSource status tampilan kontrol sehingga perubahan dapat disimpan dalam StateBag objek untuk kontrol.

(Diperoleh dari QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)

Melakukan operasi pembaruan.

UpdateParameterVales()

Updates nilai parameter yang telah berubah sejak permintaan sebelumnya.

(Diperoleh dari QueryableDataSource)

Acara

ContextCreated

Terjadi setelah instans objek jenis konteks dibuat.

ContextCreating

Terjadi sebelum instans objek jenis konteks dibuat.

ContextDisposing

Terjadi sebelum membuang objek jenis konteks.

DataBinding

Terjadi ketika kontrol server mengikat ke sumber data.

(Diperoleh dari Control)
Deleted

Terjadi ketika operasi penghapusan telah selesai.

Deleting

Terjadi sebelum operasi penghapusan.

Disposed

Terjadi ketika kontrol server dilepaskan dari memori, yang merupakan tahap terakhir dari siklus hidup kontrol server ketika halaman ASP.NET diminta.

(Diperoleh dari Control)
Init

Terjadi ketika kontrol server diinisialisasi, yang merupakan langkah pertama dalam siklus hidupnya.

(Diperoleh dari Control)
Inserted

Terjadi ketika operasi penyisipan telah selesai.

Inserting

Terjadi sebelum operasi penyisipan.

Load

Terjadi ketika kontrol server dimuat ke Page dalam objek.

(Diperoleh dari Control)
PreRender

Terjadi setelah Control objek dimuat tetapi sebelum penyajian.

(Diperoleh dari Control)
QueryCreated

Terjadi saat kueri ditambahkan ke atau dihapus dari kontrol sumber data.

(Diperoleh dari QueryableDataSource)
Selected

Terjadi ketika operasi pengambilan data telah selesai.

Selecting

Terjadi sebelum operasi pengambilan data.

Unload

Terjadi ketika kontrol server dibongkar dari memori.

(Diperoleh dari Control)
Updated

Terjadi ketika operasi pembaruan telah selesai.

Updating

Terjadi sebelum operasi pembaruan.

Implementasi Antarmuka Eksplisit

IControlBuilderAccessor.ControlBuilder

Untuk deskripsi anggota ini, lihat ControlBuilder.

(Diperoleh dari Control)
IControlDesignerAccessor.GetDesignModeState()

Untuk deskripsi anggota ini, lihat GetDesignModeState().

(Diperoleh dari Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Untuk deskripsi anggota ini, lihat SetDesignModeState(IDictionary).

(Diperoleh dari Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Untuk deskripsi anggota ini, lihat SetOwnerControl(Control).

(Diperoleh dari Control)
IControlDesignerAccessor.UserData

Untuk deskripsi anggota ini, lihat UserData.

(Diperoleh dari Control)
IDataBindingsAccessor.DataBindings

Untuk deskripsi anggota ini, lihat DataBindings.

(Diperoleh dari Control)
IDataBindingsAccessor.HasDataBindings

Untuk deskripsi anggota ini, lihat HasDataBindings.

(Diperoleh dari Control)
IDataSource.DataSourceChanged

Terjadi ketika kontrol sumber data telah berubah dengan cara yang memengaruhi kontrol terikat data.

(Diperoleh dari DataSourceControl)
IDataSource.GetView(String)

Mendapatkan objek bernama DataSourceView yang terkait dengan DataSourceControl kontrol. Beberapa kontrol sumber data hanya mendukung satu tampilan, sementara yang lain mendukung lebih dari satu tampilan.

(Diperoleh dari DataSourceControl)
IDataSource.GetViewNames()

Mendapatkan kumpulan nama, yang mewakili daftar DataSourceView objek yang terkait dengan DataSourceControl kontrol.

(Diperoleh dari DataSourceControl)
IDynamicDataSource.ContextType

Untuk deskripsi anggota ini, lihat IDynamicDataSource.

IDynamicDataSource.EntitySetName

Untuk deskripsi anggota ini, lihat IDynamicDataSource.

IDynamicDataSource.Exception

Untuk deskripsi anggota ini, lihat IDynamicDataSource.

IExpressionsAccessor.Expressions

Untuk deskripsi anggota ini, lihat Expressions.

(Diperoleh dari Control)
IExpressionsAccessor.HasExpressions

Untuk deskripsi anggota ini, lihat HasExpressions.

(Diperoleh dari Control)
IListSource.ContainsListCollection

Menunjukkan apakah kontrol sumber data dikaitkan dengan satu atau beberapa daftar data.

(Diperoleh dari DataSourceControl)
IListSource.GetList()

Mendapatkan daftar kontrol sumber data yang dapat digunakan sebagai sumber daftar data.

(Diperoleh dari DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Untuk deskripsi anggota ini, lihat AddParsedSubObject(Object).

(Diperoleh dari Control)

Metode Ekstensi

ExpandDynamicWhereParameters(IDynamicDataSource)

Memperluas filter dinamis ke dalam Where parameter yang dapat digunakan oleh sumber data.

FindDataSourceControl(Control)

Mengembalikan sumber data yang terkait dengan kontrol data untuk kontrol yang ditentukan.

FindFieldTemplate(Control, String)

Mengembalikan templat bidang untuk kolom yang ditentukan dalam kontainer penamaan kontrol yang ditentukan.

FindMetaTable(Control)

Mengembalikan objek metatable untuk kontrol data yang berisi.

GetDefaultValues(IDataSource)

Mendapatkan kumpulan nilai default untuk sumber data yang ditentukan.

GetMetaTable(IDataSource)

Mendapatkan metadata untuk tabel di objek sumber data yang ditentukan.

GetTable(IDynamicDataSource)

Mengembalikan MetaTable objek yang terkait dengan kontrol sumber data yang ditentukan.

LoadWith<TEntity>(LinqDataSource)

DataLoadOptions Mengatur nilai sumber data LINQ-ke-SQL untuk memaksa semua entitas kunci asing dimuat.

LoadWithForeignKeys(LinqDataSource, Type)

DataLoadOptions Mengatur nilai sumber data LINQ-ke-SQL untuk memaksa semua entitas kunci asing dimuat.

TryGetMetaTable(IDataSource, MetaTable)

Menentukan apakah metadata tabel tersedia.

Berlaku untuk

Lihat juga