ObjectDataSource Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje obchodní objekt, který poskytuje data ovládacím prvkům vázaným na data v architekturách vícevrstvé webové aplikace.

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

Dědičnost: Object

Control

DataSourceControl
ObjectDataSource

Atributy: ToolboxBitmapAttribute

Příklady

Tato část zobrazuje ObjectDataSource kód v kódu na stránce .aspx a zobrazuje obchodní objekty, se kterými pracuje. Příkladem je stránka .aspx. Obsahuje ovládací prvek GridView , který je vázán na ovládací prvek ObjectDataSource . Značka ObjectDataSource ovládacího prvku určuje název obchodního objektu a název metody obchodního objektu, která se má volat za účelem načtení dat.

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

Následující příklad ukazuje obchodní objekt, který ObjectDataSource ovládací prvek na stránce .aspx používá. (Tento obchodní objekt používá také mnoho dalších ObjectDataSource příkladů kódu.) Příklad se skládá z následujících dvou základních tříd:

Třída EmployeeLogic je třída obchodní logiky ObjectDataSource , kterou používá.
Třída NorthwindEmployee definuje datový objekt, který je vrácen GetAllEmployees metodou EmployeeLogic třídy.

Pro usnadnění je k dispozici další NorthwindDataException třída.

Tato sada ukázkových tříd funguje s databází Northwind Traders, která je k dispozici s Microsoft SQL Serverem a Microsoft Accessem. Pro kompletní funkční příklad je nutné zkompilovat a použít tyto třídy s .aspx příklad stránky, který je k dispozici.

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

Poznámky

V tomto tématu:

Úvod
Účel
Načítání dat
Provádění operací s daty
Filtrování dat
Ukládání do mezipaměti
Funkce
Zobrazení dat
Použití LINQ to SQL
Deklarativní syntaxe

Úvod

Ovládací ObjectDataSource prvek funguje s třídou, kterou vytvoříte. Vytvoříte metody, které načítají a aktualizují data, a názvy těchto metod zadáte ovládacímu ObjectDataSource prvku v kódu. Během vykreslování nebo zpětného ObjectDataSource zpracování volá metoda metody, které jste zadali.

Neexistuje žádné vizuální vykreslení ObjectDataSource ovládacího prvku. V důsledku toho nepodporuje vizuální funkce, ObjectDataSource jako EnableTheming je například vlastnost nebo SkinID .

Účel

Velmi běžným postupem návrhu aplikace je oddělení prezentační vrstvy od obchodní logiky a zapouzdření obchodní logiky v obchodních objektech. Tyto obchodní objekty tvoří odlišnou vrstvu mezi prezentační vrstvou a datovou vrstvou, což vede k architektuře třívrstvé aplikace. Tento ObjectDataSource ovládací prvek umožňuje vývojářům používat ASP.NET ovládací prvek zdroje dat při zachování architektury třívrstvé aplikace.

Ovládací ObjectDataSource prvek používá reflexi k vytvoření instancí obchodních objektů a k volání metod na nich k načtení, aktualizaci, vložení a odstranění dat. Vlastnost TypeName identifikuje název třídy, se kterou ObjectDataSource pracuje. Ovládací ObjectDataSource prvek vytvoří a zničí instanci třídy pro každé volání metody; neudržuje objekt v paměti po dobu životnosti webového požadavku. To je důležité zvážit, pokud obchodní objekt, který používáte, vyžaduje mnoho prostředků nebo je jeho vytvoření a zničení jinak nákladné. Použití nákladného objektu nemusí být optimální volbou pro návrh, ale životní cyklus objektu můžete řídit pomocí ObjectCreatingudálostí , ObjectCreateda ObjectDisposing .

Poznámka

Metody, které jsou identifikovány vlastnostmi SelectMethod, UpdateMethod, InsertMethoda DeleteMethod mohou být metody instance nebo static (Shared v jazyce Visual Basic) metody. Pokud jsou static metody (Shared v jazyce Visual Basic), instance obchodního objektu není vytvořena a ObjectCreatingnejsou vyvolány události , ObjectCreateda ObjectDisposing .

