ObjectDataSource Sınıf

Tanım

Çok katmanlı Web uygulaması mimarilerindeki verilere bağlı denetimlere veri sağlayan bir iş nesnesini temsil eder.

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
Devralma
ObjectDataSource
Öznitelikler

Örnekler

Bu bölümde, ObjectDataSource bir .aspx sayfasında bir içinde işaretlemesi ve birlikte çalıştığı iş nesneleri gösterilir. Örnek, .aspx sayfasıdır. Bir denetime bağlı bir ObjectDataSource denetim içerirGridView. Denetim işaretlemesi ObjectDataSource , iş nesnesinin adını ve verileri almak için çağrılacak iş nesnesi yönteminin adını belirtir.

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

Aşağıdaki örnekte, .aspx sayfasındaki denetimin ObjectDataSource kullandığı iş nesnesi gösterilmektedir. (Diğer ObjectDataSource birçok kod örneği de bu iş nesnesini kullanır.) Örnek aşağıdaki iki temel sınıftan oluşur:

  • EmployeeLogic sınıfı, kullandığı iş mantığı sınıfıdırObjectDataSource.

  • sınıfı, NorthwindEmployee sınıfının yöntemi EmployeeLogic tarafından GetAllEmployees döndürülen veri nesnesini tanımlar.

Kolaylık sağlamak için ek NorthwindDataException bir sınıf sağlanır.

Bu örnek sınıf kümesi, Microsoft SQL Server ve Microsoft Access ile kullanılabilen Northwind Traders veritabanıyla çalışır. Tam bir çalışma örneği için bu sınıfları derleyip sağlanan .aspx sayfa örneğiyle kullanmanız gerekir.

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

Açıklamalar

Bu konuda:

Giriş

Denetim ObjectDataSource , oluşturduğunuz bir sınıfla çalışır. Verileri alıp güncelleştiren yöntemler oluşturur ve bu yöntemlerin adlarını işaretleme denetimine ObjectDataSource sağlarsınız. İşleme veya geri gönderme işlemi sırasında, ObjectDataSource belirttiğiniz yöntemleri çağırır.

Denetimin görsel işlemesi ObjectDataSource yok. Sonuç olarak, ObjectDataSource veya SkinID özelliği gibi EnableTheming görsel özellikleri desteklemez.

Amaç

Çok yaygın bir uygulama tasarımı uygulaması, sunu katmanını iş mantığından ayırmak ve iş nesnelerinde iş mantığını kapsüllemektir. Bu iş nesneleri, sunu katmanı ile veri katmanı arasında ayrı bir katman oluşturarak üç katmanlı bir uygulama mimarisi elde eder. Denetim, geliştiricilerin ObjectDataSource üç katmanlı uygulama mimarilerini korurken ASP.NET veri kaynağı denetimi kullanmasına olanak tanır.

Denetim, ObjectDataSource iş nesnelerinin örneklerini oluşturmak ve bunlar üzerinde veri almak, güncelleştirmek, eklemek ve silmek için yöntemleri çağırmak için yansıma kullanır. TypeName özelliği, ile çalışan sınıfın ObjectDataSource adını tanımlar. Denetim, ObjectDataSource her yöntem çağrısı için sınıfın bir örneğini oluşturur ve yok eder; Nesneyi Web isteğinin ömrü boyunca bellekte tutmaz. Bu, kullandığınız iş nesnesinin çok fazla kaynak gerektirdiğinde veya oluşturması ve yok etmek için pahalı olması durumunda dikkate alınması gereken önemli bir noktadır. Pahalı bir nesne kullanmak en uygun tasarım seçimi olmayabilir, ancak , ObjectCreatedve ObjectDisposing olaylarını kullanarak ObjectCreatingnesnenin yaşam döngüsünü denetleyebilirsiniz.

Not

, , InsertMethodUpdateMethodve DeleteMethod özellikleri tarafından SelectMethodtanımlanan yöntemler örnek yöntemleri veya static (Shared Visual Basic'te) yöntemler olabilir. Yöntemler static (Shared Visual Basic'te) ise, iş nesnesinin bir örneği oluşturulmaz ve ObjectCreating, ObjectCreatedve ObjectDisposing olayları oluşturulmaz.

