XmlDataSource Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een XML-gegevensbron voor gegevensgebonden besturingselementen.

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 IListSource

Public Class XmlDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource

Overname: Object

Control

HierarchicalDataSourceControl
XmlDataSource

Kenmerken: ToolboxBitmapAttribute

Implementeringen: IListSource IDataSource

Voorbeelden

Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u een XmlDataSource besturingselement gebruikt met een TreeView besturingselement om XML-gegevens uit het XML-voorbeeldbestand weer te geven. In het tweede voorbeeld ziet u hoe u een XmlDataSource besturingselement gebruikt met een sjabloon Repeater voor het weergeven van XML-gegevens.

In het volgende codevoorbeeld ziet u hoe u een XmlDataSource besturingselement gebruikt met een TreeView besturingselement om XML-gegevens weer te geven. Hiermee XmlDataSource worden XML-gegevens uit het XML-bestand geladen dat is geïdentificeerd door de DataFile eigenschap.

<%@ 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>

Het XML-bestand in het codevoorbeeld bevat de volgende gegevens:

<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>

In het volgende codevoorbeeld ziet u hoe u een XmlDataSource besturingselement gebruikt met een sjabloon Repeater voor het weergeven van XML-gegevens. Het Repeater besturingselement maakt gebruik van een XPath-expressie voor gegevensbinding om verbinding te maken met gegevensitems in het XML-document dat het XmlDataSource voorstelt. Zie de XPath klasse voor meer informatie over XPathSelect en XPathBinder de syntaxis van gegevensbinding.

<%@ 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>

Het XML-bestand in het codevoorbeeld bevat de volgende gegevens:

<?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>

Opmerkingen

In dit onderwerp:

Introduction
Bronnen van XML-gegevens
XML-gegevens bijwerken
Een XSL-transformatie opgeven
Filteren met behulp van een XPath-expressie
Caching
Aanvullende functies
Gegevensweergaveobject
Declaratieve syntaxis

Introductie

Het XmlDataSource besturingselement is een besturingselement voor gegevensbronnen dat XML-gegevens weergeeft aan besturingselementen die afhankelijk zijn van gegevens. Het XmlDataSource besturingselement kan worden gebruikt door gegevensgebonden besturingselementen om zowel hiërarchische als tabellaire gegevens weer te geven. Het XmlDataSource besturingselement wordt doorgaans gebruikt om hiërarchische XML-gegevens weer te geven in scenario's met het kenmerk Alleen-lezen. Omdat het XmlDataSource besturingselement de HierarchicalDataSourceControl klasse uitbreidt, werkt het met hiërarchische gegevens. Het XmlDataSource besturingselement implementeert ook de IDataSource interface en werkt met gegevens in tabelvorm of lijststijl.

Note

Voor beveiligingsdoeleinden worden geen van de eigenschappen van het XmlDataSource besturingselement opgeslagen in de weergavestatus. Omdat het technisch mogelijk is om de inhoud van de weergavestatus op de client te decoderen, kan het opslaan van gevoelige informatie over de gegevensstructuur of de inhoud ervan u blootstellen aan een bedreiging voor openbaarmaking van informatie. Als u informatie zoals XPath eigenschap in de weergavestatus wilt opslaan, kunt u versleuteling inschakelen om de inhoud te beveiligen door de ViewStateEncryptionMode instructie in te stellen@ Page.

Paginaontwikkelaars gebruiken het XmlDataSource besturingselement om XML-gegevens weer te geven met behulp van gegevensgebonden besturingselementen.

Bronnen van XML-gegevens

De XmlDataSource doorgaans geladen XML-gegevens uit een XML-bestand, die door de DataFile eigenschap wordt opgegeven. XML-gegevens kunnen ook rechtstreeks worden opgeslagen door het besturingselement gegevensbron in tekenreeksformulier met behulp van de Data eigenschap. Als u de XML-gegevens wilt transformeren voordat deze worden weergegeven door een gegevensgebonden besturingselement, kunt u een XSL-opmaakmodel (Extensible Stylesheet Language) voor de transformatie opgeven. Net als bij de XML-gegevens laadt u meestal het opmaakmodel uit een bestand, aangegeven door de TransformFile eigenschap, maar u kunt het ook rechtstreeks opslaan in tekenreeksformulier met behulp van de Transform eigenschap.