Načítání dat

Pokud chcete načíst data z obchodního objektu SelectMethod , nastavte vlastnost na název metody, která načítá data. Pokud metoda nevrací IEnumerable objekt nebo DataSet objekt, je objekt zabalen modulem runtime v kolekci IEnumerable . Pokud podpis metody obsahuje parametry, můžete do SelectParameters kolekce přidat Parameter objekty a pak je svázat s hodnotami, které chcete předat metodě určené SelectMethod vlastností . Aby ovládací ObjectDataSource prvek mohl používat parametry, musí parametry odpovídat názvům a typům parametrů v podpisu metody. Další informace najdete v tématu Použití parametrů s ovládacím prvku ObjectDataSource.

Ovládací ObjectDataSource prvek načítá data při každém zavolání Select metody. Tato metoda poskytuje programový přístup k metodě, která je určena SelectMethod vlastností. Metoda, která je určena SelectMethod vlastností je volána automaticky ovládacími prvky, které jsou vázány na ObjectDataSource při jejich DataBind zavolání metody. Pokud nastavíte DataSourceID vlastnost ovládacího prvku vázaného na data, ovládací prvek se podle potřeby automaticky sváže s daty ze zdroje dat. DataSourceID Nastavení vlastnosti je doporučenou metodou pro vytvoření vazby ObjectDataSource ovládacího prvku na ovládací prvek vázaný na data. Alternativně můžete nastavit DataSource vlastnost , ale pak musíte explicitně volat metodu DataBind ovládacího prvku vázaného na data. Pokud chcete načíst data, můžete metodu Select kdykoli programově volat.

Další informace o vazbě ovládacích prvků vázaných na data s ovládacími prvky zdroje dat najdete v tématu Vazba na data pomocí ovládacího prvku zdroje dat.

Provádění operací s daty

V závislosti na možnostech obchodního objektu, se kterým ObjectDataSource ovládací prvek pracuje, můžete provádět operace s daty, jako jsou aktualizace, vložení a odstranění. Pokud chcete tyto operace s daty provést, nastavte název příslušné metody a všechny přidružené parametry pro operaci, kterou chcete provést. Například pro operaci aktualizace nastavte UpdateMethod vlastnost na název metody obchodního objektu, která provádí aktualizace, a přidejte do UpdateParameters kolekce všechny požadované parametry. ObjectDataSource Pokud je ovládací prvek přidružený k ovládacímu prvku vázanému na data, přidá parametry ovládací prvek vázaný na data. V takovém případě je potřeba zajistit, aby názvy parametrů metody odpovídaly názvům polí v ovládacím prvku vázaném na data. Aktualizace se provádí při zavolání Update metody, a to buď explicitně vaším kódem, nebo automaticky ovládacím prvku vázaného na data. Stejný obecný vzor se používá pro Delete operace a Insert . Předpokládá se, že obchodní objekty provádějí tyto typy datových operací po jednom záznamu, nikoli v dávkách.

Filtrování dat

Ovládací ObjectDataSource prvek může filtrovat data, která jsou načtena SelectMethod vlastností, pokud jsou data vrácena jako DataSet objekt nebo DataTable . Vlastnost na filtrovací výraz můžete nastavit FilterExpression pomocí syntaxe formátovacího řetězce a vytvořit vazbu hodnot ve výrazu na parametry zadané v kolekci FilterParameters .

Ukládání do mezipaměti

