ObjectDataSource Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili objek bisnis yang menyediakan data ke kontrol terikat data dalam arsitektur aplikasi Web multitier.

public ref class ObjectDataSource : System::Web::UI::DataSourceControl

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))]
public class ObjectDataSource : System.Web.UI.DataSourceControl

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.ObjectDataSource))>]
type ObjectDataSource = class
    inherit DataSourceControl

Public Class ObjectDataSource
Inherits DataSourceControl

Warisan: Object

Control

DataSourceControl
ObjectDataSource

Atribut: ToolboxBitmapAttribute

Contoh

Bagian ini memperlihatkan ObjectDataSource markup di halaman .aspx dan memperlihatkan objek bisnis yang bekerja dengannya. Contohnya adalah halaman .aspx. Ini berisi GridView kontrol yang terikat ke ObjectDataSource kontrol. ObjectDataSource Markup kontrol menentukan nama objek bisnis dan nama metode objek bisnis yang akan dipanggil untuk mengambil data.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.CS.EmployeeLogic" />

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - Visual Basic Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1" />

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployees"
          typename="Samples.AspNet.VB.EmployeeLogic" />

    </form>
  </body>
</html>

Contoh berikut menunjukkan objek bisnis yang ObjectDataSource digunakan kontrol di halaman .aspx. (Banyak contoh kode lain ObjectDataSource menggunakan objek bisnis ini juga.) Contohnya terdiri dari dua kelas dasar berikut:

Kelas EmployeeLogic adalah kelas logika bisnis yang ObjectDataSource digunakan.
Kelas NorthwindEmployee menentukan objek data yang dikembalikan oleh GetAllEmployees metode EmployeeLogic kelas .

Kelas tambahan NorthwindDataException disediakan sebagai kemudahan.

Kumpulan kelas contoh ini berfungsi dengan database Northwind Traders, yang tersedia dengan Microsoft SQL Server dan Microsoft Access. Untuk contoh kerja lengkap, Anda harus mengkompilasi dan menggunakan kelas-kelas ini dengan contoh halaman .aspx yang disediakan.

namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Collections.Specialized;
using System.Configuration;
using System.Data;
using System.Data.SqlClient;
using System.Web.UI;
using System.Web.UI.WebControls;
  //
  // EmployeeLogic is a stateless business object that encapsulates
  // the operations one can perform on a NorthwindEmployee object.
  //
  public class EmployeeLogic {

    // Returns a collection of NorthwindEmployee objects.
    public static ICollection GetAllEmployees () {
      ArrayList al = new ArrayList();

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

      SqlDataSource sds
        = new SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees");

      try {

        IEnumerable IDs = sds.Select(DataSourceSelectArguments.Empty);

        // Iterate through the Enumeration and create a
        // NorthwindEmployee object for each ID.
        foreach (DataRowView row in IDs) {
          string id = row["EmployeeID"].ToString();
          NorthwindEmployee nwe = new NorthwindEmployee(id);
          // Add the NorthwindEmployee object to the collection.
          al.Add(nwe);
        }
      }
      finally {
        // If anything strange happens, clean up.
        sds.Dispose();
      }

      return al;
    }
    public static NorthwindEmployee GetEmployee(object anID) {
      return new NorthwindEmployee(anID);
    }

    public static void UpdateEmployeeInfo(NorthwindEmployee ne) {
      bool retval = ne.Save();
      if (! retval) { throw new NorthwindDataException("UpdateEmployee failed."); }
    }

    public static void DeleteEmployee(NorthwindEmployee ne) { }
  }

  public class NorthwindEmployee {

    public NorthwindEmployee () {
      ID = DBNull.Value;
      lastName = "";
      firstName = "";
      title="";
      titleOfCourtesy = "";
      reportsTo = -1;
    }

    public NorthwindEmployee (object anID) {
      this.ID = anID;

      ConnectionStringSettings cts = ConfigurationManager.ConnectionStrings["NorthwindConnection"];

        SqlConnection conn = new SqlConnection (cts.ConnectionString);
      SqlCommand sc =
        new SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " +
                       " FROM Employees " +
                       " WHERE EmployeeID = @empId",
                       conn);
      // Add the employee ID parameter and set its value.
      sc.Parameters.Add(new SqlParameter("@empId",SqlDbType.Int)).Value = Int32.Parse(anID.ToString());
      SqlDataReader sdr = null;

      try {
        conn.Open();
        sdr = sc.ExecuteReader();

        // This is not a while loop. It only loops once.
        if (sdr != null && sdr.Read()) {
          // The IEnumerable contains DataRowView objects.
          this.firstName        = sdr["FirstName"].ToString();
          this.lastName         = sdr["LastName"].ToString();
          this.title            = sdr["Title"].ToString();
          this.titleOfCourtesy  = sdr["TitleOfCourtesy"].ToString();
          if (! sdr.IsDBNull(4)) {
            this.reportsTo        = sdr.GetInt32(4);
          }
        }
        else {
          throw new NorthwindDataException("Data not loaded for employee id.");
        }
      }
      finally {
        try {
          if (sdr != null) sdr.Close();
          conn.Close();
        }
        catch (SqlException) {
          // Log an event in the Application Event Log.
          throw;
        }
      }
    }

    private object ID;

    private string lastName;
    public string LastName {
      get { return lastName; }
      set { lastName = value; }
    }

    private string firstName;
    public string FirstName {
      get { return firstName; }
      set { firstName = value;  }
    }

    private string title;
    public String Title {
      get { return title; }
      set { title = value; }
    }

    private string titleOfCourtesy;
    public string Courtesy {
      get { return titleOfCourtesy; }
      set { titleOfCourtesy = value; }
    }

    private int    reportsTo;
    public int Supervisor {
      get { return reportsTo; }
      set { reportsTo = value; }
    }

    public bool Save () {
      return true;
    }
  }

  internal class NorthwindDataException: Exception {
    public NorthwindDataException(string msg) : base (msg) { }
  }
}

