ObjectDataSource Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje obiekt biznesowy, który dostarcza dane do kontrolek powiązanych z danymi w wielowarstwowych architekturach aplikacji internetowych.

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

Dziedziczenie: Object

Control

DataSourceControl
ObjectDataSource

Atrybuty: ToolboxBitmapAttribute

Przykłady

W tej sekcji przedstawiono znaczniki ObjectDataSource na stronie .aspx i są wyświetlane obiekty biznesowe, z którymi współpracuje. Przykładem jest strona .aspx. Zawiera kontrolkę GridView powiązaną z kontrolką ObjectDataSource . Znacznik ObjectDataSource kontroli określa nazwę obiektu biznesowego i nazwę metody obiektu biznesowego do wywołania w celu pobrania danych.

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

W poniższym przykładzie przedstawiono obiekt biznesowy używany przez kontrolkę ObjectDataSource na stronie .aspx. (Wiele innych ObjectDataSource przykładów kodu używa również tego obiektu biznesowego). Przykład składa się z następujących dwóch podstawowych klas:

Klasa EmployeeLogic jest klasą logiki biznesowej, która ObjectDataSource jest używana.
Klasa NorthwindEmployee definiuje obiekt danych zwracany przez GetAllEmployees metodę EmployeeLogic klasy.

Dodatkowa NorthwindDataException klasa jest dostarczana jako wygoda.

Ten zestaw przykładowych klas współdziała z bazą danych Northwind Traders, która jest dostępna w programach Microsoft SQL Server i Microsoft Access. Aby uzyskać pełny przykład pracy, należy skompilować i użyć tych klas z podanym przykładem strony .aspx.

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

Uwagi

W tym temacie:

Wprowadzenie
Cel
Pobieranie danych
Wykonywanie operacji na danych
Filtrowanie danych
Buforowanie
Funkcje
Widok danych
Używanie LINQ to SQL
Składnia deklaracyjna

Wprowadzenie

Kontrolka ObjectDataSource działa z klasą, którą tworzysz. Tworzysz metody, które pobierają i aktualizują dane, i podajesz nazwy tych metod do kontrolki ObjectDataSource w adiustacji. Podczas renderowania lub przetwarzania ObjectDataSource zwrotnego metody są wywoływane określone przez Ciebie metody.

Nie ma wizualizacji renderowania kontrolki ObjectDataSource . W związku z tym element ObjectDataSource nie obsługuje funkcji wizualnych, takich jak EnableTheming właściwość lub SkinID .

Przeznaczenie

Bardzo typową praktyką projektowania aplikacji jest oddzielenie warstwy prezentacji od logiki biznesowej i hermetyzowanie logiki biznesowej w obiektach biznesowych. Te obiekty biznesowe tworzą odrębną warstwę między warstwą prezentacji a warstwą danych, co skutkuje architekturą aplikacji trójwarstwowej. Kontrolka ObjectDataSource umożliwia deweloperom korzystanie z ASP.NET kontroli źródła danych przy zachowaniu architektury aplikacji trójwarstwowej.

Kontrolka ObjectDataSource używa odbicia do tworzenia wystąpień obiektów biznesowych i wywoływania metod w celu pobierania, aktualizowania, wstawiania i usuwania danych. Właściwość TypeName identyfikuje nazwę klasy, ObjectDataSource z którą działa. Kontrolka ObjectDataSource tworzy i niszczy wystąpienie klasy dla każdego wywołania metody; nie przechowuje obiektu w pamięci przez cały okres istnienia żądania sieci Web. Jest to poważna kwestia, jeśli używany obiekt biznesowy wymaga wielu zasobów lub jest w inny sposób kosztowny do utworzenia i zniszczenia. Użycie kosztownego obiektu może nie być optymalnym wyborem projektowym, ale można kontrolować cykl życia obiektu przy użyciu zdarzeń ObjectCreating, ObjectCreatedi ObjectDisposing .

Uwaga

Metody identyfikowane przez SelectMethodwłaściwości , , InsertMethod UpdateMethodi DeleteMethod mogą być metodami wystąpienia lub static (Sharedw języku Visual Basic). Jeśli metody to static (Shared w Visual Basic), wystąpienie obiektu biznesowego nie jest tworzone, a ObjectCreatingzdarzenia , ObjectCreatedi ObjectDisposing nie są wywoływane.

Pobieranie danych