Veri Alma

bir iş nesnesinden veri almak için özelliğini, verileri alan yöntemin adına ayarlayın SelectMethod . Yöntem bir IEnumerable veya DataSet nesnesi döndürmezse, nesne bir IEnumerable koleksiyondaki çalışma zamanı tarafından sarmalanır. Yöntem imzasının parametreleri varsa, koleksiyona SelectParameters nesneler ekleyebilir Parameter ve sonra bunları özelliği tarafından SelectMethod belirtilen yönteme geçirmek istediğiniz değerlere bağlayabilirsiniz. Denetimin ObjectDataSource parametreleri kullanabilmesi için, parametrelerin yöntem imzasında parametrelerin adlarıyla ve türleriyle eşleşmesi gerekir. Daha fazla bilgi için bkz. ObjectDataSource Denetimi ile Parametreleri Kullanma.

Denetim, ObjectDataSource yöntem her çağrıldığında Select verileri alır. Bu yöntem, özelliği tarafından SelectMethod belirtilen yönteme programlı erişim sağlar. özelliği tarafından SelectMethod belirtilen yöntem, yöntemi çağrıldığında DataBind öğesine bağlı ObjectDataSource denetimler tarafından otomatik olarak çağrılır. Veriye bağlı denetimin özelliğini ayarlarsanız DataSourceID , denetim gerektiğinde veri kaynağındaki verilere otomatik olarak bağlanır. özelliğini ayarlamak DataSourceID , bir denetimi veriye bağlı denetime ObjectDataSource bağlamak için önerilen yöntemdir. Alternatif olarak, özelliğini ayarlayabilirsiniz DataSource , ancak daha sonra veriye bağlı denetimin DataBind yöntemini açıkça çağırmanız gerekir. İstediğiniz zaman verileri almak için yöntemini program aracılığıyla çağırabilirsiniz Select .

Veriye bağlı denetimleri veri kaynağı denetimlerine bağlama hakkında daha fazla bilgi için bkz. Veri Kaynağı Denetimi Kullanarak Verilere Bağlama.

Veri İşlemleri Gerçekleştirme

Denetimin birlikte çalıştığı iş nesnesinin ObjectDataSource özelliklerine bağlı olarak güncelleştirmeler, eklemeler ve silmeler gibi veri işlemleri gerçekleştirebilirsiniz. Bu veri işlemlerini gerçekleştirmek için, gerçekleştirmek istediğiniz işlem için uygun yöntem adını ve ilişkili parametreleri ayarlayın. Örneğin, bir güncelleştirme işlemi için özelliğini güncelleştirmeleri gerçekleştiren iş nesnesi yönteminin adına ayarlayın UpdateMethod ve gerekli parametreleri koleksiyona UpdateParameters ekleyin. ObjectDataSource Denetim bir veriye bağlı denetimle ilişkiliyse, parametreler veriye bağlı denetim tarafından eklenir. Bu durumda, yöntemin parametre adlarının veriye bağlı denetimdeki alan adlarına eşleştiğinden emin olmanız gerekir. Yöntem açıkça kodunuz tarafından veya veriye bağlı bir denetim tarafından otomatik olarak çağrıldığında Update güncelleştirme gerçekleştirilir. ve Insert işlemleri için Delete de aynı genel desen izlenir. İş nesnelerinin bu tür veri işlemlerini toplu işlem yerine tek gerçekleştirecekleri varsayılır.

Verileri Filtreleme

DenetimObjectDataSource, veriler veya DataSetDataTable nesnesi olarak döndürülürse özelliği tarafından SelectMethod alınan verileri filtreleyebilir. Bir biçim dizesi söz dizimi kullanarak özelliğini bir filtreleme ifadesi olarak ayarlayabilir FilterExpression ve ifadedeki değerleri koleksiyonda FilterParameters belirtilen parametrelere bağlayabilirsiniz.

Önbelleğe Alma