Imports System.Collections
Imports System.Configuration
Imports System.Data
Imports System.Data.SqlClient
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB
'
' EmployeeLogic is a stateless business object that encapsulates
' the operations you can perform on a NorthwindEmployee object.
' When the class is written in Visual Basic, you cannot use the Shared
' part.
Public Class EmployeeLogic
   ' Returns a collection of NorthwindEmployee objects.
   Public Shared Function GetAllEmployees() As ICollection
      Dim al As New ArrayList()

      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim sds As New SqlDataSource(cts.ConnectionString, "SELECT EmployeeID FROM Employees")
      Try
         Dim IDs As IEnumerable = sds.Select(DataSourceSelectArguments.Empty)

         ' Iterate through the Enumeration and create a
         ' NorthwindEmployee object for each ID.
         For Each row As DataRowView In IDs
            Dim id As String = row("EmployeeID").ToString()
            Dim nwe As New NorthwindEmployee(id)
            ' Add the NorthwindEmployee object to the collection.
            al.Add(nwe)
         Next
      Finally
         ' If anything strange happens, clean up.
         sds.Dispose()
      End Try

      Return al
   End Function 'GetAllEmployees

   Public Shared Function GetEmployee(anID As Object) As NorthwindEmployee
      Return New NorthwindEmployee(anID)
   End Function 'GetEmployee


   Public Shared Sub UpdateEmployeeInfo(ne As NorthwindEmployee)
      Dim retval As Boolean = ne.Save()
      If Not retval Then
         Throw New NorthwindDataException("UpdateEmployee failed.")
      End If
   End Sub

   Public Shared Sub DeleteEmployee(ne As NorthwindEmployee)
   End Sub

End Class