XML-gegevens bijwerken

Het XmlDataSource besturingselement wordt vaak gebruikt in alleen-lezen gegevensscenario's waarbij een gegevensgebonden besturingselement XML-gegevens weergeeft. U kunt het besturingselement echter ook gebruiken XmlDataSource om XML-gegevens te bewerken. Als u de XML-gegevens wilt bewerken, roept u de GetXmlDocument methode aan om een XmlDataDocument object op te halen dat een in-memory weergave van de XML-gegevens is. U kunt het objectmodel gebruiken dat wordt weergegeven door de XmlDataDocument objecten die XmlNode het bevat of een XPath-filterexpressie gebruiken om gegevens in het document te bewerken. Wanneer u wijzigingen hebt aangebracht in de in-memory weergave van de XML-gegevens, kunt u deze opslaan op schijf door de Save methode aan te roepen.

Er zijn enkele beperkingen voor de bewerkingsmogelijkheden van het XmlDataSource besturingselement:

De XML-gegevens moeten worden geladen vanuit een XML-bestand dat wordt aangegeven door de DataFile eigenschap, niet van inline-XML die is opgegeven in de Data eigenschap.
Er kan geen XSLT-transformatie worden opgegeven in de Transform of TransformFile eigenschappen.
De Save methode verwerkt gelijktijdige opslagbewerkingen niet door verschillende aanvragen. Als meer dan één gebruiker een XML-bestand bewerkt via het XmlDataSourcebestand, is er geen garantie dat alle gebruikers met dezelfde gegevens werken. Het is ook mogelijk dat een Save bewerking mislukt vanwege dezelfde gelijktijdigheidsproblemen.

Een XSL-transformatie opgeven

Een algemene bewerking die wordt uitgevoerd met XML-gegevens, transformeert deze van de ene XML-gegevensset in een andere. Het XmlDataSource besturingselement ondersteunt XML-transformaties met de Transform en TransformFile eigenschappen, waarmee u een XSL-opmaakmodel opgeeft dat moet worden toegepast op XML-gegevens voordat het wordt doorgegeven aan een gegevensgebonden besturingselement en de TransformArgumentList eigenschap, waarmee u dynamische XSLT-opmaakmodelargumenten kunt opgeven die tijdens de transformatie door een XSL-opmaakmodel moeten worden gebruikt. Als u een XPath-filterexpressie opgeeft met behulp van de XPath eigenschap, wordt deze toegepast nadat de transformatie heeft plaatsgevonden.

Note

De XmlDataSource klasse gebruikt de afgeschafte XslTransform klasse om XSL-transformaties uit te voeren. Als u opmaakmodellen wilt gebruiken die zijn geïntroduceerd nadat de XslTransform klasse is afgeschaft, past u de transformaties handmatig toe met behulp van de XslCompiledTransform klasse.

Filteren met behulp van een XPath-expressie

Het besturingselement laadt standaard XmlDataSource alle XML-gegevens in het XML-bestand dat is geïdentificeerd door de DataFile eigenschap of inline in de Data eigenschap, maar u kunt de gegevens filteren met behulp van een XPath-expressie. De XPath eigenschap ondersteunt een XPath-syntaxisfilter dat wordt toegepast nadat XML-gegevens zijn geladen en getransformeerd.

Caching

Voor prestatiedoeleinden is caching standaard ingeschakeld voor het XmlDataSource besturingselement. Het openen en lezen van een XML-bestand op de server telkens wanneer een aangevraagde pagina de prestaties van uw toepassing kan verminderen. Met caching kunt u de verwerkingsbelasting op uw server verminderen ten koste van het geheugen op de webserver; in de meeste gevallen is dit een goede afweging. De XmlDataSource gegevens worden automatisch in de cache opgeslagen wanneer de EnableCaching eigenschap is ingesteld trueop en de CacheDuration eigenschap wordt ingesteld op het aantal seconden dat de cache gegevens opslaat voordat de cache ongeldig wordt gemaakt. U kunt het CacheExpirationPolicy cachegedrag van het besturingselement voor gegevensbronnen verder verfijnen.

