XmlDataSource Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Representerar en XML-datakälla för databundna kontroller.
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- Arv
- Attribut
- Implementeringar
Exempel
Det här avsnittet innehåller två kodexempel. Det första kodexemplet visar hur du använder en XmlDataSource kontroll med en TreeView kontroll för att visa XML-data från XML-exempelfilen. Det andra exemplet visar hur du använder en XmlDataSource kontroll med en mallbaserad Repeater kontroll för att visa XML-data.
Följande kodexempel visar hur du använder en XmlDataSource kontroll med en TreeView kontroll för att visa XML-data. Läser XmlDataSource in XML-data från XML-filen som identifieras av DataFile egenskapen.
<%@ 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>
XML-filen i kodexemplet har följande 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>
Följande kodexempel visar hur du använder en XmlDataSource kontroll med en mallbaserad Repeater kontroll för att visa XML-data. Kontrollen Repeater använder ett XPath-databindningsuttryck för att binda till dataobjekt i XML-dokumentet som XmlDataSource representerar. Mer information om XPath och XPathSelect databindningssyntax finns i XPathBinder klassen .
<%@ 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>
XML-filen i kodexemplet har följande 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>
Kommentarer
I det här avsnittet:
Introduction
Kontrollen XmlDataSource är en datakällakontroll som visar XML-data för databundna kontroller. Kontrollen XmlDataSource kan användas av databundna kontroller för att visa både hierarkiska data och tabelldata. Kontrollen XmlDataSource används vanligtvis för att visa hierarkiska XML-data i skrivskyddade scenarier. XmlDataSource Eftersom kontrollen utökar klassen fungerar den HierarchicalDataSourceControl med hierarkiska data. Kontrollen XmlDataSource implementerar IDataSource även gränssnittet och fungerar med tabelldata eller listformat.
Note
Av säkerhetsskäl lagras ingen av kontrollegenskaperna XmlDataSource i visningstillstånd. Eftersom det är tekniskt möjligt att avkoda innehållet i visningstillståndet på klienten kan lagring av känslig information om datastrukturen eller dess innehåll göra dig utsatt för ett informationsutlämnandehot. Observera att om du behöver lagra information, till exempel XPath egenskap i visningstillstånd, kan du aktivera kryptering för att skydda innehållet genom att ange ViewStateEncryptionMode i @ Page direktivet.
Sidutvecklare använder XmlDataSource kontrollen för att visa XML-data med hjälp av databundna kontroller.
Källor för XML-data
Läser XmlDataSource vanligtvis in XML-data från en XML-fil, som anges av egenskapen DataFile . XML-data kan också lagras direkt av datakällans kontroll i strängform med hjälp av Data egenskapen . Om du vill transformera XML-data innan de visas av en databunden kontroll kan du ange ett XSL-formatmall (Extensible Stylesheet Language) för omvandlingen. Precis som med XML-data läser du vanligtvis in formatmallen från en fil, vilket anges av TransformFile egenskapen, men du kan också lagra den i strängformulär direkt med hjälp av Transform egenskapen .
Uppdatera XML-data
Kontrollen XmlDataSource används ofta i skrivskyddade datascenarier där en databunden kontroll visar XML-data. Du kan dock också använda kontrollen XmlDataSource för att redigera XML-data. Om du vill redigera XML-data anropar GetXmlDocument du metoden för att hämta ett XmlDataDocument objekt som är en minnesintern representation av XML-data. Du kan använda objektmodellen som exponeras av objekten XmlDataDocument och XmlNode som den innehåller eller använda ett XPath-filtreringsuttryck för att manipulera data i dokumentet. När du har gjort ändringar i minnesintern representation av XML-data kan du spara dem på disken genom att anropa Save metoden.
Det finns vissa begränsningar för kontrollens XmlDataSource redigeringsfunktioner:
XML-data måste läsas in från en XML-fil som anges av DataFile egenskapen, inte från infogad XML som anges i Data egenskapen.
Ingen XSLT-transformering kan anges i Transform egenskaperna eller TransformFile .
Metoden Save hanterar inte samtidiga sparandeåtgärder av olika begäranden. Om fler än en användare redigerar en XML-fil via XmlDataSourcefinns det ingen garanti för att alla användare arbetar med samma data. Det är också möjligt att en Save åtgärd misslyckas på grund av samma samtidighetsproblem.
Ange en XSL-transformering
En vanlig åtgärd som utförs med XML-data är att omvandla dem från en XML-datauppsättning till en annan. Kontrollen XmlDataSource stöder XML-transformeringar med Transform egenskaperna och TransformFile , som anger ett XSL-formatmallar som ska tillämpas på XML-data innan det skickas till en databunden kontroll, och TransformArgumentList egenskapen som gör att du kan ange dynamiska XSLT-formatmallsargument som ska användas av ett XSL-formatmallar under omvandlingen. Om du anger ett XPath-filtreringsuttryck med hjälp av XPath egenskapen tillämpas det efter att omvandlingen har ägt rum.
Note
Klassen XmlDataSource använder den inaktuella XslTransform klassen för att utföra XSL-transformeringar. Om du vill använda formatmallsfunktioner som introducerades efter XslTransform att klassen blev inaktuell tillämpar du transformeringarna manuellt med hjälp XslCompiledTransform av klassen.
Filtrering med ett XPath-uttryck
Som standard XmlDataSource läser kontrollen in alla XML-data i XML-filen som identifieras av DataFile egenskapen eller finns infogade i Data egenskapen, men du kan filtrera data med ett XPath-uttryck. Egenskapen XPath stöder ett XPath-syntaxfilter som tillämpas när XML-data har lästs in och transformerats.
Caching
I prestandasyfte är cachelagring aktiverat för XmlDataSource kontrollen som standard. Att öppna och läsa en XML-fil på servern varje gång en sida begärs kan minska programmets prestanda. Med cachelagring kan du minska bearbetningsbelastningen på servern på bekostnad av minnet på webbservern. i de flesta fall är detta en bra kompromiss. Cachelagrar XmlDataSource automatiskt data när EnableCaching egenskapen är inställd på true, och CacheDuration egenskapen anges till det antal sekunder som cacheminnet lagrar data innan cachen ogiltigförklaras. Du kan använda CacheExpirationPolicy för att ytterligare finjustera cachelagringsbeteendet för datakällkontrollen.
Ytterligare funktioner
I följande tabell visas ytterligare funktioner som stöds av XmlDataSource kontrollen.
| Capability | Description |
|---|---|
| Sortering | Stöds inte av XmlDataSource kontrollen. |
| Filtrering | Egenskapen XPath kan användas för att filtrera XML-data med ett lämpligt XPath-uttryck. |
| Paging | Stöds inte av XmlDataSource kontrollen. |
| Uppdatera | Stöds genom att XmlDataDocument ändra direkt och sedan anropa Save metoden. |
| Tas bort | Stöds genom att XmlDataDocument ändra direkt och sedan anropa Save metoden. |
| Infoga | Stöds genom att XmlDataDocument ändra direkt och sedan anropa Save metoden. |
| Caching | Aktiverad som standard, med CacheDuration egenskapen inställd på 0 (oändlig) och egenskapen CacheExpirationPolicy inställd på Absolute. |
Datavyobjekt
XmlDataSource Eftersom kontrollen stöder databundna kontroller som visar hierarkiska data samt kontroller som visar tabelldata, stöder datakällans kontroll flera typer av datakällans visningsobjekt på dess underliggande XML-data. Kontrollen XmlDataSource hämtar ett enskilt namngivet XmlDataSourceView objekt när det används med en databunden kontroll som visar tabelldata. Metoden GetViewNames identifierar den här enda namngivna vyn. När den XmlDataSource används med en databunden kontroll som visar hierarkiska data hämtar kontrollen en XmlHierarchicalDataSourceView för alla unika hierarkiska sökvägar som skickas GetHierarchicalView till metoden.
Deklarativ syntax
<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>
Konstruktorer
| Name | Description |
|---|---|
| XmlDataSource() |
Skapar en ny instans av XmlDataSource klassen. |
Egenskaper
| Name | Description |
|---|---|
| Adapter |
Hämtar det webbläsarspecifika adaptern för kontrollen. (Ärvd från Control) |
| AppRelativeTemplateSourceDirectory |
Hämtar eller anger den programrelativa virtuella katalogen PageUserControl för eller -objektet som innehåller den här kontrollen. (Ärvd från Control) |
| BindingContainer |
Hämtar kontrollen som innehåller den här kontrollens databindning. (Ärvd från Control) |
| CacheDuration |
Hämtar eller anger hur lång tid, i sekunder, som datakällans kontroll cachelagrar data som den har hämtat. |
| CacheExpirationPolicy |
Hämtar eller anger förfalloprincipen för cachen som kombineras med cachevaraktigheten för att beskriva cachelagringsbeteendet för den cache som datakällans kontroll använder. |
| CacheKeyContext |
Hämtar eller anger värdet för cachenyckeln för datakällans kontroll från visningstillståndet, eller lägger till cachenyckeln för att visa tillstånd. |
| CacheKeyDependency |
Hämtar eller anger ett användardefinierat nyckelberoende som är länkat till alla datacacheobjekt som skapats av datakällkontrollen. Alla cacheobjekt upphör uttryckligen att gälla när nyckeln upphör att gälla. |
| ChildControlsCreated |
Hämtar ett värde som anger om serverkontrollens underordnade kontroller har skapats. (Ärvd från Control) |
| ClientID |
Hämtar serverkontrollidentifieraren som genereras av ASP.NET. (Ärvd från HierarchicalDataSourceControl) |
| ClientIDMode |
Den här egenskapen används inte för datakällans kontroller. (Ärvd från HierarchicalDataSourceControl) |
| ClientIDSeparator |
Hämtar ett teckenvärde som representerar det avgränsartecken som används i egenskapen ClientID . (Ärvd från Control) |
| Context |
Hämtar objektet HttpContext som är associerat med serverkontrollen för den aktuella webbbegäran. (Ärvd från Control) |
| Controls |
Hämtar ett ControlCollection objekt som representerar de underordnade kontrollerna för en angiven serverkontroll i användargränssnittshierarkin. (Ärvd från HierarchicalDataSourceControl) |
| Data |
Hämtar eller anger ett block med XML-data som datakällans kontroll binder till. |
| DataFile |
Anger filnamnet på en XML-fil som datakällan binder till. |
| DataItemContainer |
Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataItemContainer. (Ärvd från Control) |
| DataKeysContainer |
Hämtar en referens till namngivningscontainern om namngivningscontainern implementerar IDataKeysControl. (Ärvd från Control) |
| DesignMode |
Hämtar ett värde som anger om en kontroll används på en designyta. (Ärvd från Control) |
| EnableCaching |
Hämtar eller anger ett värde som anger om XmlDataSource kontrollen har datacachelagring aktiverat. |
| EnableTheming |
Hämtar ett värde som anger om den här kontrollen stöder teman. (Ärvd från HierarchicalDataSourceControl) |
| EnableViewState |
Hämtar eller anger ett värde som anger om serverkontrollen bevarar sitt visningstillstånd och visningstillståndet för eventuella underordnade kontroller som den innehåller till den begärande klienten. (Ärvd från Control) |
| Events |
Hämtar en lista över händelsehanterardelegater för kontrollen. Den här egenskapen är skrivskyddad. (Ärvd från Control) |
| HasChildViewState |
Hämtar ett värde som anger om den aktuella serverkontrollens underordnade kontroller har några sparade vytillståndsinställningar. (Ärvd från Control) |
| ID |
Hämtar eller anger den programmatiska identifierare som tilldelats serverkontrollen. (Ärvd från Control) |
| IdSeparator |
Hämtar det tecken som används för att separera kontrollidentifierare. (Ärvd från Control) |
| IsChildControlStateCleared |
Hämtar ett värde som anger om kontroller i den här kontrollen har kontrolltillstånd. (Ärvd från Control) |
| IsTrackingViewState |
Hämtar ett värde som anger om serverkontrollen sparar ändringar i visningstillståndet. (Ärvd från Control) |
| IsViewStateEnabled |
Hämtar ett värde som anger om visningstillstånd är aktiverat för den här kontrollen. (Ärvd från Control) |
| LoadViewStateByID |
Hämtar ett värde som anger om kontrollen deltar i inläsningen av dess visningstillstånd i ID stället för index. (Ärvd från Control) |
| NamingContainer |
Hämtar en referens till serverkontrollens namngivningscontainer, vilket skapar ett unikt namnområde för differentiering mellan serverkontroller med samma ID egenskapsvärde. (Ärvd från Control) |
| Page |
Hämtar en referens till den Page instans som innehåller serverkontrollen. (Ärvd från Control) |
| Parent |
Hämtar en referens till serverkontrollens överordnade kontroll i sidkontrollhierarkin. (Ärvd från Control) |
| RenderingCompatibility |
Hämtar ett värde som anger den ASP.NET version som renderad HTML kommer att vara kompatibel med. (Ärvd från Control) |
| Site |
Hämtar information om containern som är värd för den aktuella kontrollen när den återges på en designyta. (Ärvd från Control) |
| SkinID |
Hämtar eller ställer in huden för att applicera på HierarchicalDataSourceControl kontrollen. (Ärvd från HierarchicalDataSourceControl) |
| TemplateControl |
Hämtar eller anger en referens till mallen som innehåller den här kontrollen. (Ärvd från Control) |
| TemplateSourceDirectory |
Hämtar den virtuella katalogen för Page eller UserControl som innehåller den aktuella serverkontrollen. (Ärvd från Control) |
| Transform |
Hämtar eller anger ett block med XSL-data (Extensible Stylesheet Language) som definierar en XSLT-transformering som ska utföras på XML-data som hanteras av XmlDataSource kontrollen. |
| TransformArgumentList |
Innehåller en lista över XSLT-argument som används med formatmallen som definieras av Transform egenskaperna eller TransformFile för att utföra en transformering av XML-data. |
| TransformFile |
Anger filnamnet för en XSL-fil (Extensible Stylesheet Language) (.xsl) som definierar en XSLT-transformering som ska utföras på XML-data som hanteras av XmlDataSource kontrollen. |
| UniqueID |
Hämtar den unika, hierarkiskt kvalificerade identifieraren för serverkontrollen. (Ärvd från Control) |
| ValidateRequestMode |
Hämtar eller anger ett värde som anger om kontrollen kontrollerar klientindata från webbläsaren efter potentiellt farliga värden. (Ärvd från Control) |
| ViewState |
Hämtar en ordlista med tillståndsinformation som gör att du kan spara och återställa visningstillståndet för en serverkontroll över flera begäranden för samma sida. (Ärvd från Control) |
| ViewStateIgnoresCase |
Hämtar ett värde som anger om objektet StateBag är skiftlägesokänsligt. (Ärvd från Control) |
| ViewStateMode |
Hämtar eller anger visningstillståndsläget för den här kontrollen. (Ärvd från Control) |
| Visible |
Hämtar eller anger ett värde som anger om kontrollen visas visuellt. (Ärvd från HierarchicalDataSourceControl) |
| XPath |
Anger ett XPath-uttryck som ska tillämpas på XML-data som ingår i Data egenskapen eller av DEN XML-fil som anges av DataFile egenskapen. |
Metoder
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
Anropas efter att en underordnad kontroll har lagts till i ControlsControl objektets samling. (Ärvd från Control) |
| AddParsedSubObject(Object) |
Meddelar serverkontrollen att ett element, antingen XML eller HTML, parsades och lägger till elementet i serverkontrollens ControlCollection objekt. (Ärvd från Control) |
| ApplyStyleSheetSkin(Page) |
Tillämpar de formategenskaper som definieras i sidformatmallen på kontrollen. (Ärvd från HierarchicalDataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Påbörjar designtidsspårning av återgivningsdata. (Ärvd från Control) |
| BuildProfileTree(String, Boolean) |
Samlar in information om serverkontrollen och levererar den till egenskapen Trace som ska visas när spårning är aktiverat för sidan. (Ärvd från Control) |
| ClearCachedClientID() |
Anger det cachelagrade ClientID värdet till |
| ClearChildControlState() |
Tar bort kontrolltillståndsinformationen för serverkontrollens underordnade kontroller. (Ärvd från Control) |
| ClearChildState() |
Tar bort informationen om visningstillstånd och kontrolltillstånd för alla serverkontrollens underordnade kontroller. (Ärvd från Control) |
| ClearChildViewState() |
Tar bort visningstillståndsinformationen för alla serverkontrollens underordnade kontroller. (Ärvd från Control) |
| ClearEffectiveClientIDMode() |
Anger egenskapen för ClientIDMode den aktuella kontrollinstansen och för eventuella underordnade kontroller till Inherit. (Ärvd från Control) |
| CreateChildControls() |
Anropas av det ASP.NET sidramverket för att meddela serverkontroller som använder kompositionsbaserad implementering för att skapa underordnade kontroller som de innehåller som förberedelse för att publicera tillbaka eller återge. (Ärvd från Control) |
| CreateControlCollection() |
Skapar ett nytt ControlCollection objekt som innehåller de underordnade kontrollerna (både literal och server) för serverkontrollen. (Ärvd från HierarchicalDataSourceControl) |
| DataBind() |
Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller. (Ärvd från Control) |
| DataBind(Boolean) |
Binder en datakälla till den anropade serverkontrollen och alla dess underordnade kontroller med ett alternativ för att skapa händelsen DataBinding . (Ärvd från Control) |
| DataBindChildren() |
Binder en datakälla till serverkontrollens underordnade kontroller. (Ärvd från Control) |
| Dispose() |
Gör att en serverkontroll kan utföra slutlig rensning innan den frigörs från minnet. (Ärvd från Control) |
| EndRenderTracing(TextWriter, Object) |
Avslutar designtidsspårning av återgivningsdata. (Ärvd från Control) |
| EnsureChildControls() |
Avgör om serverkontrollen innehåller underordnade kontroller. Om den inte gör det skapar den underordnade kontroller. (Ärvd från Control) |
| EnsureID() |
Skapar en identifierare för kontroller som inte har tilldelats någon identifierare. (Ärvd från Control) |
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| FindControl(String, Int32) |
Söker i den aktuella namngivningscontainern efter en serverkontroll med det angivna |
| FindControl(String) |
Söker i den aktuella namngivningscontainern efter en serverkontroll med den angivna |
| Focus() |
Anger indatafokus till kontrollen. (Ärvd från HierarchicalDataSourceControl) |
| GetDesignModeState() |
Hämtar designtidsdata för en kontroll. (Ärvd från Control) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetHierarchicalView(String) |
Hämtar datakällans visningsobjekt XmlDataSource för kontrollen. Parametern |
| GetRouteUrl(Object) |
Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control) |
| GetRouteUrl(RouteValueDictionary) |
Hämtar url:en som motsvarar en uppsättning routningsparametrar. (Ärvd från Control) |
| GetRouteUrl(String, Object) |
Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Hämtar url:en som motsvarar en uppsättning vägparametrar och ett vägnamn. (Ärvd från Control) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetUniqueIDRelativeTo(Control) |
Returnerar den prefixade delen av UniqueID egenskapen för den angivna kontrollen. (Ärvd från Control) |
| GetXmlDocument() |
Läser in XML-data i minnet, antingen direkt från den underliggande datalagringen eller från cacheminnet, och returnerar dem i form av ett XmlDataDocument objekt. |
| HasControls() |
Avgör om serverkontrollen innehåller några underordnade kontroller. (Ärvd från HierarchicalDataSourceControl) |
| HasEvents() |
Returnerar ett värde som anger om händelser har registrerats för kontrollen eller underordnade kontroller. (Ärvd från Control) |
| IsLiteralContent() |
Avgör om serverkontrollen endast innehåller literalinnehåll. (Ärvd från Control) |
| LoadControlState(Object) |
Återställer kontrolltillståndsinformation från en begäran från föregående sida som sparades av SaveControlState() metoden. (Ärvd från Control) |
| LoadViewState(Object) |
Återställer visningstillståndsinformation från en begäran från föregående sida som sparades av SaveViewState() metoden. (Ärvd från Control) |
| MapPathSecure(String) |
Hämtar den fysiska sökväg som en virtuell sökväg, antingen absolut eller relativ, mappar till. (Ärvd från Control) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnBubbleEvent(Object, EventArgs) |
Avgör om händelsen för serverkontrollen skickas upp på sidans UI-serverkontrollhierarki. (Ärvd från Control) |
| OnDataBinding(EventArgs) |
Genererar händelsen DataBinding . (Ärvd från Control) |
| OnDataSourceChanged(EventArgs) |
Genererar händelsen DataSourceChanged . (Ärvd från HierarchicalDataSourceControl) |
| OnInit(EventArgs) |
Genererar händelsen Init . (Ärvd från Control) |
| OnLoad(EventArgs) |
Genererar händelsen Load . (Ärvd från Control) |
| OnPreRender(EventArgs) |
Genererar händelsen PreRender . (Ärvd från Control) |
| OnTransforming(EventArgs) |
Genererar Transforming händelsen innan XmlDataSource kontrollen utför en XSLT-transformering på sina XML-data. |
| OnUnload(EventArgs) |
Genererar händelsen Unload . (Ärvd från Control) |
| OpenFile(String) |
Hämtar en Stream som används för att läsa en fil. (Ärvd från Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Tilldelar alla källor till händelsen och dess information till kontrollens överordnade. (Ärvd från Control) |
| RemovedControl(Control) |
Anropas efter att en underordnad Controls kontroll har tagits bort från objektets Control samling. (Ärvd från Control) |
| Render(HtmlTextWriter) |
Skickar serverkontrollinnehåll till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control) |
| RenderChildren(HtmlTextWriter) |
Matar ut innehållet i en serverkontrolls underordnade objekt till ett angivet HtmlTextWriter objekt som skriver innehållet som ska återges på klienten. (Ärvd från Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt med hjälp av ett angivet ControlAdapter objekt. (Ärvd från Control) |
| RenderControl(HtmlTextWriter) |
Matar ut serverkontrollinnehåll till ett angivet HtmlTextWriter objekt och lagrar spårningsinformation om kontrollen om spårning är aktiverat. (Ärvd från HierarchicalDataSourceControl) |
| ResolveAdapter() |
Hämtar kontrollkortet som ansvarar för att återge den angivna kontrollen. (Ärvd från Control) |
| ResolveClientUrl(String) |
Hämtar en URL som kan användas av webbläsaren. (Ärvd från Control) |
| ResolveUrl(String) |
Konverterar en URL till en som kan användas på den begärande klienten. (Ärvd från Control) |
| Save() |
Sparar XML-data som för närvarande lagras i minnet av XmlDataSource kontrollen till disken DataFile om egenskapen har angetts. |
| SaveControlState() |
Sparar alla ändringar i serverkontrolltillståndet som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från Control) |
| SaveViewState() |
Sparar alla ändringar i visningstillståndet för serverkontroll som har inträffat sedan sidan publicerades tillbaka till servern. (Ärvd från Control) |
| SetDesignModeState(IDictionary) |
Anger designtidsdata för en kontroll. (Ärvd från Control) |
| SetRenderMethodDelegate(RenderMethod) |
Tilldelar ett händelsehanterardelegat för att återge serverkontrollen och dess innehåll till den överordnade kontrollen. (Ärvd från Control) |
| SetTraceData(Object, Object, Object) |
Anger spårningsdata för designtidsspårning av återgivningsdata, med hjälp av det spårade objektet, spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control) |
| SetTraceData(Object, Object) |
Anger spårningsdata för designtidsspårning av återgivningsdata med hjälp av spårningsdatanyckeln och värdet för spårningsdata. (Ärvd från Control) |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| TrackViewState() |
Orsakar spårning av visningstillståndsändringar i serverkontrollen så att de kan lagras i serverkontrollens StateBag objekt. Det här objektet är tillgängligt via egenskapen ViewState . (Ärvd från Control) |
Händelser
| Name | Description |
|---|---|
| DataBinding |
Inträffar när serverkontrollen binder till en datakälla. (Ärvd från Control) |
| Disposed |
Inträffar när en serverkontroll frigörs från minnet, vilket är den sista fasen i serverkontrolllivscykeln när en ASP.NET sida begärs. (Ärvd från Control) |
| Init |
Inträffar när serverkontrollen initieras, vilket är det första steget i dess livscykel. (Ärvd från Control) |
| Load |
Inträffar när serverkontrollen läses in i Page objektet. (Ärvd från Control) |
| PreRender |
Inträffar efter att objektet Control har lästs in men före återgivningen. (Ärvd från Control) |
| Transforming |
Inträffar innan formatmallen som definieras av Transform egenskapen eller identifieras av TransformFile egenskapen tillämpas på XML-data. |
| Unload |
Inträffar när serverkontrollen tas bort från minnet. (Ärvd från Control) |
Explicita gränssnittsimplementeringar
| Name | Description |
|---|---|
| IControlBuilderAccessor.ControlBuilder |
En beskrivning av den här medlemmen finns i ControlBuilder. (Ärvd från Control) |
| IControlDesignerAccessor.GetDesignModeState() |
En beskrivning av den här medlemmen finns i GetDesignModeState(). (Ärvd från Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
En beskrivning av den här medlemmen finns i SetDesignModeState(IDictionary). (Ärvd från Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
En beskrivning av den här medlemmen finns i SetOwnerControl(Control). (Ärvd från Control) |
| IControlDesignerAccessor.UserData |
En beskrivning av den här medlemmen finns i UserData. (Ärvd från Control) |
| IDataBindingsAccessor.DataBindings |
En beskrivning av den här medlemmen finns i DataBindings. (Ärvd från Control) |
| IDataBindingsAccessor.HasDataBindings |
En beskrivning av den här medlemmen finns i HasDataBindings. (Ärvd från Control) |
| IDataSource.DataSourceChanged |
En beskrivning av den här medlemmen finns i DataSourceChanged. |
| IDataSource.GetView(String) |
Hämtar den namngivna datakällans vy som är associerad med datakällans kontroll. |
| IDataSource.GetViewNames() |
En beskrivning av den här medlemmen finns i GetViewNames(). |
| IExpressionsAccessor.Expressions |
En beskrivning av den här medlemmen finns i Expressions. (Ärvd från Control) |
| IExpressionsAccessor.HasExpressions |
En beskrivning av den här medlemmen finns i HasExpressions. (Ärvd från Control) |
| IHierarchicalDataSource.DataSourceChanged |
Inträffar när HierarchicalDataSourceControl har ändrats på något sätt som påverkar databundna kontroller. (Ärvd från HierarchicalDataSourceControl) |
| IHierarchicalDataSource.GetHierarchicalView(String) |
Hämtar visningshjälpobjektet IHierarchicalDataSource för gränssnittet för den angivna sökvägen. (Ärvd från HierarchicalDataSourceControl) |
| IListSource.ContainsListCollection |
En beskrivning av den här medlemmen finns i ContainsListCollection. |
| IListSource.GetList() |
En beskrivning av den här medlemmen finns i GetList(). |
| IParserAccessor.AddParsedSubObject(Object) |
En beskrivning av den här medlemmen finns i AddParsedSubObject(Object). (Ärvd från Control) |
Tilläggsmetoder
| Name | Description |
|---|---|
| FindDataSourceControl(Control) |
Returnerar datakällan som är associerad med datakontrollen för den angivna kontrollen. |
| FindFieldTemplate(Control, String) |
Returnerar fältmallen för den angivna kolumnen i den angivna kontrollens namngivningscontainer. |
| FindMetaTable(Control) |
Returnerar metatabellobjektet för den innehållande datakontrollen. |
| GetDefaultValues(IDataSource) |
Hämtar insamlingen av standardvärdena för den angivna datakällan. |
| GetMetaTable(IDataSource) |
Hämtar metadata för en tabell i det angivna datakällans objekt. |
| TryGetMetaTable(IDataSource, MetaTable) |
Avgör om tabellmetadata är tillgängliga. |