ObjectDataSource Přestože objekt nezachovává instanci obchodního objektu ve více požadavcích, může uložit výsledek volání metody identifikované vlastností do SelectMethod mezipaměti. Když jsou data uložená v mezipaměti, následná volání Select metody vrátí data uložená v mezipaměti namísto vytvoření obchodního objektu a volání jeho SelectMethod reflexe. Ukládání do mezipaměti umožňuje vyhnout se vytváření objektu a volání jeho datové metody na úkor paměti na webovém serveru. Objekt ObjectDataSource automaticky ukládá data do mezipaměti, když EnableCaching je vlastnost nastavena na truehodnotu a CacheDuration vlastnost je nastavena na počet sekund, po které mezipaměť ukládá data, než je mezipaměť zahozena. Můžete také zadat CacheExpirationPolicy vlastnost a volitelnou SqlCacheDependency vlastnost. Ovládací ObjectDataSource prvek umožňuje ukládat do mezipaměti všechny typy dat, ale neměli byste ukládat do mezipaměti objekty, které uchovávají prostředky nebo stav, které nelze sdílet s více požadavky (například otevřený SqlDataReader objekt), protože stejná instance objektu se použije ke zpracování více požadavků.

Funkce

Následující tabulka popisuje funkce ObjectDataSource ovládacího prvku.

Schopnost	Požadavky
Výběr	SelectMethod Nastavte vlastnost na název metody obchodního objektu, která vybírá data, a zahrňte všechny nezbytné parametry v SelectParameters kolekci buď programově, nebo pomocí ovládacího prvku vázaného na data.
Řazení	SortParameterName Nastavte vlastnost na název parametru v SelectMethod metodě, která nese kritéria řazení.
Filtrování	FilterExpression Nastavte vlastnost na filtrovací výraz a volitelně do FilterParameters kolekce přidejte jakékoli parametry pro filtrování dat při Select zavolání metody. Metoda určená SelectMethod vlastností musí vrátit DataSet nebo DataTable.
Stránkování	Stránkování zdroje dat je podporováno, pokud SelectMethod metoda obsahuje parametry pro maximální počet záznamů, které se mají načíst, a index prvního záznamu, který se má načíst. Názvy těchto parametrů musí být nastaveny ve vlastnostech MaximumRowsParameterName a StartRowIndexParameterName . Ovládací prvek vázaný na data může být schopen provádět stránkování sám, i když ObjectDataSource ovládací prvek nepodporuje stránkování přímo v metodě určené SelectMethod vlastností . Požadavek na to, aby ovládací prvek vázaný na data mohl to provést, je, že metoda určená SelectMethod vlastností vrátí objekt, který implementuje ICollection rozhraní.
Aktualizace	UpdateMethod Nastavte vlastnost na název metody obchodního objektu, která aktualizuje data, a zahrňte do kolekce všechny nezbytné parametryUpdateParameters.
odstraňování	DeleteMethod Nastavte vlastnost na název metody nebo funkce obchodního objektu, která odstraňuje data, a zahrňte do kolekce všechny nezbytné parametryDeleteParameters.
Vložení	InsertMethod Nastavte vlastnost na název metody nebo funkce obchodního objektu, která vkládá data, a zahrňte do InsertParameters kolekce všechny nezbytné parametry.
Ukládání do mezipaměti	EnableCaching Nastavte vlastnost na `true`a CacheDuration vlastnosti a CacheExpirationPolicy vlastnosti podle chování při ukládání do mezipaměti, které chcete použít pro data uložená v mezipaměti.

Poznámka

Pokud použijete ObjectDataSource třídu k aktualizaci nebo vložení dat, řetězce zadané v klientovi nejsou automaticky převedeny z formátu jazykové verze klienta na formát jazykové verze serveru. Jazyková verze klienta může například jako formát data určovat DD/MM/RRRR a formát data na serveru může být MM/DD/RRRR. V takovém případě by datum 5. října 2009 bylo zapsáno do TextBox kontroly jako 5/10/2009, ale bylo by vykládáno jako 10. Datum 15. října 2009 by bylo zadáno jako 15/10/2009 a bylo by odmítnuto jako neplatné datum.

Zobrazení dat

