XmlDataSource 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 zdroj dat XML ovládacím prvkům vázaným na data.
public ref class XmlDataSource : System::Web::UI::HierarchicalDataSourceControl, System::ComponentModel::IListSource, System::Web::UI::IDataSource[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))]
public class XmlDataSource : System.Web.UI.HierarchicalDataSourceControl, System.ComponentModel.IListSource, System.Web.UI.IDataSource[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))>]
type XmlDataSource = class
inherit HierarchicalDataSourceControl
interface IDataSource
interface IListSourcePublic Class XmlDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource- Dědičnost
- Atributy
- Implementuje
Příklady
Tato část obsahuje dva příklady kódu. První příklad kódu ukazuje, jak použít XmlDataSource ovládací prvek s ovládacím TreeView prvku k zobrazení dat XML z ukázkového souboru XML. Druhý příklad ukazuje, jak použít XmlDataSource ovládací prvek se šablonovaným Repeater ovládacím prvku k zobrazení dat XML.
Následující příklad kódu ukazuje použití XmlDataSource ovládacího prvku s ovládacím TreeView prvku k zobrazení dat XML. Načte XmlDataSource data XML ze souboru XML identifikovaného vlastností DataFile .
<%@ 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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</form>
</body>
</html>
<%@ 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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</form>
</body>
</html>
Soubor XML v příkladu kódu obsahuje následující data:
<books>
<computerbooks>
<book title="Secrets of Silicon Valley" author="Sheryl Hunter"/>
<book title="Straight Talk About Computers" author="Dean Straight"/>
<book title="You Can Combat Computer Stress!" author="Marjorie Green"/>
</computerbooks>
<cookbooks>
<book title="Silicon Valley Gastronomic Treats" author="Innes del Castill"/>
</cookbooks>
</books>
Následující příklad kódu ukazuje, jak použít XmlDataSource ovládací prvek se šablonou Repeater ovládacího prvku k zobrazení dat XML. Ovládací Repeater prvek používá výraz datové vazby XPath k vytvoření vazby k datovým položkám v dokumentu XML, který XmlDataSource představuje. Další informace o XPath syntaxi datových vazeb najdete XPathSelect v XPathBinder třídě.
<%@ 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 runat="server">
<title>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
<%@ 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 runat="server">
<title>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
Soubor XML v příkladu kódu obsahuje následující data:
<?xml version="1.0" encoding="iso-8859-1"?>
<orders>
<order>
<customer id="12345" />
<customername>
<firstn>John</firstn>
<lastn>Smith</lastn>
</customername>
<transaction id="12345" />
<shipaddress>
<address1>1234 Tenth Avenue</address1>
<city>Bellevue</city>
<state>Washington</state>
<zip>98001</zip>
</shipaddress>
<summary>
<item dept="tools">screwdriver</item>
<item dept="tools">hammer</item>
<item dept="plumbing">fixture</item>
</summary>
</order>
</orders>
Poznámky
V tomto tématu:
Introduction
Ovládací XmlDataSource prvek je ovládací prvek zdroje dat, který prezentuje data XML ovládacím prvkům vázaným na data. Ovládací XmlDataSource prvky vázané na data je možné použít k zobrazení hierarchických i tabulkových dat. Ovládací XmlDataSource prvek se obvykle používá k zobrazení hierarchických dat XML ve scénářích jen pro čtení. XmlDataSource Protože ovládací prvek rozšiřuje HierarchicalDataSourceControl třídu, funguje s hierarchickými daty. Ovládací XmlDataSource prvek také implementuje IDataSource rozhraní a pracuje s tabulkovými daty nebo daty ve stylu seznamu.
Poznámka:
Pro účely zabezpečení nejsou žádné vlastnosti XmlDataSource ovládacího prvku uloženy ve stavu zobrazení. Vzhledem k tomu, že je technicky možné dekódovat obsah stavu zobrazení na klientovi, uložení citlivých informací o datové struktuře nebo jeho obsahu by vás mohlo vystavit hrozbě zpřístupnění informací. Upozorňujeme, že pokud potřebujete ukládat informace, jako XPath je vlastnost ve stavu zobrazení, můžete povolit šifrování, které chrání obsah nastavením ViewStateEncryptionMode direktivy @ Page .
Vývojáři stránek používají XmlDataSource ovládací prvek k zobrazení dat XML pomocí ovládacích prvků vázaných na data.
Zdroje dat XML
Obvykle XmlDataSource načte data XML ze souboru XML, který je určen vlastností DataFile . Data XML mohou být také uložena přímo ovládacím prvek zdroje dat ve formuláři řetězce pomocí Data vlastnosti. Pokud chcete transformovat data XML před zobrazením ovládacím prvku vázaném na data, můžete pro transformaci zadat šablonu stylů XSL (Extensible Stylesheet Language). Stejně jako u dat XML obvykle načtete šablonu stylů ze souboru označeného TransformFile vlastností, ale můžete ji také uložit přímo ve formuláři řetězce pomocí Transform vlastnosti.
Aktualizace dat XML
Ovládací XmlDataSource prvek se běžně používá ve scénářích dat jen pro čtení, kde ovládací prvek vázané na data zobrazuje data XML. Ovládací prvek ale můžete také použít XmlDataSource k úpravě dat XML. Chcete-li upravit data XML, zavolejte metodu GetXmlDocument načtení XmlDataDocument objektu, který je reprezentace dat XML v paměti. Můžete použít objektový model vystavený objekty XmlDataDocument a XmlNode objekty, které obsahuje, nebo použít výraz filtrování XPath k manipulaci s daty v dokumentu. Když jste provedli změny reprezentace dat XML v paměti, můžete je uložit na disk voláním Save metody.
Možnosti úprav XmlDataSource ovládacího prvku mají určitá omezení:
Data XML musí být načtena ze souboru XML, který je označen DataFile vlastností, nikoli z vloženého XML zadaného Data ve vlastnosti.
V objektech nebo TransformFile vlastnostech Transform nelze zadat žádnou transformaci XSLT.
Metoda Save nezpracuje souběžné operace ukládání podle různých požadavků. Pokud soubor XML upravuje více než jeden uživatel prostřednictvím souboru XmlDataSource, není zaručeno, že všichni uživatelé pracují se stejnými daty. Operace může také Save selhat kvůli stejným problémům souběžnosti.
Určení transformace XSL
Běžnou operací provedenou s daty XML je transformuje z jedné datové sady XML do jiné. Ovládací XmlDataSource prvek podporuje transformace XML s vlastnostmi Transform , TransformFile které určují šablonu stylů XSL, která se má použít pro data XML před jejich předáním do ovládacího prvku vázaného na data, a TransformArgumentList vlastnost, která umožňuje zadat dynamické argumenty šablony stylů XSLT, které budou použity šablonou stylů XSL během transformace. Pokud zadáte výraz filtrování XPath pomocí XPath vlastnosti, použije se po provedení transformace.
Poznámka:
Třída XmlDataSource používá zastaralou XslTransform třídu k provádění transformací XSL. Pokud chcete použít funkce šablony stylů, které byly zavedeny po XslTransform vyřazení třídy, použijte transformace ručně pomocí XslCompiledTransform třídy.
Filtrování pomocí výrazu XPath
Ve výchozím nastavení ovládací XmlDataSource prvek načte všechna data XML v souboru XML identifikované vlastností DataFile nebo nalezený vložený ve Data vlastnosti, ale data můžete filtrovat pomocí výrazu XPath. Tato XPath vlastnost podporuje filtr syntaxe XPath, který se použije po načtení a transformaci dat XML.
Cacheování
Pro účely výkonu XmlDataSource je pro ovládací prvek ve výchozím nastavení povolené ukládání do mezipaměti. Otevření a čtení souboru XML na serveru při každém vyžádání stránky může snížit výkon vaší aplikace. Ukládání do mezipaměti umožňuje snížit zatížení zpracování serveru na úkor paměti na webovém serveru; ve většině případů je to dobrý kompromis. Automaticky XmlDataSource ukládá data do mezipaměti, pokud EnableCaching je vlastnost nastavena na truehodnotu a CacheDuration vlastnost je nastavena na počet sekund, po které mezipaměť ukládá data před zrušením platnosti mezipaměti. Můžete použít CacheExpirationPolicy k dalšímu vyladění chování ukládání do mezipaměti ovládacího prvku zdroje dat.
Další funkce
Následující tabulka uvádí další funkce, které ovládací prvek podporuje XmlDataSource .
| Schopnost | Description |
|---|---|
| Řazení | Ovládací prvek nepodporuje XmlDataSource . |
| Filtrování | Vlastnost XPath lze použít k filtrování dat XML pomocí příslušného výrazu XPath. |
| Paging | Ovládací prvek nepodporuje XmlDataSource . |
| Aktualizace | Podporováno přímo manipulací XmlDataDocument s metodou a následným voláním Save metody. |
| Odstranit | Podporováno přímo manipulací XmlDataDocument s metodou a následným voláním Save metody. |
| Vkládání | Podporováno přímo manipulací XmlDataDocument s metodou a následným voláním Save metody. |
| Cacheování | Povoleno ve výchozím nastavení s vlastností nastavenou CacheDuration na 0 (nekonečné) a vlastnost nastavena CacheExpirationPolicy na Absolute. |
Objekt zobrazení dat
XmlDataSource Vzhledem k tomu, že ovládací prvek podporuje ovládací prvky vázané na data, které zobrazují hierarchická data a ovládací prvky, které zobrazují tabulková data, podporuje ovládací prvek zdroje dat více typů objektů zobrazení zdroje dat v podkladových datech XML. Ovládací XmlDataSource prvek načte jeden pojmenovaný XmlDataSourceView objekt při použití s ovládacím prvku vázaném na data, který zobrazuje tabulková data. Metoda GetViewNames identifikuje toto jedno pojmenované zobrazení. Při použití s ovládacím prvku vázaném na data, který zobrazuje hierarchická data, XmlDataSource ovládací prvek načte XmlHierarchicalDataSourceView pro jakoukoli jedinečnou hierarchickou cestu předanou GetHierarchicalView metodě.
Deklarativní syntaxe
<asp:XmlDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
DataFile="string"
EnableCaching="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnTransforming="Transforming event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
TransformArgumentList="string"
TransformFile="string"
Visible="True|False"
XPath="string"
>
<Data>string</Data>
<Transform>string</Transform>
</asp:XmlDataSource>
Konstruktory
| Name | Description |
|---|---|
| XmlDataSource() |
Vytvoří novou instanci XmlDataSource třídy. |
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, kterou ovládací prvek zdroje dat ukládá do mezipaměti data, která načetl. |
| CacheExpirationPolicy |
Získá nebo nastaví zásady vypršení platnosti mezipaměti, které jsou kombinovány s dobou trvání mezipaměti popisovat chování mezipaměti mezipaměti, kterou používá řízení zdrojů dat. |
| CacheKeyContext |
Získá nebo nastaví hodnotu klíče mezipaměti pro řízení zdroje dat ze stavu zobrazení nebo přidá klíč mezipaměti pro zobrazení stavu. |
| 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. Platnost všech objektů mezipaměti explicitně vyprší, když vyprší platnost klíče. |
| 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 HierarchicalDataSourceControl) |
| ClientIDMode |
Tato vlastnost se nepoužívá pro ovládací prvky zdroje dat. (Zděděno od HierarchicalDataSourceControl) |
| ClientIDSeparator |
Získá hodnotu znaku představující oddělovač znak 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ý server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od HierarchicalDataSourceControl) |
| Data |
Získá nebo nastaví blok dat XML, ke kterým ovládací prvek zdroje dat vytvoří vazbu. |
| DataFile |
Určuje název souboru XML, ke kterému zdroj dat vytvoří vazbu. |
| 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) |
| 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 XmlDataSource má ovládací prvek povoleno ukládání dat do mezipaměti. |
| EnableTheming |
Získá hodnotu určující, zda tento ovládací prvek podporuje motivy. (Zděděno od HierarchicalDataSourceControl) |
| 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) |
| 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) |
| 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) |
| 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) |
| 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) |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control) |
| 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í kůži, která se použije na HierarchicalDataSourceControl ovládací prvek. (Zděděno od HierarchicalDataSourceControl) |
| 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) |
| Transform |
Získá nebo nastaví blok dat XSL (Extensible Stylesheet Language), který definuje transformace XSLT, která se má provést s daty XML spravovanými ovládacím XmlDataSource prvku. |
| TransformArgumentList |
Poskytuje seznam argumentů XSLT, které se používají se šablonou stylů definovanou vlastnostmi nebo TransformFile vlastnostmi Transform k provedení transformace dat XML. |
| TransformFile |
Určuje název souboru souboru XSL (Extensible Stylesheet Language) (.xsl), který definuje transformaci XSLT, která se má provést s daty XML spravovanými ovládacím XmlDataSource prvku. |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control) |
| 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 HierarchicalDataSourceControl) |
| XPath |
Určuje výraz XPath, který se má použít na data XML obsažená Data vlastností nebo soubor XML označený DataFile vlastností. |
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 HierarchicalDataSourceControl) |
| 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ří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku serveru. (Zděděno od HierarchicalDataSourceControl) |
| 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) |
| 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 HierarchicalDataSourceControl) |
| 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) |
| GetHierarchicalView(String) |
Získá objekt zobrazení zdroje dat pro XmlDataSource ovládací prvek. Parametrem |
| 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() |
Získá Type aktuální instance. (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) |
| GetXmlDocument() |
Načte data XML do paměti, a to buď přímo z podkladového úložiště dat, nebo z mezipaměti, a vrátí je ve formě objektu XmlDataDocument . |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od HierarchicalDataSourceControl) |
| 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) |
| 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) |
Obnoví informace o stavu zobrazení z předchozí žádosti o stránku, která byla uložena metodou SaveViewState() . (Zděděno od Control) |
| 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) |
| OnDataSourceChanged(EventArgs) |
DataSourceChanged Vyvolá událost. (Zděděno od HierarchicalDataSourceControl) |
| OnInit(EventArgs) |
Init Vyvolá událost. (Zděděno od Control) |
| OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od Control) |
| OnPreRender(EventArgs) |
PreRender Vyvolá událost. (Zděděno od Control) |
| OnTransforming(EventArgs) |
Transforming Vyvolá událost před provedením XmlDataSource transformace XSLT u dat XML. |
| 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) |
| 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 HierarchicalDataSourceControl) |
| 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) |
| Save() |
Uloží data XML aktuálně uložená v paměti ovládacím XmlDataSource prvku na disk, pokud DataFile je vlastnost nastavena. |
| 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ží všechny změny stavu zobrazení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| 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() |
Způsobí sledování změn stavu zobrazení v ovládacím prvku serveru, aby je bylo možné uložit do objektu StateBag ovládacího prvku serveru. Tento objekt je přístupný prostřednictvím ViewState vlastnosti. (Zděděno od Control) |
Událost
| Name | Description |
|---|---|
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control) |
| 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) |
| Init |
Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control) |
| Load |
Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control) |
| PreRender |
Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| Transforming |
Nastane před šablonou stylů definovanou Transform vlastností nebo identifikovanou TransformFile vlastností se použije na data XML. |
| Unload |
Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
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. |