birden çok istekte iş nesnesinin örneğini tutmasa ObjectDataSource da, özelliği tarafından SelectMethod tanımlanan yöntemi çağırmanın sonucunu önbelleğe alabilir. Veriler önbelleğe alınırken yöntemine yapılan Select sonraki çağrılar, iş nesnesini oluşturmak ve yansıma kullanarak çağırmak SelectMethod yerine önbelleğe alınmış verileri döndürür. Önbelleğe alma, nesneyi oluşturmaktan ve Web sunucusundaki bellek pahasına veri yöntemini çağırmaktan kaçınmanızı sağlar. ObjectDataSource özelliği olarak ayarlandığında verileri otomatik olarak önbelleğe EnableCachingtruealır ve CacheDuration özellik, önbellek atilmeden önce önbelleğin verileri depolaması için gereken saniye sayısına ayarlanır. Ayrıca bir CacheExpirationPolicy özellik ve isteğe bağlı SqlCacheDependency bir özellik de belirtebilirsiniz. Denetim ObjectDataSource , tüm veri türlerini önbelleğe almanızı sağlar, ancak birden çok isteğe (örneğin, açık SqlDataReader bir nesne) hizmet vermek için paylaşılamayan kaynakları veya durumu koruyan nesneleri önbelleğe almamalısınız, çünkü nesnenin aynı örneği birden çok isteğe hizmet vermek için kullanılacaktır.

Özellikler

Aşağıdaki tabloda denetimin özellikleri ObjectDataSource açıklanmaktadır.

Özellik Gereksinimler
Seçme SelectMethod özelliğini, verileri seçen iş nesnesi yönteminin adına ayarlayın ve program aracılığıyla veya veriye bağlı bir denetim kullanarak koleksiyona SelectParameters gerekli parametreleri ekleyin.
Sıralama SortParameterName özelliğini, sıralama ölçütlerini taşıyan yöntemde SelectMethod parametresinin adına ayarlayın.
Filtreleme FilterExpression özelliğini bir filtreleme ifadesi olarak ayarlayın ve isteğe bağlı olarak yöntem çağrıldığında verileri filtrelemek için koleksiyona Select herhangi bir parametre FilterParameters ekleyin. özelliği tarafından belirtilen yöntemin SelectMethod veya DataTabledöndürmesi DataSet gerekir.
Sayfalama Yöntem alınacak en fazla kayıt sayısı ve alınacak ilk kaydın dizini için parametreler içeriyorsa veri SelectMethod kaynağı disk belleği desteklenir. Bu parametrelerin adları sırasıyla ve StartRowIndexParameterName özelliklerinde MaximumRowsParameterName ayarlanmalıdır. Denetim özelliği tarafından SelectMethod belirtilen yöntemde doğrudan disk belleğini desteklemese ObjectDataSource bile veriye bağlı bir denetim disk belleği gerçekleştirebilir. Veriye bağlı denetimin bunu yapabilmesi için gereksinim, özelliği tarafından belirtilen yöntemin SelectMethod arabirimi uygulayan bir nesne döndürmesidir ICollection .
Güncelleştirme UpdateMethod özelliğini, verileri güncelleştiren iş nesnesi yönteminin adına ayarlayın ve koleksiyona UpdateParameters gerekli parametreleri ekleyin.
Siliniyor DeleteMethod özelliğini, verileri silecek iş nesnesi yönteminin veya işlevinin adına ayarlayın ve koleksiyona DeleteParameters gerekli parametreleri ekleyin.
Ekleme InsertMethod özelliğini, veri ekleyen iş nesnesi yönteminin veya işlevinin adına ayarlayın ve koleksiyona InsertParameters gerekli parametreleri ekleyin.
Önbelleğe Alma EnableCaching özelliğini trueve CacheDurationCacheExpirationPolicy ve özelliklerini önbelleğe alınan verileriniz için istediğiniz önbelleğe alma davranışına göre ayarlayın.

Not

Verileri güncelleştirmek veya eklemek için sınıfını kullandığınızda ObjectDataSource , istemciye girilen dizeler istemci kültürü biçiminden sunucu kültürü biçimine otomatik olarak dönüştürülmez. Örneğin, istemci kültürü tarih biçimi olarak DD/AA/YYYY belirtebilir ve sunucudaki tarih biçimi AA/GG/YYYY olabilir. Bu durumda, 5 Ekim 2009 bir TextBox denetime 10.05.2009 olarak girilir ancak 10 Mayıs 2009 olarak yorumlanır. 15 Ekim 2009, 10.15.2009 olarak girilecek ve geçersiz tarih olarak reddedilecekti.