Stejně jako u všech ovládacích prvků ObjectDataSource zdroje dat je ovládací prvek přidružený k třídě zobrazení zdroje dat. ObjectDataSource Zatímco ovládací prvek je rozhraní, které vývojář stránky používá k práci s daty, ObjectDataSourceView třída je rozhraní, se kterým pracují ovládací prvky vázané na data. Třída dále ObjectDataSourceView popisuje možnosti ovládacího prvku zdroje dat a provádí skutečnou práci. Ovládací ObjectDataSource prvek má pouze jeden přidružený ObjectDataSourceViewa má vždy název DefaultView. ObjectDataSourceView Zatímco objekt je zpřístupněn metodou GetView , mnoho jeho vlastností a metod jsou zabaleny a zpřístupněny přímo ovládacím ObjectDataSource prvku. Objekt na pozadí ObjectDataSourceView provádí všechny operace s daty, včetně načítání, vkládání, aktualizace, odstraňování, filtrování a řazení dat. Další informace naleznete v tématu ObjectDataSourceView.

Použití LINQ to SQL

Ovládací prvek můžete použít ObjectDataSource s třídou LINQ to SQL. Uděláte to tak, že vlastnost nastavíte TypeName na název třídy kontextu dat. Také nastavíte SelectMethodmetody , UpdateMethod, InsertMethoda DeleteMethod na metody ve třídě kontextu dat, které provádějí odpovídající operace. Pro událost musíte vytvořit obslužnou rutinu ObjectDisposing události, aby bylo možné zrušit odstraňování třídy kontextu dat. Tento krok je nezbytný, protože LINQ to SQL podporuje odložené spuštění, zatímco ObjectDataSource ovládací prvek se pokusí odstranit kontext dat po operaci Select. Další informace o tom, jak vytvořit LINQ to SQL třídy naleznete v tématu Postupy: Vytvoření LINQ to SQL tříd ve webovém projektu. Příklad zrušení odstranění třídy kontextu dat najdete v ObjectDisposing události .

Použití Entity Frameworku

Ovládací prvek můžete použít ObjectDataSource také s rozhraním Entity Framework. Další informace najdete v tématu Použití Entity Framework a ovládacího prvku ObjectDataSource.

Deklarativní syntaxe

<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()	Inicializuje novou instanci ObjectDataSource třídy.
ObjectDataSource(String, String)	Inicializuje novou instanci ObjectDataSource třídy se zadaným názvem typu a názvem metody načítání dat.

Vlastnosti