Public Class NorthwindEmployee


   Public Sub New()
      ID = DBNull.Value
      aLastName = ""
      aFirstName = ""
      aTitle = ""
      titleOfCourtesy = ""
      reportsTo = - 1
   End Sub


   Public Sub New(anID As Object)
      Me.ID = anID
      Dim cts As ConnectionStringSettings = ConfigurationManager.ConnectionStrings("NorthwindConnection")
      Dim conn As New SqlConnection(cts.ConnectionString)
      Dim sc As New SqlCommand(" SELECT FirstName,LastName,Title,TitleOfCourtesy,ReportsTo " & _
                               " FROM Employees " & _
                               " WHERE EmployeeID = @empId", conn)
      ' Add the employee ID parameter and set its value.
      sc.Parameters.Add(New SqlParameter("@empId", SqlDbType.Int)).Value = Int32.Parse(anID.ToString())
      Dim sdr As SqlDataReader = Nothing

      Try
         conn.Open()
         sdr = sc.ExecuteReader()

         ' This is not a while loop. It only loops once.
         If Not (sdr Is Nothing) AndAlso sdr.Read() Then
            ' The IEnumerable contains DataRowView objects.
            Me.aFirstName = sdr("FirstName").ToString()
            Me.aLastName = sdr("LastName").ToString()
            Me.aTitle = sdr("Title").ToString()
            Me.titleOfCourtesy = sdr("TitleOfCourtesy").ToString()
            If Not sdr.IsDBNull(4) Then
               Me.reportsTo = sdr.GetInt32(4)
            End If
         Else
            Throw New NorthwindDataException("Data not loaded for employee id.")
         End If
      Finally
         Try
            If Not (sdr Is Nothing) Then
               sdr.Close()
            End If
            conn.Close()
         Catch se As SqlException
            ' Log an event in the Application Event Log.
            Throw
         End Try
      End Try
   End Sub

   Private ID As Object

   Private aLastName As String
   Public Property LastName() As String
      Get
         Return aLastName
      End Get
      Set
         aLastName = value
      End Set
   End Property

   Private aFirstName As String
   Public Property FirstName() As String
      Get
         Return aFirstName
      End Get
      Set
         aFirstName = value
      End Set
   End Property

   Private aTitle As String
   Public Property Title() As String
      Get
         Return aTitle
      End Get
      Set
         aTitle = value
      End Set
   End Property

   Private titleOfCourtesy As String
   Public Property Courtesy() As String
      Get
         Return titleOfCourtesy
      End Get
      Set
         titleOfCourtesy = value
      End Set
   End Property
   Private reportsTo As Integer

   Public Property Supervisor() As Integer
      Get
         Return reportsTo
      End Get
      Set
         reportsTo = value
      End Set
   End Property

   Public Function Save() As Boolean
      Return True
   End Function 'Save
End Class


Friend Class NorthwindDataException
   Inherits Exception

   Public Sub New(msg As String)
      MyBase.New(msg)
   End Sub
End Class
End Namespace

Keterangan

Dalam topik ini:

Pendahuluan
Tujuan
Mengambil Data
Melakukan Operasi Data
Memfilter Data
Penembolokan
Fitur
Tampilan Data
Menggunakan LINQ ke SQL
Sintaks Deklaratif

Pengantar

Kontrol ObjectDataSource berfungsi dengan kelas yang Anda buat. Anda membuat metode yang mengambil dan memperbarui data, dan Anda memberikan nama metode tersebut ke ObjectDataSource kontrol dalam markup. Selama penyajian atau pemrosesan postback, ObjectDataSource memanggil metode yang telah Anda tentukan.

Tidak ada penyajian ObjectDataSource visual kontrol. Akibatnya, ObjectDataSource tidak mendukung fitur visual seperti EnableTheming properti atau SkinID .

Tujuan

Praktik desain aplikasi yang sangat umum adalah memisahkan lapisan presentasi dari logika bisnis dan merangkum logika bisnis dalam objek bisnis. Objek bisnis ini membentuk lapisan yang berbeda antara lapisan presentasi dan tingkat data, menghasilkan arsitektur aplikasi tiga tingkat. Kontrol ini ObjectDataSource memungkinkan pengembang untuk menggunakan kontrol sumber data ASP.NET sambil mempertahankan arsitektur aplikasi tiga tingkat mereka.

Kontrol ObjectDataSource menggunakan refleksi untuk membuat instans objek bisnis dan memanggil metode untuk mengambil, memperbarui, menyisipkan, dan menghapus data. Properti TypeName mengidentifikasi nama kelas yang ObjectDataSource bekerja dengannya. Kontrol ObjectDataSource membuat dan menghancurkan instans kelas untuk setiap panggilan metode; kontrol tidak menyimpan objek dalam memori selama masa pakai permintaan Web. Ini adalah pertimbangan serius jika objek bisnis yang Anda gunakan membutuhkan banyak sumber daya atau mahal untuk dibuat dan dihancurkan. Menggunakan objek yang mahal mungkin bukan pilihan desain yang optimal, tetapi Anda dapat mengontrol siklus hidup objek dengan menggunakan ObjectCreatingperistiwa , , ObjectCreateddan ObjectDisposing .