Veri Görünümü

Tüm veri kaynağı denetimlerde olduğu gibi denetim de ObjectDataSource bir veri kaynağı görünüm sınıfıyla ilişkilendirilir. ObjectDataSource Denetim, sayfa geliştiricisinin verilerle çalışmak için kullandığı arabirim olsa da, ObjectDataSourceView sınıf veriye bağlı denetimlerin birlikte çalıştığı arabirimdir. Ayrıca sınıfı, ObjectDataSourceView veri kaynağı denetiminin özelliklerini açıklar ve gerçek işi gerçekleştirir. Denetimin ObjectDataSource yalnızca bir ilişkili ObjectDataSourceViewvardır ve her zaman olarak adlandırılır DefaultView. ObjectDataSourceView Nesnesi yöntemi tarafından GetView kullanıma sunulurken, özelliklerinin ve yöntemlerinin çoğu sarmalanır ve doğrudan denetim tarafından ObjectDataSource kullanıma sunulur. Arka planda nesne verileri alma, ObjectDataSourceView ekleme, güncelleştirme, silme, filtreleme ve sıralama dahil olmak üzere tüm veri işlemlerini gerçekleştirir. Daha fazla bilgi için bkz. ObjectDataSourceView.

LINQ to SQL kullanma

DENETIMI LINQ to SQL sınıfıyla kullanabilirsiniz ObjectDataSource . Bunu yapmak için, özelliğini veri bağlamı sınıfının adına ayarlarsınız TypeName . Ayrıca , UpdateMethod, InsertMethodve DeleteMethod yöntemlerini ilgili işlemleri gerçekleştiren veri bağlamı sınıfındaki yöntemlere ayarlarsınızSelectMethod. Veri bağlamı sınıfının yok edilmesi işlemini iptal etmek için olay için ObjectDisposing bir olay işleyicisi oluşturmanız gerekir. LINQ to SQL ertelenmiş yürütmeyi desteklediğinden, denetim Select işleminden ObjectDataSource sonra veri bağlamını atmayı denediğinden bu adım gereklidir. LINQ to SQL sınıfları oluşturma hakkında daha fazla bilgi için bkz . Nasıl yapılır: Web Projesinde LINQ to SQL Sınıfları Oluşturma. Veri bağlamı sınıfının kullanımdan kaldırılma işleminin nasıl iptal edileceğine ilişkin bir örnek için olaya bakın ObjectDisposing .

Entity Framework kullanma

Denetimi Entity Framework ile de kullanabilirsiniz ObjectDataSource . Daha fazla bilgi için bkz. Entity Framework ve ObjectDataSource Denetimini Kullanma.

Tanımlayıcı Sözdizimi

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

Oluşturucular

ObjectDataSource()

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

ObjectDataSource(String, String)

Belirtilen tür adı ve veri alma yöntemi adıyla sınıfının yeni bir örneğini ObjectDataSource başlatır.

Özellikler

Adapter

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

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

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

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

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

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

Veri kaynağı denetiminin özelliği tarafından SelectMethod alınan verileri önbelleğe aldığı süreyi saniye cinsinden alır veya ayarlar.

CacheExpirationPolicy

Süreyle birleştirildiğinde veri kaynağı denetiminin kullandığı önbelleğin davranışını açıklayan önbellek süre sonu davranışını alır veya ayarlar.

CacheKeyDependency

Veri kaynağı denetimi tarafından oluşturulan tüm veri önbelleği nesnelerine bağlı kullanıcı tanımlı bir anahtar bağımlılığını alır veya ayarlar.

ChildControlsCreated

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

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

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

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

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

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

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

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

Yalnızca yeni değerlerin yönteme geçirilip geçirilmeyeceğini veya hem eski hem de yeni değerlerin Update yönteme Update geçirilip geçirilmeyeceğini belirleyen bir değeri alır veya ayarlar.

Context

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

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

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

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

Güncelleştirme, ekleme veya silme işlemine geçirilen değerlerin Parameter denetim tarafından ObjectDataSource değerinden otomatik olarak değere Value dönüştürüldüğünü null belirten bir değeri alır veya ayarlar.