Aby pobrać dane z obiektu biznesowego, ustaw SelectMethod właściwość na nazwę metody pobierającej dane. Jeśli metoda nie zwraca IEnumerable obiektu lub DataSet , obiekt jest opakowany przez środowisko uruchomieniowe w IEnumerable kolekcji. Jeśli podpis metody ma parametry, możesz dodać Parameter obiekty do SelectParameters kolekcji, a następnie powiązać je z wartościami, które chcesz przekazać do metody określonej przez SelectMethod właściwość. Aby kontrolka ObjectDataSource używała parametrów, parametry muszą być zgodne z nazwami i typami parametrów w podpisie metody. Aby uzyskać więcej informacji, zobacz Using Parameters with the ObjectDataSource Control (Używanie parametrów z kontrolką ObjectDataSource).

Kontrolka ObjectDataSource pobiera dane za każdym razem, gdy jest wywoływana Select metoda. Ta metoda zapewnia programowy dostęp do metody określonej przez SelectMethod właściwość. Metoda określona przez SelectMethod właściwość jest wywoływana automatycznie przez kontrolki powiązane z ObjectDataSourceDataBind wywołaną metodą . Jeśli ustawisz DataSourceID właściwość kontrolki powiązanej z danymi, kontrolka automatycznie wiąże się z danymi ze źródła danych zgodnie z potrzebami. DataSourceID Ustawienie właściwości jest zalecaną metodą powiązania kontrolki ObjectDataSource z formantem powiązanym z danymi. Alternatywnie można ustawić DataSource właściwość, ale następnie należy jawnie wywołać DataBind metodę kontrolki powiązanej z danymi. Metodę Select można wywołać programowo w dowolnym momencie, aby pobrać dane.

Aby uzyskać więcej informacji na temat wiązania kontrolek powiązanych z danymi do kontrolek źródła danych, zobacz Powiązanie z danymi przy użyciu kontroli źródła danych.

Wykonywanie operacji na danych

W zależności od możliwości obiektu biznesowego, ObjectDataSource z którym współpracuje kontrolka, można wykonywać operacje danych, takie jak aktualizacje, wstawiania i usuwania. Aby wykonać te operacje danych, ustaw odpowiednią nazwę metody i wszystkie skojarzone parametry dla operacji, którą chcesz wykonać. Na przykład w przypadku operacji aktualizacji ustaw UpdateMethod właściwość na nazwę metody obiektu biznesowego, która wykonuje aktualizacje, i dodaj wszystkie wymagane parametry do UpdateParameters kolekcji. Jeśli kontrolka ObjectDataSource jest skojarzona z kontrolką związaną z danymi, parametry są dodawane przez kontrolkę związaną z danymi. W takim przypadku należy upewnić się, że nazwy parametrów metody są zgodne z nazwami pól w kontrolce powiązanej z danymi. Aktualizacja jest wykonywana po wywołaniu Update metody jawnie przez kod lub automatycznie za pomocą kontrolki powiązanej z danymi. Ten sam ogólny wzorzec jest obserwowany dla Delete operacji i .Insert Zakłada się, że obiekty biznesowe wykonują te typy operacji danych jeden rekord naraz, a nie wsadowe.

Filtrowanie danych

Kontrolka ObjectDataSource może filtrować dane pobierane przez SelectMethod właściwość, jeśli dane są zwracane jako DataSet obiekt lub DataTable . Właściwość można ustawić FilterExpression na wyrażenie filtrowania przy użyciu składni ciągu formatu i powiązać wartości w wyrażeniu z parametrami określonymi w kolekcji FilterParameters .

Buforowanie

ObjectDataSource Chociaż obiekt biznesowy nie zachowuje wystąpienia obiektu biznesowego w wielu żądaniach, może buforować wynik wywołania metody zidentyfikowanej przez SelectMethod właściwość. Podczas gdy dane są buforowane, kolejne wywołania Select metody zwracają buforowane dane zamiast tworzyć obiekt biznesowy i wywoływać je SelectMethod przy użyciu odbicia. Buforowanie pozwala uniknąć tworzenia obiektu i wywoływania jego metody danych kosztem pamięci na serwerze sieci Web. Właściwość ObjectDataSource automatycznie buforuje dane, gdy EnableCaching właściwość jest ustawiona na truewartość , a CacheDuration właściwość jest ustawiona na liczbę sekund, w których pamięć podręczna przechowuje dane przed odrzuceniem pamięci podręcznej. Można również określić CacheExpirationPolicy właściwość i właściwość opcjonalną SqlCacheDependency . Kontrolka ObjectDataSource umożliwia buforowanie wszystkich typów danych, ale nie należy buforować obiektów, które zachowują zasoby lub stan, których nie można udostępnić do obsługi wielu żądań (na przykład otwartego SqlDataReader obiektu), ponieważ to samo wystąpienie obiektu będzie używane do obsługi wielu żądań.