Catatan

Metode yang diidentifikasi oleh SelectMethodproperti , , UpdateMethod InsertMethod, dan DeleteMethod dapat menjadi metode instans atau static (Shared dalam metode Visual Basic). Jika metodenya adalah static (Shared di Visual Basic), instans objek bisnis tidak dibuat, dan ObjectCreatingperistiwa , ObjectCreated, dan ObjectDisposing tidak dinaikkan.

Mengambil Data

Untuk mengambil data dari objek bisnis, atur SelectMethod properti ke nama metode yang mengambil data. Jika metode tidak mengembalikan IEnumerable objek atau DataSet , objek dibungkus oleh runtime dalam IEnumerable koleksi. Jika tanda tangan metode memiliki parameter, Anda dapat menambahkan Parameter objek ke SelectParameters koleksi, lalu mengikatnya ke nilai yang ingin Anda teruskan ke metode yang ditentukan oleh SelectMethod properti . Agar ObjectDataSource kontrol menggunakan parameter, parameter harus cocok dengan nama dan jenis parameter dalam tanda tangan metode. Untuk informasi selengkapnya, lihat Menggunakan Parameter dengan ObjectDataSource Control.

Kontrol ObjectDataSource mengambil data setiap kali metode dipanggil Select . Metode ini menyediakan akses terprogram ke metode yang ditentukan oleh SelectMethod properti . Metode yang ditentukan oleh SelectMethod properti dipanggil secara otomatis oleh kontrol yang terikat pada ObjectDataSource saat metodenya DataBind dipanggil. Jika Anda mengatur DataSourceID properti kontrol terikat data, kontrol secara otomatis mengikat ke data dari sumber data, sesuai kebutuhan. DataSourceID Mengatur properti adalah metode yang direkomendasikan untuk mengikat ObjectDataSource kontrol ke kontrol terikat data. Atau, Anda dapat mengatur DataSource properti , tetapi kemudian Anda harus secara eksplisit memanggil DataBind metode kontrol terikat data. Anda dapat memanggil metode secara Select terprogram kapan saja untuk mengambil data.

Untuk informasi selengkapnya tentang mengikat kontrol terikat data ke kontrol sumber data, lihat Pengikatan ke Data Menggunakan Kontrol Sumber Data.

Melakukan Operasi Data

Bergantung pada kemampuan objek bisnis yang ObjectDataSource bekerja dengan kontrol, Anda dapat melakukan operasi data, seperti pembaruan, penyisipan, dan penghapusan. Untuk melakukan operasi data ini, atur nama metode yang sesuai dan parameter terkait untuk operasi yang ingin Anda lakukan. Misalnya, untuk operasi pembaruan, atur UpdateMethod properti ke nama metode objek bisnis yang melakukan pembaruan dan tambahkan parameter yang diperlukan ke UpdateParameters koleksi. Jika kontrol dikaitkan ObjectDataSource dengan kontrol terikat data, parameter ditambahkan oleh kontrol terikat data. Dalam hal ini, Anda perlu memastikan bahwa nama parameter metode cocok dengan nama bidang dalam kontrol terikat data. Pembaruan dilakukan ketika Update metode dipanggil, baik secara eksplisit oleh kode Anda atau secara otomatis oleh kontrol terikat data. Pola umum yang sama diikuti untuk Delete operasi dan Insert . Objek bisnis diasumsikan untuk melakukan jenis operasi data ini satu rekaman pada satu waktu, daripada di-batch.

Memfilter Data

ObjectDataSource Kontrol dapat memfilter data yang diambil oleh SelectMethod properti , jika data dikembalikan sebagai DataSet objek atau DataTable . Anda dapat mengatur FilterExpression properti ke ekspresi pemfilteran dengan menggunakan sintaks string format dan nilai ikatan dalam ekspresi ke parameter yang ditentukan dalam FilterParameters koleksi.