Adapter	Získá adaptér specifické pro prohlížeč pro ovládací prvek. (Zděděno od Control)
AppRelativeTemplateSourceDirectory	Získá nebo nastaví aplikaci relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek. (Zděděno od Control)
BindingContainer	Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control)
CacheDuration	Získá nebo nastaví dobu v sekundách, že ovládací prvek zdroje dat ukládá data do mezipaměti, která je načtena SelectMethod vlastností.
CacheExpirationPolicy	Získá nebo nastaví chování vypršení platnosti mezipaměti, které v kombinaci s dobou trvání popisuje chování mezipaměti, kterou používá řízení zdroje dat.
CacheKeyDependency	Získá nebo nastaví závislost klíče definované uživatelem, která je propojena se všemi objekty mezipaměti dat, které jsou vytvořeny ovládací prvek zdroje dat.
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky serverového ovládacího prvku. (Zděděno od Control)
ClientID	Získá identifikátor ovládacího prvku serveru vygenerovaný ASP.NET. (Zděděno od DataSourceControl)
ClientIDMode	Tato vlastnost se nepoužívá pro ovládací prvky zdroje dat. (Zděděno od DataSourceControl)
ClientIDSeparator	Získá hodnotu znaku představující znak oddělovače použitý ve ClientID vlastnosti . (Zděděno od Control)
ConflictDetection	Získá nebo nastaví hodnotu, která určuje, zda pouze nové hodnoty jsou předány `Update` do metody nebo jak staré a nové hodnoty jsou předány `Update` do metody.
Context	HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control)
Controls	ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od DataSourceControl)
ConvertNullToDBNull	Získá nebo nastaví hodnotu označující, zda Parameter hodnoty, které jsou předány do operace aktualizace, vložení nebo odstranění jsou automaticky převedeny z `null`Value na hodnotu ovládací prvek ObjectDataSource .
DataItemContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer. (Zděděno od Control)
DataKeysContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl. (Zděděno od Control)
DataObjectTypeName	Získá nebo nastaví název třídy, který ObjectDataSource ovládací prvek používá pro parametr v operaci aktualizace, vložení nebo odstranění dat, místo předání jednotlivých hodnot z ovládacího prvku vázaného na data.
DeleteMethod	Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSource ovládací prvek vyvolá k odstranění dat.
DeleteParameters	Získá kolekci parametrů, která obsahuje parametry, které jsou používány metodou DeleteMethod .
DesignMode	Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control)
EnableCaching	Získá nebo nastaví hodnotu označující, zda ObjectDataSource má ovládací prvek povolenou ukládání dat do mezipaměti.
EnablePaging	Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek zdroje dat podporuje stránkování prostřednictvím sady dat, které načítá.
EnableTheming	Získá hodnotu označující, zda tento ovládací prvek podporuje motivy. (Zděděno od DataSourceControl)
EnableViewState	Získá nebo nastaví hodnotu označující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control)
Events	Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control)
FilterExpression	Získá nebo nastaví filtrovací výraz, který je použit při metody, která je určena SelectMethod vlastnost je volána.
FilterParameters	Získá kolekci parametrů, které jsou přidruženy k libovolným zástupným symbolům parametrů v řetězci FilterExpression .
HasChildViewState	Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají nějaké uložené nastavení stavu zobrazení. (Zděděno od Control)
ID	Získá nebo nastaví programový identifikátor přiřazený k ovládacímu prvku serveru. (Zděděno od Control)
IdSeparator	Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control)
InsertMethod	Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSource ovládací prvek vyvolá pro vložení dat.
InsertParameters	Získá kolekci parametrů, která obsahuje parametry, které jsou používány InsertMethod vlastnost.
IsChildControlStateCleared	Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení. (Zděděno od Control)
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control)
IsViewStateEnabled	Získá hodnotu označující, zda je stav zobrazení povolen pro tento ovládací prvek. (Zděděno od Control)
LoadViewStateByID	Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu zobrazení namísto ID indexu. (Zděděno od Control)
MaximumRowsParameterName	Získá nebo nastaví název parametru metody načítání dat obchodního objektu, který se používá k označení počtu záznamů k načtení pro podporu stránkování zdroje dat.
NamingContainer	Získá odkaz na názvový kontejner serverového ovládacího prvku, který vytvoří jedinečný obor názvů pro odlizení mezi ovládacími prvky serveru se stejnou ID hodnotou vlastnosti. (Zděděno od Control)
OldValuesParameterFormatString	Získá nebo nastaví formátovací řetězec použít na názvy parametrů pro původní hodnoty, které jsou předány `Delete` metody nebo `Update` .
Page	Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control)
Parent	Získá odkaz na nadřazený ovládací prvek serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control)
ParsingCulture	Získá nebo nastaví hodnotu, která označuje, jaké informace o jazykové verzi se používají při převodu řetězcových hodnot na skutečné typy vlastností za účelem vytvoření objektu typu označeného .DataObjectTypeName
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verze, která vykreslovala HTML bude kompatibilní s. (Zděděno od Control)
SelectCountMethod	Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSource ovládací prvek vyvolá k načtení počtu řádků.
SelectMethod	Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSource ovládací prvek vyvolá k načtení dat.
SelectParameters	Získá kolekci parametrů, které jsou používány metodou určenou SelectMethod vlastností.
Site	Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control)
SkinID	Získá kůži, která se má aplikovat na DataSourceControl ovládací prvek. (Zděděno od DataSourceControl)
SortParameterName	Získá nebo nastaví název obchodního objektu SelectMethod , který parametr používá k určení výrazu řazení pro podporu řazení zdroje dat.
SqlCacheDependency	Získá nebo nastaví řetězec oddělený středníkem, který označuje, které databáze a tabulky použít pro závislost mezipaměti Microsoft SQL Serveru.
StartRowIndexParameterName	Získá nebo nastaví název parametru metody načítání dat, který se používá k označení hodnoty identifikátoru prvního záznamu k načtení pro podporu stránkování zdroje dat.
TemplateControl	Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control)
TemplateSourceDirectory	Získá virtuální adresář Page nebo UserControl , který obsahuje aktuální server ovládací prvek. (Zděděno od Control)
TypeName	Získá nebo nastaví název třídy, kterou ObjectDataSource objekt představuje.
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku. (Zděděno od Control)
UpdateMethod	Získá nebo nastaví název metody nebo funkce, kterou ObjectDataSource ovládací prvek vyvolá k aktualizaci dat.
UpdateParameters	Získá kolekci parametrů, která obsahuje parametry, které jsou používány metodou, která je určena UpdateMethod vlastnost.
ValidateRequestMode	Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení serverového ovládacího prvku napříč několika požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje velká a malá písmena. (Zděděno od Control)
ViewStateMode	Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku. (Zděděno od Control)
Visible	Získá nebo nastaví hodnotu označující, zda je ovládací prvek vizuálně zobrazen. (Zděděno od DataSourceControl)

