DataBoundControl 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í.
Slouží jako základní třída pro všechny ovládací prvky vázané na data ASP.NET verze 2.0, které zobrazují data ve formě seznamu nebo tabulky.
public ref class DataBoundControl abstract : System::Web::UI::WebControls::BaseDataBoundControlpublic abstract class DataBoundControl : System.Web.UI.WebControls.BaseDataBoundControltype DataBoundControl = class
inherit BaseDataBoundControlPublic MustInherit Class DataBoundControl
Inherits BaseDataBoundControl- Dědičnost
- Odvozené
Příklady
Následující příklad kódu ukazuje, jak odvodit třídu z DataBoundControl třídy k vytvoření vlastního ovládacího prvku vázaného na data. Ovládací TextBoxSet prvek vytvoří TextBox ovládací prvek pro každou položku dat načtenou z přidruženého ovládacího prvku zdroje dat a vytvoří vazbu na hodnotu položky dat za běhu. Aktuální implementace Render metody vykresluje TextBox ovládací prvky jako neuspořádaný seznam.
using System;
using System.Collections;
using System.ComponentModel;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
namespace Samples.AspNet.Controls.CS {
[AspNetHostingPermission(SecurityAction.Demand,
Level=AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level=AspNetHostingPermissionLevel.Minimal)]
public class TextBoxSet : DataBoundControl {
private IList alBoxSet;
public IList BoxSet {
get {
if (null == alBoxSet) {
alBoxSet = new ArrayList();
}
return alBoxSet;
}
}
public string DataTextField {
get {
object o = ViewState["DataTextField"];
return((o == null) ? string.Empty : (string)o);
}
set {
ViewState["DataTextField"] = value;
if (Initialized) {
OnDataPropertyChanged();
}
}
}
protected override void PerformSelect() {
// Call OnDataBinding here if bound to a data source using the
// DataSource property (instead of a DataSourceID), because the
// databinding statement is evaluated before the call to GetData.
if (! IsBoundUsingDataSourceID) {
OnDataBinding(EventArgs.Empty);
}
// The GetData method retrieves the DataSourceView object from
// the IDataSource associated with the data-bound control.
GetData().Select(CreateDataSourceSelectArguments(),
OnDataSourceViewSelectCallback);
// The PerformDataBinding method has completed.
RequiresDataBinding = false;
MarkAsDataBound();
// Raise the DataBound event.
OnDataBound(EventArgs.Empty);
}
private void OnDataSourceViewSelectCallback(IEnumerable retrievedData) {
// Call OnDataBinding only if it has not already been
// called in the PerformSelect method.
if (IsBoundUsingDataSourceID) {
OnDataBinding(EventArgs.Empty);
}
// The PerformDataBinding method binds the data in the
// retrievedData collection to elements of the data-bound control.
PerformDataBinding(retrievedData);
}
protected override void PerformDataBinding(IEnumerable retrievedData) {
base.PerformDataBinding(retrievedData);
// If the data is retrieved from an IDataSource as an
// IEnumerable collection, attempt to bind its values to a
// set of TextBox controls.
if (retrievedData != null) {
foreach (object dataItem in retrievedData) {
TextBox box = new TextBox();
// The dataItem is not just a string, but potentially
// a System.Data.DataRowView or some other container.
// If DataTextField is set, use it to determine which
// field to render. Otherwise, use the first field.
if (DataTextField.Length > 0) {
box.Text = DataBinder.GetPropertyValue(dataItem,
DataTextField, null);
}
else {
PropertyDescriptorCollection props =
TypeDescriptor.GetProperties(dataItem);
// Set the "default" value of the TextBox.
box.Text = String.Empty;
// Set the true data-bound value of the TextBox,
// if possible.
if (props.Count >= 1) {
if (null != props[0].GetValue(dataItem)) {
box.Text = props[0].GetValue(dataItem).ToString();
}
}
}
BoxSet.Add(box);
}
}
}
protected override void Render(HtmlTextWriter writer) {
// Render nothing if the control is empty.
if (BoxSet.Count <= 0) {
return;
}
// Make sure the control is declared in a form tag
// with runat=server.
if (Page != null) {
Page.VerifyRenderingInServerForm(this);
}
// For this example, render the BoxSet as
// an unordered list of TextBox controls.
writer.RenderBeginTag(HtmlTextWriterTag.Ul);
foreach (object item in BoxSet) {
TextBox box = (TextBox) item;
// Write each element as
// <li><input type="text" value="string"><input/></li>
writer.WriteBeginTag("li");
writer.Write(">");
writer.WriteBeginTag("input");
writer.WriteAttribute("type", "text");
writer.WriteAttribute("value", box.Text);
writer.Write(">");
writer.WriteEndTag("input");
writer.WriteEndTag("li");
}
writer.RenderEndTag();
}
}
}
Imports System.Collections
Imports System.ComponentModel
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace Samples.AspNet.Controls.VB
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal), _
AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class TextBoxSet
Inherits DataBoundControl
Private alBoxSet As IList
Public ReadOnly Property BoxSet() As IList
Get
If alBoxSet Is Nothing Then
alBoxSet = New ArrayList()
End If
Return alBoxSet
End Get
End Property
Public Property DataTextField() As String
Get
Dim o As Object = ViewState("DataTextField")
If o Is Nothing Then
Return String.Empty
Else
Return CStr(o)
End If
End Get
Set(ByVal value As String)
ViewState("DataTextField") = value
If (Initialized) Then
OnDataPropertyChanged()
End If
End Set
End Property
Protected Overrides Sub PerformSelect()
' Call OnDataBinding here if bound to a data source using the
' DataSource property (instead of a DataSourceID) because the
' data-binding statement is evaluated before the call to GetData.
If Not IsBoundUsingDataSourceID Then
OnDataBinding(EventArgs.Empty)
End If
' The GetData method retrieves the DataSourceView object from the
' IDataSource associated with the data-bound control.
GetData().Select(CreateDataSourceSelectArguments(), _
AddressOf OnDataSourceViewSelectCallback)
' The PerformDataBinding method has completed.
RequiresDataBinding = False
MarkAsDataBound()
' Raise the DataBound event.
OnDataBound(EventArgs.Empty)
End Sub
Private Sub OnDataSourceViewSelectCallback(ByVal retrievedData As IEnumerable)
' Call OnDataBinding only if it has not already
' been called in the PerformSelect method.
If IsBoundUsingDataSourceID Then
OnDataBinding(EventArgs.Empty)
End If
' The PerformDataBinding method binds the data in the retrievedData
' collection to elements of the data-bound control.
PerformDataBinding(retrievedData)
End Sub
Protected Overrides Sub PerformDataBinding(ByVal retrievedData As IEnumerable)
MyBase.PerformDataBinding(retrievedData)
' If the data is retrieved from an IDataSource as an IEnumerable
' collection, attempt to bind its values to a set of TextBox controls.
If Not (retrievedData Is Nothing) Then
Dim dataItem As Object
For Each dataItem In retrievedData
Dim box As New TextBox()
' The dataItem is not just a string, but potentially
' a System.Data.DataRowView or some other container.
' If DataTextField is set, use it to determine which
' field to render. Otherwise, use the first field.
If DataTextField.Length > 0 Then
box.Text = DataBinder.GetPropertyValue( _
dataItem, DataTextField, Nothing)
Else
Dim props As PropertyDescriptorCollection = _
TypeDescriptor.GetProperties(dataItem)
' Set the "default" value of the TextBox.
box.Text = String.Empty
' Set the true data-bound value of the TextBox,
' if possible.
If props.Count >= 1 Then
If props(0).GetValue(dataItem) IsNot Nothing Then
box.Text = props(0).GetValue(dataItem).ToString()
End If
End If
End If
BoxSet.Add(box)
Next dataItem
End If
End Sub
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
' Render nothing if the control is empty.
If BoxSet.Count <= 0 Then
Return
End If
' Make sure the control is declared in a form tag with runat=server.
If Not (Page Is Nothing) Then
Page.VerifyRenderingInServerForm(Me)
End If
' For this example, render the BoxSet as
' an unordered list of TextBox controls.
writer.RenderBeginTag(HtmlTextWriterTag.Ul)
Dim item As Object
For Each item In BoxSet
Dim box As TextBox = CType(item, TextBox)
' Write each element as
' <li><input type="text" value="string"><input/></li>
writer.WriteBeginTag("li")
writer.Write(">")
writer.WriteBeginTag("input")
writer.WriteAttribute("type", "text")
writer.WriteAttribute("value", box.Text)
writer.Write(">")
writer.WriteEndTag("input")
writer.WriteEndTag("li")
Next item
writer.RenderEndTag()
End Sub
End Class
End Namespace
Následující příklad kódu ukazuje, jak použít TextBoxSet ovládací prvek, definovaný v předchozím příkladu, a vytvořit vazbu k ovládacímu prvku AccessDataSource .
<%@Page language="c#" %>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.Controls.CS"
Assembly="Samples.AspNet.Controls.CS" %>
<!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>TextBoxSet Data-Bound Control - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<aspSample:textboxset
id="TextBoxSet1"
runat="server"
datasourceid="AccessDataSource1" />
<asp:accessdatasource
id="AccessDataSource1"
runat="server"
datafile="Northwind.mdb"
selectcommand="SELECT lastname FROM Employees" />
</form>
</body>
</html>
<%@Page language="VB" %>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.Controls.VB"
Assembly="Samples.AspNet.Controls.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>TextBoxSet Data-Bound Control - VB Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<aspSample:textboxset
id="TextBoxSet1"
runat="server"
datasourceid="AccessDataSource1" />
<asp:accessdatasource
id="AccessDataSource1"
runat="server"
datafile="Northwind.mdb"
selectcommand="SELECT lastname FROM Employees" />
</form>
</body>
</html>
Poznámky
Třída DataBoundControl je základní třída používaná pro ASP.NET ovládací prvky, které načítají tabulková data nebo data ve stylu seznamu z ASP.NET ovládacího prvku zdroje dat a sváže prvky uživatelského rozhraní (UI) ovládacího prvku s daty pro zobrazení. Složené ovládací prvky vázané na data, jako GridViewjsou , DetailsViewa FormView; ovládací prvky vázané na data ve stylu seznamu, jako BulletedList jsou a CheckBoxList; a další ovládací prvky, jako AdRotator jsou odvozené z DataBoundControl.
Vývojáři stránek nepoužívají DataBoundControl třídu přímo, ale místo toho používají ovládací prvky odvozené z této třídy.
Vývojáři ovládacích prvků rozšiřují tuto třídu o vytváření ovládacích prvků vázaných na data, které pracují s třídami, které implementují IDataSource rozhraní a třídy odvozené z DataSourceControl tříd a DataSourceView . Při odvozování třídy z DataBoundControl třídy přepište metodu PerformDataBinding pro vytvoření vazby prvků uživatelského rozhraní ovládacího prvku na data načtená metodou GetData . Ve většině případů je metoda jedinou metodou, PerformDataBinding kterou v odvozené třídě přepíšete.
U ovládacích prvků PerformSelect vázaných na data ASP.NET 2.0 je metoda ekvivalentem DataBind metody a je volána k vytvoření vazby dat za běhu. Metoda PerformSelect volá GetData metody a PerformDataBinding .
Konstruktory
| DataBoundControl() |
Inicializuje DataBoundControl třídu pro použití zděděnou instancí třídy. Tento konstruktor může být volána pouze zděděnou třídou. |
Vlastnosti
| AccessKey |
Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl) |
| 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) |
| Attributes |
Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl) |
| BackColor |
Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BindingContainer |
Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control) |
| BorderColor |
Získá nebo nastaví barvu ohraničení webového ovládacího prvku. (Zděděno od WebControl) |
| BorderStyle |
Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BorderWidth |
Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| 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á ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control) |
| ClientIDMode |
Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control) |
| ClientIDSeparator |
Získá hodnotu znaku představující znak oddělovače použitý ve ClientID vlastnosti . (Zděděno od Control) |
| 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ý serverový ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control) |
| ControlStyle |
Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ControlStyleCreated |
Získá hodnotu označující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| CssClass |
Získá nebo nastaví css (CSS) třídy vykreslované webový server ovládací prvek v klientovi. (Zděděno od WebControl) |
| 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) |
| DataMember |
Získá nebo nastaví název seznamu dat, které váže ovládací prvek vázané na data, v případech, kdy zdroj dat obsahuje více než jeden jedinečný seznam datových položek. |
| DataSource |
Získá nebo nastaví objekt, ze kterého ovládací prvek vázané na data načte seznam datových položek. (Zděděno od BaseDataBoundControl) |
| DataSourceID |
Získá nebo nastaví ID ovládacího prvku, ze kterého ovládací prvek vázané na data načte seznam datových položek. |
| DataSourceObject |
Získá objekt, který implementuje IDataSource rozhraní, které poskytuje přístup k datovému obsahu objektu. |
| DesignMode |
Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control) |
| Enabled |
Získá nebo nastaví hodnotu označující, zda je povolený ovládací prvek webového serveru. (Zděděno od WebControl) |
| EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek. (Zděděno od WebControl) |
| 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) |
| Font |
Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru. (Zděděno od WebControl) |
| ForeColor |
Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl) |
| HasAttributes |
Získá hodnotu označující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl) |
| 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) |
| Height |
Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl) |
| 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) |
| Initialized |
Získá hodnotu označující, zda byl inicializován ovládací prvek vázaný na data. (Zděděno od BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
Získá hodnotu označující, zda je nastavena DataSourceID vlastnost. (Zděděno od BaseDataBoundControl) |
| 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) |
| IsDataBindingAutomatic |
Získá hodnotu, která označuje, zda je datová vazba automatická. (Zděděno od BaseDataBoundControl) |
| IsEnabled |
Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl) |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control) |
| IsUsingModelBinders |
Získá hodnotu, která označuje, zda se používá vazba modelu. |
| IsUsingModelBinders |
Při implementaci v odvozené třídě získá hodnotu, která označuje, zda ovládací prvek používá pořadače modelu. (Zděděno od BaseDataBoundControl) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je stav zobrazení povolen pro tento ovládací prvek. (Zděděno od Control) |
| ItemType |
Získá nebo nastaví název datové položky typu pro datové vazby silného typu. |
| 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) |
| 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) |
| 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) |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verze, která vykreslovala HTML bude kompatibilní s. (Zděděno od Control) |
| RequiresDataBinding |
Získá nebo nastaví hodnotu určující, zda DataBind() má být volána metoda. (Zděděno od BaseDataBoundControl) |
| SelectArguments |
DataSourceSelectArguments Získá objekt, který ovládací prvek vázané na data používá při načítání dat z ovládacího prvku zdroje dat. |
| SelectMethod |
Název metody, která se má volat za účelem čtení dat. |
| 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á nebo nastaví vzhled pro použití ovládacího prvku. (Zděděno od WebControl) |
| Style |
Získá kolekci textových atributů, které budou vykresleny jako atribut stylu na vnější značku webového serveru ovládacího prvku. (Zděděno od WebControl) |
| SupportsDisabledAttribute |
Získá hodnotu, která označuje, zda má ovládací prvek nastavit |
| TabIndex |
Získá nebo nastaví index tabulátoru ovládacího prvku webového serveru. (Zděděno od WebControl) |
| TagKey |
HtmlTextWriterTag Získá hodnotu, která odpovídá ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl) |
| TagName |
Získá název značky ovládacího prvku. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl) |
| 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) |
| ToolTip |
Získá nebo nastaví text zobrazený, když ukazatel myši najede na ovládací prvek webového serveru. (Zděděno od WebControl) |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku. (Zděděno od Control) |
| 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, která označuje, zda serverový ovládací prvek je vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control) |
| Width |
Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl) |
Metody
| AddAttributesToRender(HtmlTextWriter) |
Přidá atributy a styly HTML, které je potřeba vykreslit na zadaný HtmlTextWriterTag. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| 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) |
| ApplyStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ApplyStyleSheetSkin(Page) |
Použije na ovládací prvek vlastnosti stylu definované v šabloně stylů stránky. (Zděděno od Control) |
| 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 |
| 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) |
| ConfirmInitState() |
Nastaví inicializovaný stav ovládacího prvku vázaného na data. (Zděděno od BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je volána tato metoda. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| 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ří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku. (Zděděno od Control) |
| CreateControlStyle() |
Vytvoří objekt stylu, který se interně používá třídy k implementaci všech vlastností souvisejících se stylem WebControl . Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| CreateDataSourceSelectArguments() |
Pokud nejsou zadány žádné argumenty, vytvoří výchozí DataSourceSelectArguments objekt používaný ovládacím prvekem vázaným na data. |
| DataBind() |
Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky. (Zděděno od BaseDataBoundControl) |
| 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) |
| 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) |
| EnsureDataBound() |
Zavolá metoduDataSourceID, DataBind() pokud je vlastnost nastavena a ovládací prvek vázaný na data je označen tak, aby vyžadoval vazbu. (Zděděno od BaseDataBoundControl) |
| 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 názvovém kontejneru serverový ovládací prvek se zadaným |
| FindControl(String, Int32) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným |
| Focus() |
Nastaví fokus vstupu na ovládací prvek. (Zděděno od Control) |
| GetData() |
Načte DataSourceView objekt, který ovládací prvek vázaný na data používá k provádění operací s daty. |
| GetDataSource() |
Načte IDataSource rozhraní, ke kterému je přidružen ovládací prvek vázaný na data, pokud existuje. |
| 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) |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control) |
| 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) |
| 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) |
Obnoví informace o stavu zobrazení z předchozí žádosti o stránku, která byla uložena metodou SaveViewState() . |
| LoadViewState(Object) |
Obnoví informace o stavu zobrazení z předchozího požadavku, který byl uložen s metodou SaveViewState() . (Zděděno od WebControl) |
| MapPathSecure(String) |
Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní. (Zděděno od Control) |
| MarkAsDataBound() |
Nastaví stav ovládacího prvku ve stavu zobrazení jako úspěšně svázaný s daty. |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| MergeStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| 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) |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
CreatingModelDataSource Vyvolá událost. |
| OnDataBinding(EventArgs) |
DataBinding Vyvolá událost. (Zděděno od Control) |
| OnDataBound(EventArgs) |
DataBound Vyvolá událost. (Zděděno od BaseDataBoundControl) |
| OnDataPropertyChanged() |
Obnoví vazbu ovládacího prvku vázaného na data na jeho data po změně jedné z vlastností identifikace základního zdroje dat. |
| OnDataSourceViewChanged(Object, EventArgs) |
DataSourceViewChanged Vyvolá událost. |
| OnInit(EventArgs) |
Init Zpracovává událost. (Zděděno od BaseDataBoundControl) |
| OnLoad(EventArgs) |
Load Zpracovává událost. |
| OnPagePreLoad(Object, EventArgs) |
Nastaví inicializovaný stav ovládacího prvku vázaného na data před načtením ovládacího prvku. |
| OnPreRender(EventArgs) |
PreRender Zpracovává událost. (Zděděno od BaseDataBoundControl) |
| 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) |
| PerformDataBinding(IEnumerable) |
Při přepsání v odvozené třídě vytvoří vazbu dat ze zdroje dat k ovládacímu prvku. |
| PerformSelect() |
Načte data z přidruženého zdroje dat. |
| 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) |
| 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) |
Vykreslí ovládací prvek do zadaného zapisovače HTML. (Zděděno od WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Vykreslí levou značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| 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) |
| RenderContents(HtmlTextWriter) |
Vykreslí obsah ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| RenderControl(HtmlTextWriter) |
Vypíše obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povoleno. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control) |
| RenderEndTag(HtmlTextWriter) |
Vykreslí koncovou značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| 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ží všechny změny stavu zobrazení, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. |
| SaveViewState() |
Uloží všechny stavy, které byly změněny po vyvolání TrackViewState() metody. (Zděděno od WebControl) |
| 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() |
Způsobí, že změny stavu zobrazení ovládacího prvku budou sledovány, aby mohly být uloženy v objektu StateBag ovládacího prvku. |
| TrackViewState() |
Způsobí, že ovládací prvek sleduje změny stavu zobrazení, aby mohly být uloženy ve vlastnosti objektu ViewState . (Zděděno od WebControl) |
| ValidateDataSource(Object) |
Ověřuje, že objekt, se kterým se ovládací prvek vázaný na data váže, je objekt, se kterým může pracovat. |
Událost
| CallingDataMethods |
Dochází při volání datových metod. |
| CreatingModelDataSource |
Nastane při vytváření objektu ModelDataSource . |
| DataBinding |
Vyvolá se při vytvoření vazby serverového ovládacího prvku na zdroj dat. (Zděděno od Control) |
| DataBound |
Nastane po vytvoření vazby serverového ovládacího prvku na zdroj dat. (Zděděno od BaseDataBoundControl) |
| 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) |
| 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) |
| Load |
Vyvolá se při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control) |
| PreRender |
Vyvolá se po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| Unload |
Nastane při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
Metody rozšíření
| EnablePersistedSelection(BaseDataBoundControl) |
Zastaralé.
Umožňuje zachovat výběr v ovládacích prvcích dat, které podporují výběr a stránkování. |
| 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. |
Platí pro
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro