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 pro ovládací prvky vázané 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 ovládací prvek XmlDataSource s ovládacím prvku TreeView k zobrazení dat XML z ukázkového souboru XML. Druhý příklad ukazuje, jak použít ovládací prvek XmlDataSource s ovládacím prvek šablonou Repeater k zobrazení dat XML.
Následující příklad kódu ukazuje, jak použít ovládací prvek XmlDataSource s ovládacím prvku TreeView k zobrazení dat XML. Načte XmlDataSource data XML ze souboru XML identifikovaného DataFile vlastností.
<%@ 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 ovládací prvek XmlDataSource s ovládacím prvek šablonou Repeater k zobrazení dat XML. Ovládací Repeater prvek používá výraz datové vazby XPath k vytvoření vazby s datovými položkami v rámci dokumentu XML, který XmlDataSource představuje. Další informace o XPath syntaxi a XPathSelect vazby dat najdete ve 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:
Úvod
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 mohou ovládací prvky 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, pracuje 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, ukládání citlivých informací o datové struktuře nebo jejím obsahu by vás mohlo vystavit hrozbě zpřístupnění informací. Všimněte si, že pokud potřebujete ukládat informace, jako XPath je například vlastnost ve stavu zobrazení, můžete povolit šifrování pro ochranu obsahu nastavením ViewStateEncryptionMode v direktivě @ Page .
Vývojáři stránek používají ovládací XmlDataSource 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 DataFile vlastností. Data XML mohou být také uložena přímo pomocí ovládacího prvku zdroje dat ve formě řetězce pomocí Data vlastnosti . Chcete-li transformovat data XML před jejich zobrazením ovládacím prvek vázaným na data, můžete pro transformaci poskytnout šablonu stylů XSL (Extensible Stylesheet Language). Stejně jako u dat XML obvykle načítáte šablonu stylů ze souboru označeného TransformFile vlastností, ale můžete ji také uložit v řetězcové formě přímo pomocí Transform vlastnosti.
Aktualizace dat XML
Ovládací prvek se XmlDataSource běžně používá v datových scénářích jen pro čtení, kde ovládací prvek vázaný na data zobrazuje data XML. Ovládací prvek však můžete použít XmlDataSource také k úpravě dat XML. Chcete-li upravit data XML, volejte metodu GetXmlDocument pro načtení objektu XmlDataDocument , který je reprezentací dat XML v paměti. Můžete použít objektový model vystavený XmlDataDocument objekty a XmlNode , které obsahuje, nebo můžete použít výraz filtrování XPath k manipulaci s daty v dokumentu. Pokud 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.
Ve vlastnostech nebo TransformFile nelze zadat Transform žádnou transformaci XSLT.
Metoda Save nezpracuje souběžné operace ukládání různými požadavky. Pokud soubor XML upravuje více uživatelů prostřednictvím XmlDataSourcenástroje , není zaručeno, že všichni uživatelé pracují se stejnými daty. Je také možné Save , že operace selže kvůli stejným problémům se souběžností.
Určení transformace XSL
Běžnou operací prováděnou s daty XML je jejich transformace z jedné datové sady XML na jinou. Ovládací XmlDataSource prvek podporuje transformace XML s vlastnostmi Transform a TransformFile , které určují šablonu stylů XSL, která se má použít na data XML před 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é mají být 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 šablon 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í XmlDataSource ovládací prvek načte všechna data XML v souboru XML identifikovaná DataFile vlastností nebo nalezená vložená ve Data vlastnosti, ale data můžete filtrovat pomocí výrazu XPath. Vlastnost XPath podporuje filtr syntaxe XPath, který se použije po načtení a transformaci dat XML.
Ukládání do mezipaměti
Pro účely výkonu je ukládání do mezipaměti pro XmlDataSource ovládací prvek ve výchozím nastavení povolené. Otevření a čtení souboru XML na serveru pokaždé, když je požadována stránka, může snížit výkon vaší aplikace. Ukládání do mezipaměti umožňuje snížit zatížení zpracování na serveru na úkor paměti na webovém serveru. ve většině případů je to dobrý kompromis. Objekt XmlDataSource automaticky ukládá data do mezipaměti, když EnableCaching je vlastnost nastavena na truehodnotu a CacheDuration vlastnost je nastavena na počet sekund, po které mezipaměť ukládá data, než bude platnost mezipaměti zneplatněná. 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
V následující tabulce jsou uvedeny 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. |
| Stránkování | Ovládací prvek nepodporuje XmlDataSource . |
| Aktualizace | Podporováno přímou XmlDataDocument manipulací a následným voláním Save metody. |
| odstraňování | Podporováno přímou XmlDataDocument manipulací a následným voláním Save metody. |
| Vložení | Podporováno přímou XmlDataDocument manipulací a následným voláním Save metody. |
| Ukládání do mezipaměti | Ve výchozím nastavení CacheDuration je tato vlastnost nastavená na hodnotu 0 (infinite) a vlastnost nastavená 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 prvek 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ého na data, který zobrazuje hierarchická data, XmlDataSource načte XmlHierarchicalDataSourceView ovládací prvek pro libovolnou 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
| XmlDataSource() |
Vytvoří novou instanci třídy XmlDataSource. |
Vlastnosti
| Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví aplikace relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek. (Zděděno od Control) |
| BindingContainer |
Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control) |
| CacheDuration |
Získá nebo nastaví dobu v sekundách, po kterou ovládací prvek zdroje dat ukládá data do mezipaměti, která načetla. |
| CacheExpirationPolicy |
Získá nebo nastaví zásadu vypršení platnosti mezipaměti, která je kombinována s dobou trvání mezipaměti popisovat chování mezipaměti mezipaměti, kterou používá řízení zdroje dat. |
| CacheKeyContext |
Získá nebo nastaví hodnotu klíče mezipaměti pro ovládací prvek zdroje dat ze stavu zobrazení nebo přidá klíč mezipaměti pro zobrazení stavu. |
| CacheKeyDependency |
Získá nebo nastaví závislost klíče definované uživatelem, která je propojena se všemi objekty mezipaměti dat vytvořené ovládací 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í 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ý server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od HierarchicalDataSourceControl) |
| Data |
Získá nebo nastaví blok dat XML, které ovládací prvek zdroje dat sváže. |
| DataFile |
Určuje název souboru XML, se kterým je zdroj dat svázán. |
| 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) |
| DesignMode |
Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control) |
| EnableCaching |
Získá nebo nastaví hodnotu označující, zda XmlDataSource má ovládací prvek povolenou ukládání dat do mezipaměti. |
| EnableTheming |
Získá hodnotu označ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, pro žá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 označující, zda podřízené ovládací prvky aktuálního serveru mají uložené nastavení stavu zobrazení. (Zděděno od Control) |
| ID |
Získá nebo nastaví programový identifikátor přiřazený k ovládacímu prvku serveru. (Zděděno od Control) |
| IdSeparator |
Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control) |
| IsChildControlStateCleared |
Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení. (Zděděno od Control) |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
| LoadViewStateByID |
Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu ID zobrazení místo indexu. (Zděděno od Control) |
| NamingContainer |
Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl 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 serverový ovládací prvek nadřazený ovládací prvek v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verze, která vykreslí HTML bude kompatibilní s. (Zděděno od Control) |
| Site |
Získá informace o kontejneru, který hostuje aktuální ovládací prvek při vykreslení na návrhové ploše. (Zděděno od Control) |
| SkinID |
Získá nebo nastaví kůži na ovládací prvek HierarchicalDataSourceControl . (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 ovládací prvek. (Zděděno od Control) |
| Transform |
Získá nebo nastaví blok dat XSL (Extensible Stylesheet Language), který definuje transformace XSLT, která má být provedena na data XML spravované ovládacím XmlDataSource prvku. |
| TransformArgumentList |
Obsahuje seznam argumentů XSLT, které se používají se šablonou stylů definovanou vlastnostmi Transform nebo TransformFile k provedení transformace dat XML. |
| TransformFile |
Určuje název souboru XSL (Extensible Stylesheet Language) (.xsl), který definuje transformaci XSLT pro data XML spravovaná ovládacím XmlDataSource prvku. |
| 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 označ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
| 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 prvek XML nebo HTML, a přidá element do objektu ovládacího prvku ControlCollection serveru. (Zděděno od Control) |
| ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu, které jsou definovány v šabloně stylů stránky na ovládací prvek. (Zděděno od HierarchicalDataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Zahájí trasování vykreslování dat v době návrhu. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu v ClientID mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení 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í všech podřízených ovládacích prvků 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() |
Volá se rozhraním ASP.NET stránky, aby upozornily ovládací prvky serveru, 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 publikování zpět nebo vykreslování. (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 HierarchicalDataSourceControl) |
| 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 Control) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvoláný 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() |
Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku. (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í vykreslovaných dat v době návrhu. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
| EnsureID() |
Vytvoří identifikátor ovládacích prvků, které nemají přiřazený identifikátor. (Zděděno od Control) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| FindControl(String) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek pomocí zadaného |
| 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 HierarchicalDataSourceControl) |
| 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) |
| 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á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() |
Získá aktuální Type instanci. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí předponu vlastnosti UniqueID zadaného ovládacího prvku. (Zděděno od Control) |
| GetXmlDocument() |
Načte data XML do paměti, 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, jestli serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od HierarchicalDataSourceControl) |
| 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, jestli 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() . (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 Objectsouboru . (Zděděno od Object) |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost serverového ovládacího prvku předána hierarchii ovládacích prvků serveru 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ředtím, XmlDataSource než ovládací prvek provede transformaci XSLT na data XML. |
| OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
| OpenFile(String) |
Stream Získá zvyk ke čtení souboru. (Zděděno od Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku. (Zděděno od Control) |
| RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control) |
| Render(HtmlTextWriter) |
Odesílá obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu, který zapisuje obsah, který se má vykreslit na klientovi. (Zděděno od Control) |
| RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderControl(HtmlTextWriter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené. (Zděděno od HierarchicalDataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control) |
| ResolveAdapter() |
Získá řídicí adaptér 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) |
| Save() |
Uloží data XML, která XmlDataSource ovládací prvek aktuálně uchovává v paměti, na disk, pokud je vlastnost nastavena DataFile . |
| SaveControlState() |
Uloží všechny změny stavu ovládacího prvku 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í 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) |
| 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, který vykresluje serverový ovládací prvek a jeho obsah 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í klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování vykreslování dat v době návrhu pomocí trasovaného objektu, 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í serverového ovládacího prvku, aby mohly být uloženy v objektu ovládacího prvku StateBag serveru. Tento objekt je přístupný prostřednictvím ViewState vlastnosti. (Zděděno od Control) |
Událost
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat. (Zděděno od Control) |
| Disposed |
Nastane 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 stránka ASP.NET. (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 při načtení serverového ovládacího prvku 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ů, která je definována Transform vlastností nebo identifikovaná TransformFile vlastností je použita na data XML. |
| 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í
| FindDataSourceControl(Control) |
Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek. |
| FindFieldTemplate(Control, String) |
Vrátí šablonu pole pro zadaný sloupec v kontejneru názvů zadaného ovládacího prvku. |
| FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |
| GetDefaultValues(IDataSource) |
Získá kolekci výchozích hodnot pro zadaný zdroj dat. |
| GetMetaTable(IDataSource) |
Získá metadata pro tabulku v zadaném objektu zdroje dat. |
| TryGetMetaTable(IDataSource, MetaTable) |
Určuje, jestli jsou k dispozici metadata tabulky. |
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