DataItemContainer

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

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

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

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

Denetimin veriye bağlı denetimden tek tek değerleri geçirmek yerine bir güncelleştirme, ekleme veya silme işleminde parametre için kullandığı bir sınıfın ObjectDataSource adını alır veya ayarlar.

DeleteMethod

Denetimin verileri silmek için çağırdığını yöntem veya işlevin ObjectDataSource adını alır veya ayarlar.

DeleteParameters

yöntemi tarafından DeleteMethod kullanılan parametreleri içeren parameters koleksiyonunu alır.

DesignMode

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

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

Denetimin veri önbelleğe alma özelliğinin ObjectDataSource etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

EnablePaging

Veri kaynağı denetiminin aldığı veri kümesi aracılığıyla disk belleğini destekleyip desteklemediğini belirten bir değer alır veya ayarlar.

EnableTheming

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

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

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

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

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

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

özelliği tarafından SelectMethod belirtilen yöntem çağrıldığında uygulanan bir filtreleme ifadesi alır veya ayarlar.

FilterParameters

Dizedeki tüm parametre yer tutucularıyla FilterExpression ilişkili bir parametre koleksiyonunu alır.

HasChildViewState

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

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

Sunucu denetimine atanan program tanımlayıcısını alır veya ayarlar.

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

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

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

Denetimin veri eklemek için çağırdığını yöntem veya işlevin ObjectDataSource adını alır veya ayarlar.

InsertParameters

özelliği tarafından InsertMethod kullanılan parametreleri içeren parameters koleksiyonunu alır.

IsChildControlStateCleared

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

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

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

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

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

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

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

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

Veri kaynağı disk belleği desteği için alınacak kayıt sayısını belirtmek için kullanılan iş nesnesi veri alma yöntemi parametresinin adını alır veya ayarlar.

NamingContainer

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

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

veya yöntemlerine geçirilen Delete özgün değerler için parametrelerin adlarına uygulanacak bir biçim dizesi alır veya Update ayarlar.

Page

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

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

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

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

tarafından DataObjectTypeNamebelirtilen türde bir nesne oluşturmak için dize değerlerini gerçek özellik türlerine dönüştürürken hangi kültür bilgilerinin kullanıldığını gösteren veya değerini alır.

RenderingCompatibility

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

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

Denetimin bir satır sayısını almak için çağırdığını yöntem veya işlevin ObjectDataSource adını alır veya ayarlar.

SelectMethod

Denetimin verileri almak için çağırdığını yöntem veya işlevin ObjectDataSource adını alır veya ayarlar.

SelectParameters

özelliği tarafından SelectMethod belirtilen yöntemi tarafından kullanılan bir parametre koleksiyonunu alır.

Site

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

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

Denetime uygulanacak kaplamayı DataSourceControl alır.

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

Veri kaynağı sıralama desteği için bir sıralama ifadesi belirtmek için parametresinin SelectMethod kullandığı iş nesnesinin adını alır veya ayarlar.

SqlCacheDependency

Microsoft SQL Server önbellek bağımlılığı için hangi veritabanlarının ve tabloların kullanılacağını gösteren noktalı virgülle ayrılmış bir dize alır veya ayarlar.

StartRowIndexParameterName

Veri kaynağı disk belleği desteği için alınacak ilk kaydın tanımlayıcısının değerini belirtmek için kullanılan veri alma yöntemi parametresinin adını alır veya ayarlar.

TemplateControl

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

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

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

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

Nesnenin temsil ettiği ObjectDataSource sınıfın adını alır veya ayarlar.

UniqueID

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

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

Denetimin verileri güncelleştirmek için çağırdığını yöntem veya işlevin ObjectDataSource adını alır veya ayarlar.

UpdateParameters

özelliği tarafından UpdateMethod belirtilen yöntemi tarafından kullanılan parametreleri içeren parameters koleksiyonunu alır.

ValidateRequestMode

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

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

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

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

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

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

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

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

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

(Devralındığı yer: DataSourceControl)

Yöntemler

AddedControl(Control, Int32)

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

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

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

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

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

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

İşleme verilerinin tasarım zamanı izlemeye başlar.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