Aanvullende functies

De volgende tabel bevat aanvullende functies die worden ondersteund door het XmlDataSource besturingselement.

Vermogen	Beschrijving
Sorteervolgorde	Niet ondersteund door het XmlDataSource besturingselement.
Filteren	De XPath eigenschap kan worden gebruikt om de XML-gegevens te filteren met behulp van een geschikte XPath-expressie.
Paging	Niet ondersteund door het XmlDataSource besturingselement.
Bijwerken	Ondersteund door het XmlDataDocument rechtstreeks bewerken en vervolgens de Save methode aan te roepen.
Verwijderen	Ondersteund door het XmlDataDocument rechtstreeks bewerken en vervolgens de Save methode aan te roepen.
Invoegen	Ondersteund door het XmlDataDocument rechtstreeks bewerken en vervolgens de Save methode aan te roepen.
Caching	Standaard ingeschakeld, waarbij de CacheDuration eigenschap is ingesteld op 0 (oneindig) en de CacheExpirationPolicy eigenschap is ingesteld op Absolute.

Gegevensweergaveobject

Omdat het XmlDataSource besturingselement gegevensgebonden besturingselementen ondersteunt waarmee hiërarchische gegevens worden weergegeven en besturingselementen waarmee tabellaire gegevens worden weergegeven, ondersteunt het besturingselement voor gegevensbronnen meerdere typen weergaveobjecten voor gegevensbronnen op de onderliggende XML-gegevens. Het XmlDataSource besturingselement haalt één benoemd XmlDataSourceView object op wanneer dit wordt gebruikt met een gegevensgebonden besturingselement waarin tabelgegevens worden weergegeven. De GetViewNames methode identificeert deze enkelvoudige benoemde weergave. Wanneer het wordt gebruikt met een gegevensgebonden besturingselement dat hiërarchische gegevens weergeeft, haalt het XmlDataSource besturingselement een XmlHierarchicalDataSourceView op voor elk uniek hiërarchisch pad dat aan de GetHierarchicalView methode wordt doorgegeven.

Declaratieve syntaxis

<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>

Constructors

Name	Description
XmlDataSource()	Hiermee maakt u een nieuw exemplaar van de XmlDataSource klasse.

Eigenschappen