Metody

AddedControl(Control, Int32)	Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control)
AddParsedSubObject(Object)	Upozorní ovládací prvek serveru, že byl analyzován element XML nebo HTML, a přidá element do objektu serverového ControlCollection ovládacího prvku. (Zděděno od Control)
ApplyStyleSheetSkin(Page)	Použije vlastnosti stylu, které jsou definovány v šabloně stylů stránky na ovládací prvek. (Zděděno od DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Začíná trasování vykreslovaných dat v době návrhu. (Zděděno od Control)
BuildProfileTree(String, Boolean)	Shromáždí informace o serverovém ovládacím prvku a předá je vlastnosti Trace , která se má zobrazit, když je pro stránku povoleno trasování. (Zděděno od Control)
ClearCachedClientID()	Nastaví hodnotu v ClientID mezipaměti na `null`. (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu ovládacího prvku pro podřízené ovládací prvky serveru. (Zděděno od Control)
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control)
ClearChildViewState()	Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost instance aktuálního ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control)
CreateChildControls()	Volána rozhraním ASP.NET stránky k upozornění serverových ovládacích prvků, které používají implementaci založenou na složení k vytvoření všech podřízených ovládacích prvků, které obsahují při přípravě na zaúčtování zpět nebo vykreslení. (Zděděno od Control)
CreateControlCollection()	Vytvoří kolekci pro ukládání podřízených ovládacích prvků. (Zděděno od DataSourceControl)
DataBind()	Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky. (Zděděno od Control)
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control)
DataBindChildren()	Vytvoří vazbu zdroje dat na podřízené ovládací prvky serveru. (Zděděno od Control)
Delete()	Provede operaci odstranění voláním metody, která je identifikována DeleteMethod vlastností s libovolnými parametry, které jsou v kolekci DeleteParameters .
Dispose()	Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control)
EndRenderTracing(TextWriter, Object)	Ukončí trasování doby návrhu vykreslovaných dat. (Zděděno od Control)
EnsureChildControls()	Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control)
EnsureID()	Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindControl(String)	Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek pomocí zadaného `id` parametru. (Zděděno od DataSourceControl)
FindControl(String, Int32)	Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným `id` a celočíselným číslem zadaným v parametru `pathOffset` , což pomáhá při hledání. Tuto verzi metody byste neměli FindControl přepsat. (Zděděno od Control)
Focus()	Nastaví fokus vstupu na ovládací prvek. (Zděděno od DataSourceControl)
GetDesignModeState()	Získá data v době návrhu pro ovládací prvek. (Zděděno od Control)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetRouteUrl(Object)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(String, Object)	Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí část UniqueID vlastnosti zadaného ovládacího prvku s předponou. (Zděděno od Control)
GetView(String)	Načte pojmenované zobrazení zdroje dat, které je přidruženo k ovládacímu prvku zdroje dat.
GetViewNames()	Načte kolekci názvů představující seznam objektů zobrazení, které jsou přidruženy k objektu ObjectDataSource .
HasControls()	Určuje, jestli serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od DataSourceControl)
HasEvents()	Vrátí hodnotu označující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control)
Insert()	Provede operaci vložení voláním metody, která je identifikována InsertMethod vlastností a všemi parametry v kolekci InsertParameters .
IsLiteralContent()	Určuje, zda serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control)
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() . (Zděděno od Control)
LoadViewState(Object)	Načte dříve uložený stav ObjectDataSource zobrazení ovládacího prvku.
MapPathSecure(String)	Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní. (Zděděno od Control)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost serverového ovládacího prvku předána hierarchii serveru uživatelského rozhraní stránky. (Zděděno od Control)
OnDataBinding(EventArgs)	DataBinding Vyvolá událost. (Zděděno od Control)
OnInit(EventArgs)	Přidá obslužnou rutinu LoadComplete události na stránku, která obsahuje ObjectDataSource ovládací prvek.
OnLoad(EventArgs)	Load Vyvolá událost. (Zděděno od Control)
OnPreRender(EventArgs)	PreRender Vyvolá událost. (Zděděno od Control)
OnUnload(EventArgs)	Unload Vyvolá událost. (Zděděno od Control)
OpenFile(String)	Stream Získá používá ke čtení souboru. (Zděděno od Control)
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku. (Zděděno od Control)
RaiseDataSourceChangedEvent(EventArgs)	DataSourceChanged Vyvolá událost. (Zděděno od DataSourceControl)
RemovedControl(Control)	Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control)
Render(HtmlTextWriter)	Odesílá obsah řízení serveru do zadaného HtmlTextWriter objektu, který zapisuje obsah, který se má vykreslit na klientovi. (Zděděno od Control)
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit na klientovi. (Zděděno od Control)
RenderControl(HtmlTextWriter)	Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené. (Zděděno od DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control)
ResolveAdapter()	Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control)
ResolveClientUrl(String)	Získá adresu URL, kterou lze použít v prohlížeči. (Zděděno od Control)
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control)
SaveControlState()	Uloží všechny změny stavu ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control)
SaveViewState()	Uloží stav ObjectDataSource ovládacího prvku.
Select()	Načte data z podkladového úložiště dat voláním metody, která je identifikována SelectMethod vlastností s parametry v kolekci SelectParameters .
SetDesignModeState(IDictionary)	Nastaví data v době návrhu ovládacího prvku. (Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události pro vykreslení serverového ovládacího prvku a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control)
SetTraceData(Object, Object)	Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí datového klíče trasování a hodnoty dat trasování. (Zděděno od Control)
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí trasovaného objektu, datového klíče trasování a hodnoty dat trasování. (Zděděno od Control)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Sleduje změny ObjectDataSource stavu zobrazení ovládacího prvku, aby je bylo možné uložit do objektu StateBag .
Update()	Provede operaci aktualizace voláním metody, která je identifikována UpdateMethod vlastností a všemi parametry, které jsou v kolekci UpdateParameters .