penembolokan

ObjectDataSource Meskipun tidak mempertahankan instans objek bisnis di beberapa permintaan, itu dapat menyimpan hasil panggilan metode yang diidentifikasi oleh SelectMethod properti . Saat data di-cache, panggilan berikutnya ke Select metode mengembalikan data yang di-cache alih-alih membuat objek bisnis dan memanggilnya SelectMethod menggunakan pantulan. Penembolokan memungkinkan Anda menghindari pembuatan objek dan memanggil metode datanya dengan mengorbankan memori di server Web. Secara ObjectDataSource otomatis menyimpan data saat EnableCaching properti diatur ke true, dan CacheDuration properti diatur ke jumlah detik cache menyimpan data sebelum cache dibuang. Anda juga dapat menentukan CacheExpirationPolicy properti dan properti opsional SqlCacheDependency . Kontrol memungkinkan ObjectDataSource Anda untuk menyimpan semua jenis data, tetapi Anda tidak boleh menyimpan objek cache yang menyimpan sumber daya atau status yang tidak dapat dibagikan untuk melayani beberapa permintaan (misalnya, objek terbuka SqlDataReader ), karena instans objek yang sama akan digunakan untuk melayani beberapa permintaan.

Fitur

Tabel berikut ini menjelaskan fitur ObjectDataSource kontrol.

Kemampuan	Persyaratan
Memilih	SelectMethod Atur properti ke nama metode objek bisnis yang memilih data, dan sertakan parameter yang diperlukan dalam SelectParameters koleksi baik secara terprogram atau dengan menggunakan kontrol terikat data.
Pengurutan	Atur SortParameterName properti ke nama parameter dalam SelectMethod metode yang membawa kriteria pengurutan.
Pemfilteran	Atur FilterExpression properti ke ekspresi pemfilteran dan secara opsional tambahkan parameter apa pun ke FilterParameters koleksi untuk memfilter data saat Select metode dipanggil. Metode yang ditentukan oleh SelectMethod properti harus mengembalikan DataSet atau DataTable.
Penomoran	Penomoran sumber data didukung, jika SelectMethod metode berisi parameter untuk jumlah maksimum rekaman yang akan diambil dan indeks rekaman pertama yang diambil. Nama parameter tersebut MaximumRowsParameterName masing-masing harus diatur dalam properti dan StartRowIndexParameterName . Kontrol terikat data mungkin dapat melakukan paging itu sendiri, bahkan jika ObjectDataSource kontrol tidak mendukung halaman langsung dalam metode yang ditentukan oleh SelectMethod properti . Persyaratan untuk kontrol terikat data untuk dapat melakukan ini adalah bahwa metode yang ditentukan oleh SelectMethod properti mengembalikan objek yang mengimplementasikan ICollection antarmuka.
Memperbarui	Atur UpdateMethod properti ke nama metode objek bisnis yang memperbarui data, dan sertakan parameter yang diperlukan dalam UpdateParameters koleksi.
Menghapus	Atur DeleteMethod properti ke nama metode atau fungsi objek bisnis yang menghapus data, dan sertakan parameter yang diperlukan dalam DeleteParameters koleksi.
Memasukkan	Atur InsertMethod properti ke nama metode atau fungsi objek bisnis yang menyisipkan data, dan sertakan parameter yang diperlukan dalam InsertParameters koleksi.
penembolokan	Atur EnableCaching properti ke `true`, dan CacheDuration properti dan CacheExpirationPolicy sesuai dengan perilaku penembolokan yang Anda inginkan untuk data cache Anda.

Catatan

Saat Anda menggunakan ObjectDataSource kelas untuk memperbarui atau menyisipkan data, string yang dimasukkan di klien tidak secara otomatis dikonversi dari format budaya klien ke format budaya server. Misalnya, budaya klien mungkin menentukan DD/MM/YYYY sebagai format tanggal, dan format tanggal pada server mungkin MM/DD/YYYY. Dalam hal ini, 5 Oktober 2009 akan dimasukkan dalam TextBox kontrol sebagai 10/5/2009 tetapi akan ditafsirkan sebagai 10 Mei 2009. 15 Oktober 2009 akan dimasukkan sebagai 15/10/2009, dan akan ditolak sebagai tanggal yang tidak valid.

