ObjectDataSource Třída
Definice
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 DataSourceControlPublic Class ObjectDataSource
Inherits DataSourceControl- Dědičnost
- Atributy
Příklady
Tato část zobrazuje ObjectDataSource v kódu na stránce .aspx a zobrazuje obchodní objekty, se kterými pracuje. Příkladem je .aspx stránka. Obsahuje GridView ovládací prvek, který je vázán na ObjectDataSource ovládací prvek. Kód ObjectDataSource ovládacího prvku určuje název obchodního objektu a název metody obchodního objektu, který se má volat, aby bylo možné načíst data.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1" />
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
typename="Samples.AspNet.CS.EmployeeLogic" />
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - Visual Basic Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1" />
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployees"
typename="Samples.AspNet.VB.EmployeeLogic" />
</form>
</body>
</html>
Následující příklad ukazuje obchodní objekt, který ObjectDataSource ovládací prvek na stránce .aspx používá. (Mnoho dalších ObjectDataSource příkladů kódu používá tento obchodní objekt také.) Příklad se skládá z následujících dvou základních tříd:
Třída
EmployeeLogicje třída obchodní logiky ObjectDataSource , kterou používá.Třída
NorthwindEmployeedefinuje datový objekt, který je vrácenGetAllEmployeesmetodouEmployeeLogictřídy.
Další NorthwindDataException třída je poskytována jako pohodlí.
Tato sada ukázkových tříd funguje s databází Northwind Traders, která je k dispozici pro Microsoft SQL Server a Microsoft Access. V případě kompletního funkčního příkladu je nutné tyto třídy zkompilovat a použít s příkladem stránky .aspx, 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:
Introduction
Ovládací ObjectDataSource prvek pracuje s třídou, kterou vytvoříte. Vytváříte metody, které načítají a aktualizují data, a zadáte názvy těchto metod ovládacímu ObjectDataSource prvku v kódu. Během vykreslování nebo následného zpracování ObjectDataSource volá metody, které jste zadali.
Neexistuje žádné vizuální vykreslení ObjectDataSource ovládacího prvku. V důsledku toho nepodporuje vizuální funkce, ObjectDataSource jako je například EnableTheming vlastnost nebo SkinID vlastnost.
Purpose
Velmi běžným postupem návrhu aplikací 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 a výsledkem je třívrstvé aplikační architektura. Tento ObjectDataSource ovládací prvek umožňuje vývojářům používat ASP.NET správu zdrojů dat při zachování třívrstvé aplikační architektury.
Ovládací ObjectDataSource prvek používá reflexi k vytvoření instancí obchodních objektů a volání metod pro 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 závažná úvaha, pokud obchodní objekt, který používáte, vyžaduje mnoho prostředků nebo je jinak nákladné vytvořit a zničit. Použití nákladného objektu nemusí být optimální volbou návrhu, ale můžete řídit životní cyklus objektu ObjectCreatingObjectCreatedpomocí , a ObjectDisposing událostí.
Poznámka:
Metody, které jsou identifikovány SelectMethod, UpdateMethod, InsertMethoda DeleteMethod vlastnosti 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 ObjectCreating, ObjectCreateda události nejsou ObjectDisposing vyvolány.
Načítání dat
Chcete-li načíst data z obchodního objektu, nastavte SelectMethod vlastnost na název metody, která načítá data. Pokud metoda nevrací objekt IEnumerable nebo DataSet objekt, objekt je zabalen modulem runtime v IEnumerable kolekci. Pokud podpis metody obsahuje parametry, můžete přidat Parameter objekty do SelectParameters kolekce a pak je svázat s hodnotami, které chcete předat metodě, která je určena SelectMethod vlastností. Aby ObjectDataSource ovládací prvek mohl používat parametry, musí parametry odpovídat názvům a typům parametrů v podpisu metody. Další informace naleznete v tématu Použití parametrů s ObjectDataSource Ovládací prvek.
Ovládací ObjectDataSource prvek načte data při každém Select zavolání metody. Tato metoda poskytuje programový přístup k metodě, která je určena SelectMethod vlastností. Metoda určená SelectMethod vlastností je volána automaticky ovládacími prvky, které jsou svázané s ObjectDataSource jejich DataBind metodou je volána. 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čená metoda pro vytvoření vazby ObjectDataSource ovládacího prvku na ovládací prvek svázaný s daty. Alternativně můžete nastavit DataSource vlastnost, ale pak musíte explicitně volat DataBind metodu ovládacího prvku vázaného na data. Metodu Select můžete volat programově a načíst data.
Další informace o vazbě ovládacích prvků svázaných dat s ovládacími prvky zdroje dat najdete v tématu Vazba k datům pomocí ovládacího prvku zdroje dat.
Provádění operací s daty
V závislosti na možnostech obchodního objektu, se kterými ObjectDataSource ovládací prvek pracuje, můžete provádět datové operace, jako jsou aktualizace, vložení a odstranění. Chcete-li provést tyto datové operace, nastavte odpovídající název metody a všechny přidružené parametry pro operaci, kterou chcete provést. Například u operace aktualizace nastavte UpdateMethod vlastnost na název metody obchodního objektu, která provádí aktualizace, a přidejte do kolekce všechny požadované parametry UpdateParameters . ObjectDataSource Pokud je ovládací prvek přidružený k ovládacímu prvku vázanému na data, parametry se přidají ovládacím prvku vázaném 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 Update zavolání metody, a to buď explicitně vaším kódem, nebo automaticky ovládacím prvku vázaném na data. Stejný obecný vzor se používá pro Delete operace a Insert operace. U obchodních objektů se předpokládá, že tyto typy datových operací provádějí jeden záznam po jednom záznamu, nikoli dávkově.
Filtrování dat
Ovládací ObjectDataSource prvek může filtrovat data načtená vlastností SelectMethod , pokud jsou data vrácena jako DataSet nebo DataTable objekt. Vlastnost můžete nastavit FilterExpression na filtrovací výraz pomocí syntaxe řetězce formátu a vytvořit vazbu hodnot ve výrazu na parametry zadané v kolekci FilterParameters .
Cacheování
ObjectDataSource I když nezachovává instanci obchodního objektu napříč více požadavky, může ukládat do mezipaměti výsledek volání metody identifikované vlastnostíSelectMethod. Zatímco jsou data uložená do mezipaměti, následná volání Select metody vrátí data uložená v mezipaměti místo vytvoření obchodního objektu a volání pomocí SelectMethod reflexe. Ukládání do mezipaměti vám umožní vyhnout se vytváření objektu a volání jeho datové metody na úkor paměti na webovém serveru. Automaticky ObjectDataSource 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 před zahozením mezipaměti. 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 objekty do mezipaměti, 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 službě více požadavků.
Features
Následující tabulka popisuje funkce ObjectDataSource ovládacího prvku.
| Schopnost | Požadavky |
|---|---|
| Vybírání | SelectMethod Nastavte vlastnost na název metody obchodního objektu, která vybere data, a zahrnout 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ě přidejte do kolekce všechny parametry FilterParameters pro filtrování dat při Select zavolání metody. Metoda určená SelectMethod vlastností musí vrátit nebo DataSetDataTable. |
| Paging | Stránkování zdroje dat se podporuje, 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ěchtoparametrůch MaximumRowsParameterNameStartRowIndexParameterName 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é vlastností SelectMethod . Požadavek na to, aby ovládací prvek vázané na data mohl provést je, že metoda určená SelectMethod vlastností vrací objekt, který implementuje ICollection rozhraní. |
| Aktualizace | UpdateMethod Nastavte vlastnost na název metody obchodního objektu, která aktualizuje data, a zahrnout všechny nezbytné parametry v kolekciUpdateParameters. |
| Odstranit | DeleteMethod Nastavte vlastnost na název metody obchodního objektu nebo funkce, která odstraní data, a zahrnout všechny nezbytné parametry v kolekciDeleteParameters. |
| Vkládání | InsertMethod Nastavte vlastnost na název metody obchodního objektu nebo funkce, která vkládá data, a zahrnout všechny nezbytné parametry v kolekciInsertParameters. |
| Cacheování |
EnableCaching Nastavte vlastnost na truea CacheDuration vlastnosti podle CacheExpirationPolicy chování ukládání do mezipaměti, které chcete použít pro data uložená v mezipaměti. |
Poznámka:
Při použití ObjectDataSource třídy k aktualizaci nebo vložení dat, řetězce zadané v klientovi se automaticky nepřevedou z jazykové verze klienta do formátu jazykové verze serveru. Jazyková verze klienta může například jako formát data zadat DD/MM/RRRR a formát data na serveru může být MM/DD/RRRR. V takovém případě by bylo 5. října 2009 uvedeno do TextBox kontroly jako 5.10.2009, ale bylo by interpretováno jako 10. května 2009. 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ý ke třídě zobrazení zdroje dat.
ObjectDataSource I když je ovládací prvek rozhraní, se kterým vývojář stránky pracuje 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 správy zdroje dat a provádí skutečnou práci. Ovládací ObjectDataSource prvek má pouze jednu přidruženou ObjectDataSourceViewa vždy má název DefaultView.
ObjectDataSourceView Zatímco objekt je vystaven metodouGetView, mnoho jeho vlastností a metod jsou zabaleny a vystaveny 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 najdete na webu 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 SelectMethod, , UpdateMethodInsertMethoda DeleteMethod metody na metody ve třídě datového kontextu, které provádějí odpovídající operace. Chcete-li zrušit odstranění třídy kontextu dat, musíte pro ObjectDisposing událost vytvořit obslužnou rutinu události. Tento krok je nezbytný, protože LINQ to SQL podporuje odložené spuštění, zatímco ObjectDataSource ovládací prvek se pokusí likvidovat datový kontext po operaci Select. Další informace o vytváření tříd LINQ to SQL naleznete v tématu Postupy: Vytvoření LINQ to SQL Třídy 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 entity Framework. Další informace naleznete v tématu Použití Entity Framework a ObjectDataSource ovládacího prvku.
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
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
| Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control) |
| BindingContainer |
Získá ovládací prvek, který obsahuje datovou vazbu 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 načtená SelectMethod vlastností do mezipaměti. |
| 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í zdrojů dat. |
| CacheKeyDependency |
Získá nebo nastaví uživatelsky definovanou závislost klíče, která je propojena se všemi objekty mezipaměti dat vytvořenými ovládacím prvek zdroje dat. |
| ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (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í oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control) |
| ConflictDetection |
Získá nebo nastaví hodnotu, která určuje, zda jsou pouze nové hodnoty předány |
| 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 určující, zda Parameter hodnoty, které jsou předány do aktualizace, vložení nebo odstranění operace jsou automaticky převedeny z |
| DataItemContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control) |
| DataKeysContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control) |
| DataObjectTypeName |
Získá nebo nastaví název třídy, kterou ObjectDataSource ovládací prvek používá pro parametr v aktualizaci, vložení nebo odstranění datové operace namí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ů obsahující parametry, které jsou používány metodou DeleteMethod . |
| DesignMode |
Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control) |
| EnableCaching |
Získá nebo nastaví hodnotu určující, zda ObjectDataSource má ovládací prvek povoleno ukládání dat do mezipaměti. |
| EnablePaging |
Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek zdroje dat podporuje stránkování prostřednictvím sady dat, která načte. |
| EnableTheming |
Získá hodnotu určující, zda tento ovládací prvek podporuje motivy. (Zděděno od DataSourceControl) |
| EnableViewState |
Získá nebo nastaví hodnotu urč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 metodu, 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 určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control) |
| ID |
Získá nebo nastaví programový identifikátor přiřazený 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ů obsahující parametry, které jsou používány InsertMethod vlastností. |
| IsChildControlStateCleared |
Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control) |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
| LoadViewStateByID |
Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho 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ů, které se mají načíst pro podporu stránkování zdroje dat. |
| NamingContainer |
Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky 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 |
| 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 ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| ParsingCulture |
Získá nebo nastaví hodnotu, která označuje, jaké jazykové verze informace 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 verzi, která vykreslený KÓD 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 použije na DataSourceControl ovládací prvek. (Zděděno od DataSourceControl) |
| SortParameterName |
Získá nebo nastaví název obchodního objektu, který SelectMethod parametr použitý 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 se mají 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 pro 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 řízení. (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 pro ovládací prvek serveru. (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á urč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í ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control) |
| ViewStateIgnoresCase |
Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
| ViewStateMode |
Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control) |
| Visible |
Získá nebo nastaví hodnotu určující, zda je ovládací prvek vizuálně zobrazen. (Zděděno od DataSourceControl) |
Metody
| Name | Description |
|---|---|
| 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í serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru. (Zděděno od Control) |
| ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od DataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu uloženou ClientID v mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
| CreateChildControls() |
Volal ASP.NET stránkovací rámec, který informuje serverové ovládací prvky, které používají implementaci založenou na složení k vytvoření podřízených ovládacích prvků, které obsahují při přípravě na publikování zpět nebo vykreslování. (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ý ovládací prvek serveru a všechny jeho podřízené ovládací prvky. (Zděděno od Control) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek 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 k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control) |
| Delete() |
Provede operaci odstranění voláním metody, která je identifikována DeleteMethod vlastností se všemi 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í vykreslování dat v době návrhu. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda ovládací prvek serveru 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čuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| FindControl(String, Int32) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| FindControl(String) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| Focus() |
Nastaví vstupní fokus 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í funkce hash. (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ázvu trasy. (Zděděno od Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| GetType() |
Type Získá aktuální instanci. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control) |
| GetView(String) |
Načte pojmenované zobrazení zdroje dat, které je přidružené ke správě zdrojů dat. |
| GetViewNames() |
Načte kolekci názvů představující seznam objektů zobrazení přidružených k objektu ObjectDataSource . |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od DataSourceControl) |
| HasEvents() |
Vrátí hodnotu urč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šechny parametry v kolekci InsertParameters . |
| IsLiteralContent() |
Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control) |
| LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena 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 Object. (Zděděno od Object) |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků 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žité 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ího 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) |
Odešle obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control) |
| RenderControl(HtmlTextWriter) |
Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od DataSourceControl) |
| 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 může prohlížeč používat. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control) |
| SaveControlState() |
Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, 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 návrhu pro ovládací prvek. (Zděděno od Control) |
| SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control) |
| SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| SetTraceData(Object, Object) |
Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat 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šechny parametry, které jsou v kolekci UpdateParameters . |
Událost
| Name | Description |
|---|---|
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control) |
| Deleted |
Nastane po Delete() dokončení operace. |
| Deleting |
Nastane před Delete() operací. |
| Disposed |
Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control) |
| Filtering |
Nastane před operací filtru. |
| Init |
Nastane při inicializaci ovládacího prvku serveru, 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 |
Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control) |
| ObjectCreated |
Nastane po objektu, který je identifikován vlastností TypeName je vytvořen. |
| ObjectCreating |
Nastane před objektem, který je identifikován vlastností TypeName je vytvořen. |
| ObjectDisposing |
Nastane před objektem, který je identifikován vlastností TypeName je zahozen. |
| PreRender |
Nastane 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, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control) |
| Updated |
Nastane po Update() dokončení operace. |
| Updating |
Nastane před Update() operací. |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
Popis tohoto člena naleznete v tématu ControlBuilder. (Zděděno od Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Popis tohoto člena naleznete v tématu GetDesignModeState(). (Zděděno od Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Popis tohoto člena naleznete v tématu SetDesignModeState(IDictionary). (Zděděno od Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Popis tohoto člena naleznete v tématu SetOwnerControl(Control). (Zděděno od Control) |
| IControlDesignerAccessor.UserData |
Popis tohoto člena naleznete v tématu UserData. (Zděděno od Control) |
| IDataBindingsAccessor.DataBindings |
Popis tohoto člena naleznete v tématu DataBindings. (Zděděno od Control) |
| IDataBindingsAccessor.HasDataBindings |
Popis tohoto člena naleznete 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 naleznete v tématu Expressions. (Zděděno od Control) |
| IExpressionsAccessor.HasExpressions |
Popis tohoto člena naleznete 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 naleznete v tématu AddParsedSubObject(Object). (Zděděno od Control) |
Metody rozšíření
| Name | Description |
|---|---|
| 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 pojmenování 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
Viz také
- IDataSource
- DataSourceControl
- ObjectDataSourceView
- Návod: Datová vazba k vlastnímu obchodnímu objektu
- Ovládací prvky webového serveru zdroje dat
- Přehled ovládacího prvku ObjectDataSource
- Vytvoření zdrojového objektu ovládacího prvku ObjectDataSource
- Použití Entity Frameworku a ovládacího prvku ObjectDataSource