Funkcje

W poniższej tabeli opisano funkcje kontrolki ObjectDataSource .

Możliwość	Wymagania
Wybieranie	SelectMethod Ustaw właściwość na nazwę metody obiektu biznesowego, która wybiera dane, i uwzględnij wszelkie niezbędne parametry w SelectParameters kolekcji programowo lub przy użyciu kontrolki powiązanej z danymi.
Sortowanie	SortParameterName Ustaw właściwość na nazwę parametru w SelectMethod metodzie, która zawiera kryteria sortowania.
Filtrowanie	FilterExpression Ustaw właściwość na wyrażenie filtrowania i opcjonalnie dodaj wszystkie parametry do FilterParameters kolekcji, aby filtrować dane po Select wywołaniu metody. Metoda określona SelectMethod przez właściwość musi zwrócić wartość DataSet lub DataTable.
Stronicowanie	Stronicowanie źródła danych jest obsługiwane, jeśli SelectMethod metoda zawiera parametry maksymalnej liczby rekordów do pobrania i indeks pierwszego rekordu do pobrania. Nazwy tych parametrów muszą być ustawione odpowiednio we właściwościach MaximumRowsParameterName i StartRowIndexParameterName . Kontrolka powiązana z danymi może być w stanie wykonać stronicowanie, nawet jeśli ObjectDataSource kontrolka nie obsługuje stronicowania bezpośrednio w metodzie określonej przez SelectMethod właściwość. Wymaganie, aby kontrolka powiązana z danymi mogła to zrobić, jest to, że metoda określona przez SelectMethod właściwość zwraca obiekt implementujący ICollection interfejs.
Aktualizowanie	UpdateMethod Ustaw właściwość na nazwę metody obiektu biznesowego, która aktualizuje dane, i dołącz wszelkie niezbędne parametry w kolekcjiUpdateParameters.
Usuwanie	DeleteMethod Ustaw właściwość na nazwę metody lub funkcji obiektu biznesowego, która usuwa dane, i uwzględnij wszystkie niezbędne parametry w kolekcjiDeleteParameters.
Wstawianie	InsertMethod Ustaw właściwość na nazwę metody lub funkcji obiektu biznesowego, która wstawia dane, i uwzględnij wszystkie niezbędne parametry w kolekcjiInsertParameters.
Buforowanie	EnableCaching Ustaw właściwość na `true`, i CacheDuration CacheExpirationPolicy właściwości zgodnie z zachowaniem buforowania, które ma być przechowywane w pamięci podręcznej.

Uwaga

Gdy używasz ObjectDataSource klasy do aktualizowania lub wstawiania danych, ciągi wprowadzone na kliencie nie są automatycznie konwertowane z formatu kultury klienta na format kultury serwera. Na przykład kultura klienta może określać DD/MM/RRRR jako format daty, a format daty na serwerze może być MM/DD/RRRR. W takim przypadku 5 października 2009 r. zostanie wprowadzony do TextBox kontroli jako 5/10/2009, ale zostanie zinterpretowany jako 10 maja 2009 r. 15 października 2009 r. zostanie wprowadzony jako 15/10/2009 i zostanie odrzucony jako nieprawidłowa data.

Widok danych

Podobnie jak w przypadku wszystkich kontrolek źródła danych, kontrolka ObjectDataSource jest skojarzona z klasą widoku źródła danych. Chociaż kontrolka ObjectDataSource jest interfejsem używanym przez dewelopera strony do pracy z danymi, ObjectDataSourceView klasa jest interfejsem, z którego działają kontrolki powiązane z danymi. Ponadto klasa ObjectDataSourceView opisuje możliwości kontroli źródła danych i wykonuje rzeczywistą pracę. Kontrolka ObjectDataSource ma tylko jeden skojarzony element ObjectDataSourceViewi zawsze nosi nazwę DefaultView. ObjectDataSourceView Chociaż obiekt jest uwidoczniony przez metodęGetView, wiele jego właściwości i metod jest opakowanych i uwidocznionych bezpośrednio przez kontrolkęObjectDataSource. Za kulisami ObjectDataSourceView obiekt wykonuje wszystkie operacje danych, w tym pobieranie, wstawianie, aktualizowanie, usuwanie, filtrowanie i sortowanie danych. Aby uzyskać więcej informacji, zobacz ObjectDataSourceView.