özelliği tarafından DeleteMethod tanımlanan yöntemini koleksiyondaki DeleteParameters tüm parametrelerle çağırarak bir silme işlemi gerçekleştirir.

Dispose()

Sunucu denetiminin bellekten serbest bırakılmadan önce son temizleme işlemini gerçekleştirmesini sağlar.

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

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

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

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

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

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

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

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

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

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

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

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

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

Giriş odağını denetime ayarlar.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Veri kaynağı denetimiyle ilişkili adlandırılmış veri kaynağı görünümünü alır.

GetViewNames()

Nesneyle ObjectDataSource ilişkili görünüm nesnelerinin listesini temsil eden bir ad koleksiyonu alır.

HasControls()

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

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

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

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

özelliği ve koleksiyondaki InsertParameters herhangi bir parametre tarafından InsertMethod tanımlanan yöntemini çağırarak bir ekleme işlemi gerçekleştirir.

IsLiteralContent()

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

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

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

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

Denetimin daha önce kaydedilmiş görünüm durumunu ObjectDataSource yükler.

MapPathSecure(String)

Bir sanal yolun mutlak veya göreli olarak eşlene olduğu fiziksel yolu alır.

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

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

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

Sunucu denetimi olayının sayfanın UI sunucu denetim hiyerarşisine geçirilip geçirilmeyeceğini belirler.

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

Olayı tetikler DataBinding .

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

Denetimi içeren sayfaya bir LoadComplete olay işleyicisi ObjectDataSource ekler.

OnLoad(EventArgs)

Olayı tetikler Load .

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

Olayı tetikler PreRender .

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

Olayı tetikler Unload .

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

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

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

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

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

Olayı tetikler DataSourceChanged .

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

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

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

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

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

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

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

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

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

Sağlanan bir nesneyi kullanarak sağlanan HtmlTextWriter bir nesneye sunucu denetimi içeriği çıkışı sağlar ControlAdapter .

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

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

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

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

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

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

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

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

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

Denetimin durumunu ObjectDataSource kaydeder.

Select()

özelliği tarafından SelectMethod tanımlanan yöntemini koleksiyondaki parametrelerle çağırarak temel alınan veri depolama alanından SelectParameters verileri alır.

SetDesignModeState(IDictionary)

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

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

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

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

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

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

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

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

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

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

Nesnede depolanabilmeleri için denetimdeki ObjectDataSourceStateBag görünüm durumu değişikliklerini izler.

Update()

özelliği ve koleksiyondaki UpdateParameters tüm parametreler tarafından UpdateMethod tanımlanan yöntemini çağırarak bir güncelleştirme işlemi gerçekleştirir.

Ekinlikler

DataBinding

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

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

İşlem Delete() tamamlandığında gerçekleşir.

Deleting

İşlemden Delete() önce gerçekleşir.

Disposed

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

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

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

Init

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

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

İşlem Insert() tamamlandığında gerçekleşir.

Inserting

İşlemden Insert() önce gerçekleşir.

Load

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

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

özelliği tarafından TypeName tanımlanan nesne oluşturulduktan sonra gerçekleşir.

ObjectCreating

özelliği tarafından TypeName tanımlanan nesne oluşturulmadan önce gerçekleşir.

ObjectDisposing

özelliği tarafından TypeName tanımlanan nesne atmadan önce gerçekleşir.

PreRender

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

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

İşlem Select() tamamlandığında gerçekleşir.

Selecting

İşlemden Select() önce gerçekleşir.

Unload

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

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

İşlem Update() tamamlandığında gerçekleşir.

Updating

İşlemden Update() önce gerçekleşir.

Belirtik Arabirim Kullanımları

IControlBuilderAccessor.ControlBuilder

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

(Devralındığı yer: DataSourceControl)
IExpressionsAccessor.Expressions

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

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

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

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

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

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

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

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

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

(Devralındığı yer: Control)

Uzantı Metotları

FindDataSourceControl(Control)

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

FindFieldTemplate(Control, String)

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

FindMetaTable(Control)

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

GetDefaultValues(IDataSource)

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

GetMetaTable(IDataSource)

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

TryGetMetaTable(IDataSource, MetaTable)

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

Şunlara uygulanır

Ayrıca bkz.