Tampilan Data

Seperti semua kontrol sumber data, kontrol dikaitkan ObjectDataSource dengan kelas tampilan sumber data. ObjectDataSource Meskipun kontrol adalah antarmuka yang digunakan pengembang halaman untuk bekerja dengan data, ObjectDataSourceView kelas adalah antarmuka yang dikerjakan oleh kontrol terikat data. Selain itu, kelas menjelaskan ObjectDataSourceView kemampuan kontrol sumber data, dan melakukan pekerjaan aktual. Kontrol ObjectDataSource hanya memiliki satu yang terkait ObjectDataSourceView, dan selalu diberi nama DefaultView. ObjectDataSourceView Sementara objek diekspos oleh GetView metode , banyak properti dan metodenya dibungkus dan diekspos langsung oleh ObjectDataSource kontrol. Di balik layar, ObjectDataSourceView objek melakukan semua operasi data, termasuk mengambil, menyisipkan, memperbarui, menghapus, memfilter, dan mengurutkan data. Untuk informasi selengkapnya, lihat ObjectDataSourceView.

Menggunakan LINQ ke SQL

Anda dapat menggunakan ObjectDataSource kontrol dengan kelas LINQ ke SQL. Untuk melakukannya, Anda mengatur TypeName properti ke nama kelas konteks data. Anda juga mengatur SelectMethodmetode , UpdateMethod, InsertMethod, dan DeleteMethod ke metode di kelas konteks data yang melakukan operasi yang sesuai. Anda harus membuat penanganan aktivitas untuk ObjectDisposing acara tersebut untuk membatalkan pembuangan kelas konteks data. Langkah ini diperlukan karena LINQ ke SQL mendukung eksekusi yang ditangguhkan, sedangkan ObjectDataSource kontrol mencoba membuang konteks data setelah operasi Pilih. Untuk informasi selengkapnya tentang cara membuat LINQ ke kelas SQL, lihat Cara: Membuat LINQ ke Kelas SQL di Proyek Web. Untuk contoh cara membatalkan pembuangan kelas konteks data, lihat ObjectDisposing peristiwa tersebut.

Menggunakan Kerangka Kerja Entitas

Anda juga dapat menggunakan ObjectDataSource kontrol dengan Kerangka Kerja Entitas. Untuk informasi selengkapnya, lihat Menggunakan Kerangka Kerja Entitas dan Kontrol ObjectDataSource.

Sintaks Deklaratif

<asp:ObjectDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    ConflictDetection="OverwriteChanges|CompareAllValues"
    ConvertNullToDBNull="True|False"
    DataObjectTypeName="string"
    DeleteMethod="string"
    EnableCaching="True|False"
    EnablePaging="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FilterExpression="string"
    ID="string"
    InsertMethod="string"
    MaximumRowsParameterName="string"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnObjectCreated="ObjectCreated event handler"
    OnObjectCreating="ObjectCreating event handler"
    OnObjectDisposing="ObjectDisposing 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"
    runat="server"
    SelectCountMethod="string"
    SelectMethod="string"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    StartRowIndexParameterName="string"
    TypeName="string"
    UpdateMethod="string"
    Visible="True|False"
>
        <DeleteParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </DeleteParameters>
        <FilterParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </FilterParameters>
        <InsertParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </InsertParameters>
        <SelectParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </SelectParameters>
        <UpdateParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </UpdateParameters>
</asp:ObjectDataSource>

Konstruktor