Używanie LINQ to SQL

Możesz użyć kontrolki ObjectDataSource z klasą LINQ to SQL. W tym celu należy ustawić TypeName właściwość na nazwę klasy kontekstu danych. Należy również ustawić SelectMethodmetody , UpdateMethod, InsertMethodi DeleteMethod na metody w klasie kontekstu danych, które wykonują odpowiednie operacje. Aby anulować usuwanie klasy kontekstu danych, należy utworzyć procedurę obsługi zdarzeń ObjectDisposing dla zdarzenia. Ten krok jest niezbędny, ponieważ linQ to SQL obsługuje odroczone wykonywanie, podczas gdy kontrolka ObjectDataSource próbuje usunąć kontekst danych po operacji Wybierz. Aby uzyskać więcej informacji na temat tworzenia klas LINQ to SQL, zobacz How to: Create LINQ to SQL Classes in a Web Project (Instrukcje: tworzenie klas LINQ to SQL w projekcie internetowym). Aby zapoznać się z przykładem anulowania rozpowszechniania klasy kontekstu danych, zobacz ObjectDisposing zdarzenie.

Korzystanie z programu Entity Framework

Możesz również użyć kontrolki ObjectDataSource z programem Entity Framework. Aby uzyskać więcej informacji, zobacz Using the Entity Framework and the ObjectDataSource Control (Używanie struktury Entity Framework i kontrolki ObjectDataSource).

Składnia deklaracyjna

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

Konstruktory

ObjectDataSource()	Inicjuje nowe wystąpienie klasy ObjectDataSource.
ObjectDataSource(String, String)	Inicjuje ObjectDataSource nowe wystąpienie klasy o określonej nazwie typu i nazwie metody pobierania danych.

Właściwości

Adapter	Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control)
AppRelativeTemplateSourceDirectory	Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control)
BindingContainer	Pobiera kontrolkę zawierającą powiązanie danych tego formantu. (Odziedziczone po Control)
CacheDuration	Pobiera lub ustawia czas w sekundach, przez który kontrolka źródła danych buforuje dane pobierane przez SelectMethod właściwość.
CacheExpirationPolicy	Pobiera lub ustawia zachowanie wygasania pamięci podręcznej, które w połączeniu z czasem trwania opisuje zachowanie pamięci podręcznej używanej przez kontrolę źródła danych.
CacheKeyDependency	Pobiera lub ustawia zależność klucza zdefiniowanego przez użytkownika, która jest połączona z wszystkimi obiektami pamięci podręcznej danych utworzonymi przez kontrolę źródła danych.
ChildControlsCreated	Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone. (Odziedziczone po Control)
ClientID	Pobiera identyfikator kontroli serwera wygenerowany przez ASP.NET. (Odziedziczone po DataSourceControl)
ClientIDMode	Ta właściwość nie jest używana w przypadku kontrolek źródła danych. (Odziedziczone po DataSourceControl)
ClientIDSeparator	Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control)
ConflictDetection	Pobiera lub ustawia wartość, która określa, czy nowe wartości są przekazywane do `Update` metody, czy zarówno stare, jak i nowe wartości są przekazywane do `Update` metody.
Context	HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control)
Controls	ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po DataSourceControl)
ConvertNullToDBNull	Pobiera lub ustawia wartość wskazującą, czy Parameter wartości przekazywane do operacji aktualizacji, wstawiania lub usuwania są automatycznie konwertowane z `null` na wartość kontrolki Value ObjectDataSource .
DataItemContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control)
DataKeysContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control)
DataObjectTypeName	Pobiera lub ustawia nazwę klasy używanej ObjectDataSource przez kontrolkę dla parametru w operacji aktualizacji, wstawiania lub usuwania danych zamiast przekazywania poszczególnych wartości z kontrolki powiązanej z danymi.
DeleteMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSource przez kontrolkę w celu usunięcia danych.
DeleteParameters	Pobiera kolekcję parametrów zawierającą parametry używane przez metodę DeleteMethod .
DesignMode	Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control)
EnableCaching	Pobiera lub ustawia wartość wskazującą, czy kontrolka ObjectDataSource ma włączoną buforowanie danych.
EnablePaging	Pobiera lub ustawia wartość wskazującą, czy kontrolka źródła danych obsługuje stronicowanie za pośrednictwem zestawu pobieranych danych.
EnableTheming	Pobiera wartość wskazującą, czy ta kontrolka obsługuje motywy. (Odziedziczone po DataSourceControl)
EnableViewState	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta wysyłającego żądanie. (Odziedziczone po Control)
Events	Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control)
FilterExpression	Pobiera lub ustawia wyrażenie filtrowania, które jest stosowane, gdy wywoływana jest metoda określona SelectMethod przez właściwość.
FilterParameters	Pobiera kolekcję parametrów skojarzonych z dowolnymi symbolami zastępczymi parametrów w FilterExpression ciągu.
HasChildViewState	Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają zapisane ustawienia stanu widoku. (Odziedziczone po Control)
ID	Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control)
IdSeparator	Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control)
InsertMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSource przez kontrolkę w celu wstawiania danych.
InsertParameters	Pobiera kolekcję parametrów zawierającą parametry używane przez InsertMethod właściwość.
IsChildControlStateCleared	Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control)
IsTrackingViewState	Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control)
IsViewStateEnabled	Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku. (Odziedziczone po Control)
LoadViewStateByID	Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu. (Odziedziczone po Control)
MaximumRowsParameterName	Pobiera lub ustawia nazwę parametru metody pobierania danych obiektu biznesowego, który służy do wskazania liczby rekordów do pobrania w celu obsługi stronicowania źródła danych.
NamingContainer	Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control)
OldValuesParameterFormatString	Pobiera lub ustawia ciąg formatu, który ma być stosowany do nazw parametrów dla oryginalnych wartości przekazywanych do `Delete` metod lub `Update` .
Page	Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera. (Odziedziczone po Control)
Parent	Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami. (Odziedziczone po Control)
ParsingCulture	Pobiera lub ustawia wartość wskazującą, jakie informacje o kulturze są używane podczas konwertowania wartości ciągów na rzeczywiste typy właściwości w celu skonstruowania obiektu typu wskazanego przez DataObjectTypeName.
RenderingCompatibility	Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control)
SelectCountMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSource przez kontrolkę w celu pobrania liczby wierszy.
SelectMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSource przez kontrolkę w celu pobrania danych.
SelectParameters	Pobiera kolekcję parametrów, które są używane przez metodę SelectMethod określoną przez właściwość.
Site	Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control)
SkinID	Pobiera skórę do zastosowania do kontrolki DataSourceControl . (Odziedziczone po DataSourceControl)
SortParameterName	Pobiera lub ustawia nazwę obiektu biznesowego, który SelectMethod parametr używany do określania wyrażenia sortowania dla obsługi sortowania źródła danych.
SqlCacheDependency	Pobiera lub ustawia rozdzielany średnikami ciąg wskazujący, które bazy danych i tabele mają być używane dla zależności pamięci podręcznej programu Microsoft SQL Server.
StartRowIndexParameterName	Pobiera lub ustawia nazwę parametru metody pobierania danych, który jest używany do wskazania wartości identyfikatora pierwszego rekordu do pobrania na potrzeby obsługi stronicowania źródła danych.
TemplateControl	Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control)
TemplateSourceDirectory	Pobiera katalog wirtualny elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control)
TypeName	Pobiera lub ustawia nazwę klasy, którą ObjectDataSource reprezentuje obiekt.
UniqueID	Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control)
UpdateMethod	Pobiera lub ustawia nazwę metody lub funkcji wywoływanej ObjectDataSource przez kontrolkę w celu zaktualizowania danych.
UpdateParameters	Pobiera kolekcję parametrów zawierającą parametry, które są używane przez metodę UpdateMethod określoną przez właściwość.
ValidateRequestMode	Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control)
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control)
ViewStateIgnoresCase	Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter. (Odziedziczone po Control)
ViewStateMode	Pobiera lub ustawia tryb stanu widoku tej kontrolki. (Odziedziczone po Control)
Visible	Pobiera lub ustawia wartość wskazującą, czy kontrolka jest wyświetlana wizualnie. (Odziedziczone po DataSourceControl)

Metody

AddedControl(Control, Int32)	Wywoływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control)
AddParsedSubObject(Object)	Powiadamia formant serwera, że element ( XML lub HTML) został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control)
ApplyStyleSheetSkin(Page)	Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki. (Odziedziczone po DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Rozpoczyna śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control)
BuildProfileTree(String, Boolean)	Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control)
ClearCachedClientID()	Ustawia wartość buforowanej ClientID na `null`wartość . (Odziedziczone po Control)
ClearChildControlState()	Usuwa informacje o stanie sterowania dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildState()	Usuwa informacje o stanie widoku i stanie sterowania dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildViewState()	Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearEffectiveClientIDMode()	ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inheritwartość . (Odziedziczone po Control)
CreateChildControls()	Wywoływana przez platformę strony ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania. (Odziedziczone po Control)
CreateControlCollection()	Tworzy kolekcję do przechowywania kontrolek podrzędnych. (Odziedziczone po DataSourceControl)
DataBind()	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi. (Odziedziczone po Control)
DataBind(Boolean)	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia. (Odziedziczone po Control)
DataBindChildren()	Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control)
Delete()	Wykonuje operację usuwania, wywołując metodę, która jest identyfikowana przez DeleteMethod właściwość z dowolnymi parametrami w kolekcji DeleteParameters .
Dispose()	Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)	Kończy śledzenie danych renderowania w czasie projektowania. (Odziedziczone po Control)
EnsureChildControls()	Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control)
EnsureID()	Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindControl(String)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego `id` parametru. (Odziedziczone po DataSourceControl)
FindControl(String, Int32)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą `id` całkowitą określoną w parametrze `pathOffset` , która ułatwia wyszukiwanie. Nie należy zastępować tej wersji FindControl metody . (Odziedziczone po Control)
Focus()	Ustawia fokus wejściowy na kontrolkę. (Odziedziczone po DataSourceControl)
GetDesignModeState()	Pobiera dane czasu projektowania dla kontrolki. (Odziedziczone po Control)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetRouteUrl(Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(String, Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)	Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control)
GetView(String)	Pobiera nazwany widok źródła danych skojarzony z kontrolą źródła danych.
GetViewNames()	Pobiera kolekcję nazw reprezentujących listę obiektów widoku skojarzonych z obiektem ObjectDataSource .
HasControls()	Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne. (Odziedziczone po DataSourceControl)
HasEvents()	Zwraca wartość wskazującą, czy zdarzenia są zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych. (Odziedziczone po Control)
Insert()	Wykonuje operację wstawiania, wywołując metodę, która jest identyfikowana przez InsertMethod właściwość i wszystkie parametry w kolekcji InsertParameters .
IsLiteralContent()	Określa, czy kontrolka serwera przechowuje tylko zawartość literału. (Odziedziczone po Control)
LoadControlState(Object)	Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() . (Odziedziczone po Control)
LoadViewState(Object)	Ładuje wcześniej zapisany stan widoku kontrolki ObjectDataSource .
MapPathSecure(String)	Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnBubbleEvent(Object, EventArgs)	Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control)
OnDataBinding(EventArgs)	DataBinding Zgłasza zdarzenie. (Odziedziczone po Control)
OnInit(EventArgs)	LoadComplete Dodaje program obsługi zdarzeń do strony zawierającej kontrolkęObjectDataSource.
OnLoad(EventArgs)	Load Zgłasza zdarzenie. (Odziedziczone po Control)
OnPreRender(EventArgs)	PreRender Zgłasza zdarzenie. (Odziedziczone po Control)
OnUnload(EventArgs)	Unload Zgłasza zdarzenie. (Odziedziczone po Control)
OpenFile(String)	Pobiera element Stream używany do odczytywania pliku. (Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)	Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control)
RaiseDataSourceChangedEvent(EventArgs)	DataSourceChanged Zgłasza zdarzenie. (Odziedziczone po DataSourceControl)
RemovedControl(Control)	Wywoływane po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu. (Odziedziczone po Control)
Render(HtmlTextWriter)	Wysyła zawartość kontroli serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control)
RenderChildren(HtmlTextWriter)	Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control)
RenderControl(HtmlTextWriter)	Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone. (Odziedziczone po DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu. (Odziedziczone po Control)
ResolveAdapter()	Pobiera kartę sterową odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control)
ResolveClientUrl(String)	Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control)
ResolveUrl(String)	Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control)
SaveControlState()	Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control)
SaveViewState()	Zapisuje stan kontrolki ObjectDataSource .
Select()	Pobiera dane z bazowego magazynu danych, wywołując metodę, która jest identyfikowana przez SelectMethod właściwość z parametrami w kolekcji SelectParameters .
SetDesignModeState(IDictionary)	Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)	Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości do kontrolki nadrzędnej. (Odziedziczone po Control)
SetTraceData(Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
SetTraceData(Object, Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania, przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TrackViewState()	Śledzi zmiany stanu widoku w kontrolce ObjectDataSource StateBag , aby można je było przechowywać w obiekcie.
Update()	Wykonuje operację aktualizacji, wywołując metodę, która jest identyfikowana przez UpdateMethod właściwość i wszystkie parametry, które znajdują się w kolekcji UpdateParameters .

Zdarzenia

DataBinding	Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control)
Deleted	Występuje po zakończeniu Delete() operacji.
Deleting	Występuje przed operacją Delete() .
Disposed	Występuje, gdy kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony ASP.NET. (Odziedziczone po Control)
Filtering	Występuje przed operacją filtrowania.
Init	Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control)
Inserted	Występuje po zakończeniu Insert() operacji.
Inserting	Występuje przed operacją Insert() .
Load	Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control)
ObjectCreated	Występuje po utworzeniu TypeName obiektu, który jest identyfikowany przez właściwość.
ObjectCreating	Występuje przed utworzeniem TypeName obiektu, który jest identyfikowany przez właściwość.
ObjectDisposing	Występuje przed odrzuceniem obiektu identyfikowanego przez TypeName właściwość.
PreRender	Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control)
Selected	Występuje po zakończeniu Select() operacji.
Selecting	Występuje przed operacją Select() .
Unload	Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control)
Updated	Występuje po zakończeniu Update() operacji.
Updating	Występuje przed operacją Update() .

Jawne implementacje interfejsu

IControlBuilderAccessor.ControlBuilder	Aby uzyskać opis tego członka, zobacz ControlBuilder. (Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()	Aby uzyskać opis tego członka, zobacz GetDesignModeState(). (Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Aby uzyskać opis tego członka, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Aby uzyskać opis tego członka, zobacz SetOwnerControl(Control). (Odziedziczone po Control)
IControlDesignerAccessor.UserData	Aby uzyskać opis tego członka, zobacz UserData. (Odziedziczone po Control)
IDataBindingsAccessor.DataBindings	Aby uzyskać opis tego członka, zobacz DataBindings. (Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings	Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings. (Odziedziczone po Control)
IDataSource.DataSourceChanged	Występuje, gdy kontrola źródła danych zmieniła się w sposób, który wpływa na kontrolki powiązane z danymi. (Odziedziczone po DataSourceControl)
IDataSource.GetView(String)	Pobiera nazwany DataSourceView obiekt skojarzony z kontrolką DataSourceControl . Niektóre kontrolki źródła danych obsługują tylko jeden widok, a inne obsługują więcej niż jeden widok. (Odziedziczone po DataSourceControl)
IDataSource.GetViewNames()	Pobiera kolekcję nazw, reprezentującą listę obiektów skojarzonych DataSourceView z kontrolką DataSourceControl . (Odziedziczone po DataSourceControl)
IExpressionsAccessor.Expressions	Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions. (Odziedziczone po Control)
IExpressionsAccessor.HasExpressions	Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions. (Odziedziczone po Control)
IListSource.ContainsListCollection	Wskazuje, czy kontrolka źródła danych jest skojarzona z co najmniej jedną listą danych. (Odziedziczone po DataSourceControl)
IListSource.GetList()	Pobiera listę kontrolek źródła danych, które mogą być używane jako źródła list danych. (Odziedziczone po DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)	Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object). (Odziedziczone po Control)

Metody rozszerzania

FindDataSourceControl(Control)	Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.
FindFieldTemplate(Control, String)	Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki.
FindMetaTable(Control)	Zwraca obiekt metatable dla kontrolki zawierającej dane.
GetDefaultValues(IDataSource)	Pobiera kolekcję wartości domyślnych dla określonego źródła danych.
GetMetaTable(IDataSource)	Pobiera metadane dla tabeli w określonym obiekcie źródła danych.
TryGetMetaTable(IDataSource, MetaTable)	Określa, czy metadane tabeli są dostępne.

Dotyczy

Udostępnij za pośrednictwem