Událost

DataBinding	Vyvolá se při vytvoření vazby serverového ovládacího prvku na zdroj dat. (Zděděno od Control)
Deleted	Nastane po Delete() dokončení operace.
Deleting	Nastane před Delete() operací.
Disposed	Vyvolá se při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována ASP.NET stránka. (Zděděno od Control)
Filtering	Nastane před operací filtrování.
Init	Vyvolá se při inicializaci serverového ovládacího prvku, což je první krok v jeho životním cyklu. (Zděděno od Control)
Inserted	Nastane po Insert() dokončení operace.
Inserting	Nastane před Insert() operací.
Load	Vyvolá se při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control)
ObjectCreated	Nastane po vytvoření objektu, který je identifikovaný TypeName vlastností.
ObjectCreating	Nastane před objektem, který je identifikovaný TypeName vlastností je vytvořen.
ObjectDisposing	Nastane před objektem, který je identifikovaný TypeName vlastností je zahozen.
PreRender	Vyvolá se po načtení objektu Control , ale před vykreslením. (Zděděno od Control)
Selected	Nastane po Select() dokončení operace.
Selecting	Nastane před Select() operací.
Unload	Nastane při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control)
Updated	Nastane po Update() dokončení operace.
Updating	Nastane před Update() operací.

Explicitní implementace rozhraní