Name	Description
Adapter	Hiermee haalt u de browserspecifieke adapter voor het besturingselement op. (Overgenomen van Control)
AppRelativeTemplateSourceDirectory	Hiermee haalt u de toepassingsgerelateerde virtuele map op van het Page of UserControl object dat dit besturingselement bevat. (Overgenomen van Control)
BindingContainer	Hiermee haalt u het besturingselement op dat de gegevensbinding van dit besturingselement bevat. (Overgenomen van Control)
CacheDuration	Hiermee haalt u de tijdsduur in seconden op of stelt u deze in dat de gegevensbronbeheer gegevens in de cache opspoort die zijn opgehaald.
CacheExpirationPolicy	Hiermee wordt het verloopbeleid voor de cache opgehaald of ingesteld dat wordt gecombineerd met de cacheduur om het cachegedrag te beschrijven van de cache die door het gegevensbronbeheer wordt gebruikt.
CacheKeyContext	Hiermee haalt u de waarde van de cachesleutel voor het gegevensbronbeheer op uit de weergavestatus of voegt u de cachesleutel toe om de status weer te geven.
CacheKeyDependency	Hiermee haalt u een door de gebruiker gedefinieerde sleutelafhankelijkheid op die is gekoppeld aan alle gegevenscacheobjecten die zijn gemaakt door het gegevensbronbeheer. Alle cacheobjecten verlopen expliciet wanneer de sleutel verloopt.
ChildControlsCreated	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het serverbesturingselement zijn gemaakt. (Overgenomen van Control)
ClientID	Hiermee haalt u de serverbesturings-id op die is gegenereerd door ASP.NET. (Overgenomen van HierarchicalDataSourceControl)
ClientIDMode	Deze eigenschap wordt niet gebruikt voor besturingselementen voor gegevensbronnen. (Overgenomen van HierarchicalDataSourceControl)
ClientIDSeparator	Hiermee haalt u een tekenwaarde op die het scheidingsteken vertegenwoordigt dat in de ClientID eigenschap wordt gebruikt. (Overgenomen van Control)
Context	Hiermee wordt het HttpContext object opgehaald dat is gekoppeld aan het serverbeheer voor de huidige webaanvraag. (Overgenomen van Control)
Controls	Hiermee haalt u een ControlCollection object op dat de onderliggende besturingselementen vertegenwoordigt voor een opgegeven serverbesturingselement in de UI-hiërarchie. (Overgenomen van HierarchicalDataSourceControl)
Data	Hiermee wordt een blok XML-gegevens opgehaald of ingesteld waarmee het besturingselement voor gegevensbronnen wordt verbonden.
DataFile	Hiermee geeft u de bestandsnaam op van een XML-bestand waaraan de gegevensbron wordt gekoppeld.
DataItemContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataItemContainergeïmplementeerd. (Overgenomen van Control)
DataKeysContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataKeysControlgeïmplementeerd. (Overgenomen van Control)
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of een besturingselement wordt gebruikt op een ontwerpoppervlak. (Overgenomen van Control)
EnableCaching	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het XmlDataSource besturingselement gegevenscache heeft ingeschakeld.
EnableTheming	Hiermee wordt een waarde opgehaald die aangeeft of dit besturingselement thema's ondersteunt. (Overgenomen van HierarchicalDataSourceControl)
EnableViewState	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het serverbesturingselement de weergavestatus behoudt en de weergavestatus van onderliggende besturingselementen die het bevat, aan de aanvragende client. (Overgenomen van Control)
Events	Hiermee haalt u een lijst met gedelegeerden van de gebeurtenis-handler op voor het besturingselement. Deze eigenschap is alleen-lezen. (Overgenomen van Control)
HasChildViewState	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het huidige serverbesturingselement instellingen voor de weergavestatus hebben. (Overgenomen van Control)
ID	Hiermee wordt de programmatische id opgehaald of ingesteld die aan het serverbeheer is toegewezen. (Overgenomen van Control)
IdSeparator	Hiermee haalt u het teken op dat wordt gebruikt om besturings-id's te scheiden. (Overgenomen van Control)
IsChildControlStateCleared	Hiermee wordt een waarde opgehaald die aangeeft of besturingselementen in dit besturingselement de controlestatus hebben. (Overgenomen van Control)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het serverbeheer wijzigingen opslaat in de weergavestatus. (Overgenomen van Control)
IsViewStateEnabled	Hiermee wordt een waarde opgehaald die aangeeft of de weergavestatus is ingeschakeld voor dit besturingselement. (Overgenomen van Control)
LoadViewStateByID	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement deelneemt aan het laden van de weergavestatus door ID in plaats van index. (Overgenomen van Control)
NamingContainer	Hiermee wordt een verwijzing opgehaald naar de naamgevingscontainer van het serverbesturingselement, waarmee een unieke naamruimte wordt gemaakt voor het onderscheiden tussen serverbesturingselementen met dezelfde ID eigenschapswaarde. (Overgenomen van Control)
Page	Hiermee haalt u een verwijzing op naar het Page exemplaar dat het serverbeheer bevat. (Overgenomen van Control)
Parent	Hiermee haalt u een verwijzing op naar het bovenliggende besturingselement van het serverbeheer in de paginabeheerhiërarchie. (Overgenomen van Control)
RenderingCompatibility	Hiermee wordt een waarde opgehaald waarmee de ASP.NET versie wordt opgegeven waarmee HTML wordt weergegeven, compatibel is met. (Overgenomen van Control)
Site	Hiermee wordt informatie opgehaald over de container die als host fungeert voor het huidige besturingselement wanneer deze op een ontwerpoppervlak wordt weergegeven. (Overgenomen van Control)
SkinID	Hiermee wordt de huid op de HierarchicalDataSourceControl controle toegepast of ingesteld. (Overgenomen van HierarchicalDataSourceControl)
TemplateControl	Hiermee haalt u een verwijzing op naar de sjabloon die dit besturingselement bevat of stelt u deze in. (Overgenomen van Control)
TemplateSourceDirectory	Hiermee haalt u de virtuele map op van de Page server of UserControl die het huidige serverbeheer bevat. (Overgenomen van Control)
Transform	Hiermee wordt een blok XSL-gegevens (Extensible Stylesheet Language) opgehaald of ingesteld waarmee een XSLT-transformatie wordt gedefinieerd die moet worden uitgevoerd op de XML-gegevens die worden beheerd door het XmlDataSource besturingselement.
TransformArgumentList	Biedt een lijst met XSLT-argumenten die worden gebruikt met het opmaakmodel dat is gedefinieerd door de Transform of TransformFile eigenschappen om een transformatie uit te voeren op de XML-gegevens.
TransformFile	Hiermee geeft u de bestandsnaam van een XSL-bestand (Extensible Stylesheet Language) (.xsl) op dat een XSLT-transformatie definieert die moet worden uitgevoerd op de XML-gegevens die worden beheerd door het XmlDataSource besturingselement.
UniqueID	Hiermee haalt u de unieke, hiërarchisch gekwalificeerde id voor het serverbesturingselement op. (Overgenomen van Control)
ValidateRequestMode	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer vanuit de browser controleert op mogelijk gevaarlijke waarden. (Overgenomen van Control)
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een serverbeheer kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Control)
ViewStateIgnoresCase	Hiermee wordt een waarde opgehaald die aangeeft of het StateBag object niet hoofdlettergevoelig is. (Overgenomen van Control)
ViewStateMode	Hiermee haalt u de weergavestatusmodus van dit besturingselement op of stelt u deze in. (Overgenomen van Control)
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement visueel wordt weergegeven. (Overgenomen van HierarchicalDataSourceControl)
XPath	Hiermee geeft u een XPath-expressie op die moet worden toegepast op de XML-gegevens die zijn opgenomen in de Data eigenschap of door het XML-bestand dat wordt aangegeven door de DataFile eigenschap.