ObjectDataSource()	Menginisialisasi instans baru kelas ObjectDataSource.
ObjectDataSource(String, String)	Menginisialisasi instans ObjectDataSource baru kelas dengan nama jenis dan nama metode pengambilan data yang ditentukan.

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)
BindingContainer	Mendapatkan kontrol yang berisi pengikatan data kontrol ini. (Diperoleh dari Control)
CacheDuration	Mendapatkan atau mengatur durasi waktu, dalam detik, bahwa kontrol sumber data menyimpan data yang diambil oleh SelectMethod properti .
CacheExpirationPolicy	Mendapatkan atau mengatur perilaku kedaluwarsa cache yang, ketika dikombinasikan dengan durasi, menjelaskan perilaku cache yang digunakan kontrol sumber data.
CacheKeyDependency	Mendapatkan atau mengatur dependensi kunci yang ditentukan pengguna yang ditautkan ke semua objek cache data yang dibuat oleh kontrol sumber data.
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)
ConflictDetection	Mendapatkan atau menetapkan nilai yang menentukan apakah nilai baru diteruskan ke `Update` metode atau nilai lama dan baru diteruskan ke `Update` metode atau tidak.
Context	Mendapatkan objek yang HttpContext terkait dengan kontrol server untuk permintaan Web saat ini. (Diperoleh dari Control)
Controls	ControlCollection Mendapatkan objek yang mewakili kontrol anak untuk kontrol server tertentu dalam hierarki UI. (Diperoleh dari DataSourceControl)
ConvertNullToDBNull	Mendapatkan atau mengatur nilai yang menunjukkan apakah Parameter nilai yang diteruskan ke operasi pembaruan, sisipkan, atau hapus secara otomatis dikonversi dari `null` ke Value nilai oleh ObjectDataSource kontrol.
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)
DataObjectTypeName	Mendapatkan atau mengatur nama kelas yang ObjectDataSource digunakan kontrol untuk parameter dalam operasi pembaruan, sisipkan, atau hapus data, alih-alih meneruskan nilai individual dari kontrol terikat data.
DeleteMethod	Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSource dipanggil kontrol untuk menghapus data.
DeleteParameters	Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh DeleteMethod metode .
DesignMode	Mendapatkan nilai yang menunjukkan apakah kontrol sedang digunakan pada permukaan desain. (Diperoleh dari Control)
EnableCaching	Mendapatkan atau menetapkan nilai yang menunjukkan apakah ObjectDataSource kontrol mengaktifkan penembolokan data.
EnablePaging	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol sumber data mendukung paging melalui kumpulan data yang diambilnya.
EnableTheming	Mendapatkan nilai yang menunjukkan apakah kontrol ini mendukung tema. (Diperoleh dari DataSourceControl)
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)
Events	Mendapatkan daftar delegasi penanganan aktivitas untuk kontrol. Properti ini bersifat hanya baca. (Diperoleh dari Control)
FilterExpression	Mendapatkan atau mengatur ekspresi pemfilteran yang diterapkan saat metode yang ditentukan oleh SelectMethod properti dipanggil.
FilterParameters	Mendapatkan kumpulan parameter yang terkait dengan tempat penampung parameter apa pun dalam FilterExpression string.
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)
InsertMethod	Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSource dipanggil kontrol untuk menyisipkan data.
InsertParameters	Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh InsertMethod properti .
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)
MaximumRowsParameterName	Mendapatkan atau mengatur nama parameter metode pengambilan data objek bisnis yang digunakan untuk menunjukkan jumlah rekaman yang akan diambil untuk dukungan penomoran halaman sumber data.
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)
OldValuesParameterFormatString	Mendapatkan atau mengatur string format untuk diterapkan ke nama parameter untuk nilai asli yang diteruskan ke `Delete` metode atau `Update` .
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)
ParsingCulture	Mendapatkan atau menetapkan nilai yang menunjukkan informasi budaya apa yang digunakan saat mengonversi nilai string ke jenis properti aktual untuk membangun objek jenis yang ditunjukkan oleh DataObjectTypeName.
RenderingCompatibility	Mendapatkan nilai yang menentukan versi ASP.NET yang akan kompatibel dengan HTML yang dirender. (Diperoleh dari Control)
SelectCountMethod	Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSource dipanggil kontrol untuk mengambil jumlah baris.
SelectMethod	Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSource dipanggil kontrol untuk mengambil data.
SelectParameters	Mendapatkan kumpulan parameter yang digunakan oleh metode yang ditentukan oleh SelectMethod properti .
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)
SortParameterName	Mendapatkan atau mengatur nama objek bisnis yang SelectMethod digunakan parameter untuk menentukan ekspresi pengurutan untuk dukungan pengurutan sumber data.
SqlCacheDependency	Mendapatkan atau mengatur string yang dibatasi titik koma yang menunjukkan database dan tabel mana yang akan digunakan untuk dependensi cache Microsoft SQL Server.
StartRowIndexParameterName	Mendapatkan atau mengatur nama parameter metode pengambilan data yang digunakan untuk menunjukkan nilai pengidentifikasi rekaman pertama yang diambil untuk dukungan halaman sumber 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)
TypeName	Mendapatkan atau mengatur nama kelas yang diwakili ObjectDataSource objek.
UniqueID	Mendapatkan pengidentifikasi unik yang memenuhi syarat secara hierarkis untuk kontrol server. (Diperoleh dari Control)
UpdateMethod	Mendapatkan atau mengatur nama metode atau fungsi yang ObjectDataSource dipanggil kontrol untuk memperbarui data.
UpdateParameters	Mendapatkan koleksi parameter yang berisi parameter yang digunakan oleh metode yang ditentukan oleh UpdateMethod properti .
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)

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)
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()	Melakukan operasi penghapusan dengan memanggil metode yang diidentifikasi oleh DeleteMethod properti dengan parameter apa pun yang ada dalam DeleteParameters koleksi.
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)	Mengambil tampilan sumber data bernama yang terkait dengan kontrol sumber data.
GetViewNames()	Mengambil kumpulan nama yang mewakili daftar objek tampilan yang terkait dengan ObjectDataSource objek .
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()	Melakukan operasi penyisipan dengan memanggil metode yang diidentifikasi oleh InsertMethod properti dan parameter apa pun dalam InsertParameters koleksi.
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 kontrol tampilan yang ObjectDataSource disimpan sebelumnya.
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)	Menambahkan penanganan LoadComplete aktivitas ke halaman yang berisi ObjectDataSource kontrol.
OnLoad(EventArgs)	Memunculkan kejadian Load. (Diperoleh dari Control)
OnPreRender(EventArgs)	Memunculkan kejadian PreRender. (Diperoleh dari Control)
OnUnload(EventArgs)	Memunculkan kejadian Unload. (Diperoleh dari Control)
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)
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 ObjectDataSource kontrol.
Select()	Mengambil data dari penyimpanan data yang mendasar dengan memanggil metode yang diidentifikasi oleh SelectMethod properti dengan parameter dalam SelectParameters koleksi.
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 ObjectDataSource kontrol sehingga dapat disimpan dalam StateBag objek.
Update()	Melakukan operasi pembaruan dengan memanggil metode yang diidentifikasi oleh UpdateMethod properti dan parameter apa pun yang ada dalam UpdateParameters koleksi.