IControlBuilderAccessor.ControlBuilder	Popis tohoto člena najdete v tématu ControlBuilder. (Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()	Popis tohoto člena najdete v tématu GetDesignModeState(). (Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Popis tohoto člena najdete v tématu SetDesignModeState(IDictionary). (Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Popis tohoto člena najdete v tématu SetOwnerControl(Control). (Zděděno od Control)
IControlDesignerAccessor.UserData	Popis tohoto člena najdete v tématu UserData. (Zděděno od Control)
IDataBindingsAccessor.DataBindings	Popis tohoto člena najdete v tématu DataBindings. (Zděděno od Control)
IDataBindingsAccessor.HasDataBindings	Popis tohoto člena najdete v tématu HasDataBindings. (Zděděno od Control)
IDataSource.DataSourceChanged	Nastane, když se ovládací prvek zdroje dat změnil způsobem, který ovlivňuje ovládací prvky vázané na data. (Zděděno od DataSourceControl)
IDataSource.GetView(String)	Získá pojmenovaný DataSourceView objekt přidružený k ovládacímu DataSourceControl prvku. Některé ovládací prvky zdroje dat podporují jenom jedno zobrazení, zatímco jiné podporují více než jedno. (Zděděno od DataSourceControl)
IDataSource.GetViewNames()	Získá kolekci názvů představující seznam objektů přidružených DataSourceView k ovládacímu DataSourceControl prvku. (Zděděno od DataSourceControl)
IExpressionsAccessor.Expressions	Popis tohoto člena najdete v tématu Expressions. (Zděděno od Control)
IExpressionsAccessor.HasExpressions	Popis tohoto člena najdete v tématu HasExpressions. (Zděděno od Control)
IListSource.ContainsListCollection	Určuje, jestli je ovládací prvek zdroje dat přidružený k jednomu nebo více seznamům dat. (Zděděno od DataSourceControl)
IListSource.GetList()	Získá seznam ovládacích prvků zdroje dat, které lze použít jako zdroje seznamů dat. (Zděděno od DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)	Popis tohoto člena najdete v tématu AddParsedSubObject(Object). (Zděděno od Control)

Metody rozšíření

FindDataSourceControl(Control)	Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek.
FindFieldTemplate(Control, String)	Vrátí šablonu pole pro zadaný sloupec v kontejneru názvů zadaného ovládacího prvku.
FindMetaTable(Control)	Vrátí objekt metatable pro ovládací prvek obsahující data.
GetDefaultValues(IDataSource)	Získá kolekci výchozích hodnot pro zadaný zdroj dat.
GetMetaTable(IDataSource)	Získá metadata pro tabulku v zadaném objektu zdroje dat.
TryGetMetaTable(IDataSource, MetaTable)	Určuje, zda jsou k dispozici metadata tabulky.

Platí pro

Sdílet prostřednictvím