Methoden

Name	Description
AddedControl(Control, Int32)	Aangeroepen nadat een onderliggend besturingselement is toegevoegd aan de Controls verzameling van het Control object. (Overgenomen van Control)
AddParsedSubObject(Object)	Hiermee wordt het serverbesturingselement aangegeven dat een element, XML of HTML, is geparseerd en wordt het element toegevoegd aan het object van ControlCollection het serverbesturingselement. (Overgenomen van Control)
ApplyStyleSheetSkin(Page)	De stijleigenschappen die in het paginamodel zijn gedefinieerd, worden toegepast op het besturingselement. (Overgenomen van HierarchicalDataSourceControl)
BeginRenderTracing(TextWriter, Object)	Begint met het traceren van ontwerptijd van renderinggegevens. (Overgenomen van Control)
BuildProfileTree(String, Boolean)	Verzamelt informatie over het serverbesturingselement en levert deze aan de Trace eigenschap die moet worden weergegeven wanneer tracering is ingeschakeld voor de pagina. (Overgenomen van Control)
ClearCachedClientID()	Hiermee stelt u de waarde in de cache in ClientID op `null`. (Overgenomen van Control)
ClearChildControlState()	Hiermee verwijdert u de informatie over de controlestatus voor de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildState()	Hiermee verwijdert u de informatie over de weergavestatus en controlestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildViewState()	Hiermee verwijdert u de informatie over de weergavestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearEffectiveClientIDMode()	Hiermee stelt u de ClientIDMode eigenschap van het huidige besturingselementexemplaren en van alle onderliggende besturingselementen in op Inherit. (Overgenomen van Control)
CreateChildControls()	Wordt aangeroepen door het ASP.NET paginaframework om serverbesturingselementen op de hoogte te stellen die gebruikmaken van implementatie op basis van samenstelling om onderliggende besturingselementen te maken die ze bevatten ter voorbereiding op het terug plaatsen of weergeven. (Overgenomen van Control)
CreateControlCollection()	Hiermee maakt u een nieuw ControlCollection object voor het opslaan van de onderliggende besturingselementen (zowel letterlijk als server) van het serverbesturingselement. (Overgenomen van HierarchicalDataSourceControl)
DataBind()	Hiermee wordt een gegevensbron gekoppeld aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen. (Overgenomen van Control)
DataBind(Boolean)	Hiermee koppelt u een gegevensbron aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen met een optie om de DataBinding gebeurtenis te genereren. (Overgenomen van Control)
DataBindChildren()	Hiermee wordt een gegevensbron gekoppeld aan de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
Dispose()	Hiermee kan een serverbesturing definitief worden opgeschoond voordat deze uit het geheugen wordt vrijgegeven. (Overgenomen van Control)
EndRenderTracing(TextWriter, Object)	Hiermee wordt de ontwerptijd van het traceren van renderinggegevens beëindigd. (Overgenomen van Control)
EnsureChildControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. Als dat niet het geval is, worden onderliggende besturingselementen gemaakt. (Overgenomen van Control)
EnsureID()	Hiermee maakt u een id voor besturingselementen waaraan geen id is toegewezen. (Overgenomen van Control)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
FindControl(String, Int32)	Hiermee zoekt u in de huidige naamgevingscontainer naar een serverbeheer met het opgegeven en een geheel getal dat is opgegeven `id` in de `pathOffset` parameter, die de zoekopdracht helpt. U moet deze versie van de FindControl methode niet overschrijven. (Overgenomen van Control)
FindControl(String)	Zoekt in de huidige naamgevingscontainer naar een serverbeheer met de opgegeven `id` parameter. (Overgenomen van HierarchicalDataSourceControl)
Focus()	Hiermee stelt u de invoerfocus in op het besturingselement. (Overgenomen van HierarchicalDataSourceControl)
GetDesignModeState()	Hiermee haalt u ontwerptijdgegevens op voor een besturingselement. (Overgenomen van Control)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetHierarchicalView(String)	Hiermee haalt u het gegevensbronweergaveobject voor het XmlDataSource besturingselement op. De `viewPath` parameter kan een XPath-expressie zijn.
GetRouteUrl(Object)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(String, Object)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetRouteUrl(String, RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
GetUniqueIDRelativeTo(Control)	Retourneert het voorvoegselgedeelte van de UniqueID eigenschap van het opgegeven besturingselement. (Overgenomen van Control)
GetXmlDocument()	Laadt de XML-gegevens rechtstreeks vanuit de onderliggende gegevensopslag of vanuit de cache en retourneert deze in de vorm van een XmlDataDocument object.
HasControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. (Overgenomen van HierarchicalDataSourceControl)
HasEvents()	Retourneert een waarde die aangeeft of gebeurtenissen zijn geregistreerd voor het besturingselement of onderliggende besturingselementen. (Overgenomen van Control)
IsLiteralContent()	Bepaalt of het serverbeheer alleen letterlijke inhoud bevat. (Overgenomen van Control)
LoadControlState(Object)	Herstelt controlestatusgegevens van een vorige paginaaanvraag die door de SaveControlState() methode is opgeslagen. (Overgenomen van Control)
LoadViewState(Object)	Hiermee herstelt u informatie over de weergavestatus van een vorige paginaaanvraag die is opgeslagen door de SaveViewState() methode. (Overgenomen van Control)
MapPathSecure(String)	Hiermee haalt u het fysieke pad op waarnaar een virtueel pad, ofwel absoluut of relatief, wordt toegewezen. (Overgenomen van Control)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnBubbleEvent(Object, EventArgs)	Bepaalt of de gebeurtenis voor het serverbeheer wordt doorgegeven aan de hiërarchie van de ui-server van de pagina. (Overgenomen van Control)
OnDataBinding(EventArgs)	Hiermee wordt de DataBinding gebeurtenis gegenereerd. (Overgenomen van Control)
OnDataSourceChanged(EventArgs)	Hiermee wordt de DataSourceChanged gebeurtenis gegenereerd. (Overgenomen van HierarchicalDataSourceControl)
OnInit(EventArgs)	Hiermee wordt de Init gebeurtenis gegenereerd. (Overgenomen van Control)
OnLoad(EventArgs)	Hiermee wordt de Load gebeurtenis gegenereerd. (Overgenomen van Control)
OnPreRender(EventArgs)	Hiermee wordt de PreRender gebeurtenis gegenereerd. (Overgenomen van Control)
OnTransforming(EventArgs)	Hiermee wordt de Transforming gebeurtenis gegenereerd voordat het XmlDataSource besturingselement een XSLT-transformatie uitvoert op de XML-gegevens.
OnUnload(EventArgs)	Hiermee wordt de Unload gebeurtenis gegenereerd. (Overgenomen van Control)
OpenFile(String)	Hiermee wordt een Stream bestand gelezen. (Overgenomen van Control)
RaiseBubbleEvent(Object, EventArgs)	Wijst alle bronnen van de gebeurtenis en de bijbehorende informatie toe aan het bovenliggende besturingselement. (Overgenomen van Control)
RemovedControl(Control)	Aangeroepen nadat een onderliggend besturingselement is verwijderd uit de Controls verzameling van het Control object. (Overgenomen van Control)
Render(HtmlTextWriter)	Verzendt inhoud van serverbeheer naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven. (Overgenomen van Control)
RenderChildren(HtmlTextWriter)	Hiermee wordt de inhoud van de onderliggende elementen van een serverbeheer uitgevoerd naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven. (Overgenomen van Control)
RenderControl(HtmlTextWriter, ControlAdapter)	De server beheert inhoud naar een opgegeven HtmlTextWriter object met behulp van een opgegeven ControlAdapter object. (Overgenomen van Control)
RenderControl(HtmlTextWriter)	Hiermee wordt inhoud van de server naar een opgegeven HtmlTextWriter object uitgevoerd en wordt traceringsinformatie over het besturingselement opgeslagen als tracering is ingeschakeld. (Overgenomen van HierarchicalDataSourceControl)
ResolveAdapter()	Hiermee haalt u de besturingsadapter op die verantwoordelijk is voor het weergeven van het opgegeven besturingselement. (Overgenomen van Control)
ResolveClientUrl(String)	Hiermee haalt u een URL op die door de browser kan worden gebruikt. (Overgenomen van Control)
ResolveUrl(String)	Converteert een URL naar een URL die bruikbaar is voor de aanvragende client. (Overgenomen van Control)
Save()	Slaat de XML-gegevens op die momenteel in het geheugen zijn opgeslagen door het XmlDataSource besturingselement op schijf als de DataFile eigenschap is ingesteld.
SaveControlState()	Hiermee worden wijzigingen in de status van de servercontrole opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Control)
SaveViewState()	Hiermee worden wijzigingen in de weergavestatus van serverbeheer opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Control)
SetDesignModeState(IDictionary)	Hiermee stelt u ontwerptijdgegevens in voor een besturingselement. (Overgenomen van Control)
SetRenderMethodDelegate(RenderMethod)	Hiermee wijst u een gemachtigde van een gebeurtenishandler toe om het serverbeheer en de inhoud ervan weer te geven in het bovenliggende besturingselement. (Overgenomen van Control)
SetTraceData(Object, Object, Object)	Hiermee stelt u traceringsgegevens in voor het traceren van renderinggegevens in ontwerptijd, met behulp van het traceringsobject, de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
SetTraceData(Object, Object)	Hiermee stelt u traceringsgegevens in voor ontwerptijdtracering van renderinggegevens, met behulp van de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
TrackViewState()	Veroorzaakt het bijhouden van wijzigingen in de weergavestatus in het serverbesturingselement, zodat deze kunnen worden opgeslagen in het object van StateBag het serverbesturingselement. Dit object is toegankelijk via de ViewState eigenschap. (Overgenomen van Control)