Acara

DataBinding	Terjadi ketika kontrol server mengikat ke sumber data. (Diperoleh dari Control)
Deleted	Terjadi ketika Delete() operasi telah selesai.
Deleting	Terjadi sebelum Delete() operasi.
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)
Filtering	Terjadi sebelum operasi filter.
Init	Terjadi ketika kontrol server diinisialisasi, yang merupakan langkah pertama dalam siklus hidupnya. (Diperoleh dari Control)
Inserted	Terjadi ketika Insert() operasi telah selesai.
Inserting	Terjadi sebelum Insert() operasi.
Load	Terjadi ketika kontrol server dimuat ke Page dalam objek. (Diperoleh dari Control)
ObjectCreated	Terjadi setelah objek yang diidentifikasi oleh TypeName properti dibuat.
ObjectCreating	Terjadi sebelum objek yang diidentifikasi oleh TypeName properti dibuat.
ObjectDisposing	Terjadi sebelum objek yang diidentifikasi oleh TypeName properti dibuang.
PreRender	Terjadi setelah Control objek dimuat tetapi sebelum penyajian. (Diperoleh dari Control)
Selected	Terjadi ketika Select() operasi telah selesai.
Selecting	Terjadi sebelum Select() operasi.
Unload	Terjadi ketika kontrol server dibongkar dari memori. (Diperoleh dari Control)
Updated	Terjadi ketika Update() operasi telah selesai.
Updating	Terjadi sebelum Update() operasi.

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

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.
TryGetMetaTable(IDataSource, MetaTable)	Menentukan apakah metadata tabel tersedia.

Berlaku untuk

Share via