gebeurtenis

Name	Description
DataBinding	Treedt op wanneer het serverbeheer wordt verbonden met een gegevensbron. (Overgenomen van Control)
Disposed	Treedt op wanneer een serverbesturing wordt vrijgegeven uit het geheugen. Dit is de laatste fase van de levenscyclus van serverbeheer wanneer een ASP.NET pagina wordt aangevraagd. (Overgenomen van Control)
Init	Treedt op wanneer het serverbeheer wordt geïnitialiseerd. Dit is de eerste stap in de levenscyclus. (Overgenomen van Control)
Load	Treedt op wanneer het serverbeheer in het Page object wordt geladen. (Overgenomen van Control)
PreRender	Vindt plaats nadat het object is geladen, maar voordat het Control wordt weergegeven. (Overgenomen van Control)
Transforming	Vindt plaats voordat het opmaakmodel dat is gedefinieerd door de Transform eigenschap of die door de TransformFile eigenschap wordt geïdentificeerd, wordt toegepast op XML-gegevens.
Unload	Treedt op wanneer het serverbeheer uit het geheugen wordt verwijderd. (Overgenomen van Control)

Expliciete interface-implementaties

Name	Description
IControlBuilderAccessor.ControlBuilder	Zie voor een beschrijving van dit lid ControlBuilder. (Overgenomen van Control)
IControlDesignerAccessor.GetDesignModeState()	Zie voor een beschrijving van dit lid GetDesignModeState(). (Overgenomen van Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Zie voor een beschrijving van dit lid SetDesignModeState(IDictionary). (Overgenomen van Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Zie voor een beschrijving van dit lid SetOwnerControl(Control). (Overgenomen van Control)
IControlDesignerAccessor.UserData	Zie voor een beschrijving van dit lid UserData. (Overgenomen van Control)
IDataBindingsAccessor.DataBindings	Zie voor een beschrijving van dit lid DataBindings. (Overgenomen van Control)
IDataBindingsAccessor.HasDataBindings	Zie voor een beschrijving van dit lid HasDataBindings. (Overgenomen van Control)
IDataSource.DataSourceChanged	Zie voor een beschrijving van dit lid DataSourceChanged.
IDataSource.GetView(String)	Hiermee haalt u de benoemde gegevensbronweergave op die is gekoppeld aan het besturingselement voor de gegevensbron.
IDataSource.GetViewNames()	Zie voor een beschrijving van dit lid GetViewNames().
IExpressionsAccessor.Expressions	Zie voor een beschrijving van dit lid Expressions. (Overgenomen van Control)
IExpressionsAccessor.HasExpressions	Zie voor een beschrijving van dit lid HasExpressions. (Overgenomen van Control)
IHierarchicalDataSource.DataSourceChanged	Treedt op wanneer de HierarchicalDataSourceControl wijziging op een bepaalde manier van invloed is op gegevensgebonden besturingselementen. (Overgenomen van HierarchicalDataSourceControl)
IHierarchicalDataSource.GetHierarchicalView(String)	Hiermee haalt u het helperobject voor de weergave op voor de IHierarchicalDataSource interface voor het opgegeven pad. (Overgenomen van HierarchicalDataSourceControl)
IListSource.ContainsListCollection	Zie voor een beschrijving van dit lid ContainsListCollection.
IListSource.GetList()	Zie voor een beschrijving van dit lid GetList().
IParserAccessor.AddParsedSubObject(Object)	Zie voor een beschrijving van dit lid AddParsedSubObject(Object). (Overgenomen van Control)

Extensiemethoden

Name	Description
FindDataSourceControl(Control)	Retourneert de gegevensbron die is gekoppeld aan het gegevensbeheer voor het opgegeven besturingselement.
FindFieldTemplate(Control, String)	Retourneert de veldsjabloon voor de opgegeven kolom in de naamgevingscontainer van het opgegeven besturingselement.
FindMetaTable(Control)	Retourneert het metatable-object voor het bevattende gegevensbeheer.
GetDefaultValues(IDataSource)	Hiermee haalt u de verzameling van de standaardwaarden voor de opgegeven gegevensbron op.
GetMetaTable(IDataSource)	Haalt de metagegevens op voor een tabel in het opgegeven gegevensbronobject.
TryGetMetaTable(IDataSource, MetaTable)	Bepaalt of tabelmetagegevens beschikbaar zijn.

Van toepassing op

Zie ook

GetViewNames()

Feedback

Is deze pagina nuttig?