XmlDataSource Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine XML-Datenquelle für datengebundene Steuerelemente dar.
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- Vererbung
- Attribute
- Implementiert
Beispiele
Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie ein XmlDataSource Steuerelement mit einem TreeView Steuerelement verwendet wird, um XML-Daten aus der XML-Beispieldatei anzuzeigen. Im zweiten Beispiel wird veranschaulicht, wie ein XmlDataSource Steuerelement mit einem steuerelement mit Vorlagen zum Anzeigen von XML-Daten verwendet wird Repeater .
Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein XmlDataSource -Steuerelement mit einem TreeView -Steuerelement zum Anzeigen von XML-Daten verwenden. Lädt XmlDataSource XML-Daten aus der XML-Datei, die durch die DataFile -Eigenschaft identifiziert wird.
<%@ 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>
Die XML-Datei im Codebeispiel enthält die folgenden Daten:
<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>
Im folgenden Codebeispiel wird veranschaulicht, wie sie ein XmlDataSource Steuerelement mit einem Steuerelement mit Vorlagen Repeater zum Anzeigen von XML-Daten verwenden. Das Repeater Steuerelement verwendet einen XPath-Datenbindungsausdruck, um eine Bindung an Datenelemente innerhalb des XML-Dokuments zu erstellen, das das XmlDataSource darstellt. Weitere Informationen zur XPath Datenbindungssyntax und XPathSelect zur Datenbindungssyntax finden Sie in der XPathBinder -Klasse.
<%@ 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>
Die XML-Datei im Codebeispiel enthält die folgenden Daten:
<?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>
Hinweise
In diesem Thema:
Einführung
Das XmlDataSource -Steuerelement ist ein Datenquellensteuerelement, das XML-Daten datengebundenen Steuerelementen präsentiert. Das XmlDataSource -Steuerelement kann von datengebundenen Steuerelementen verwendet werden, um hierarchische und tabellarische Daten anzuzeigen. Das XmlDataSource -Steuerelement wird in der Regel verwendet, um hierarchische XML-Daten in schreibgeschützten Szenarien anzuzeigen. Da das XmlDataSource Steuerelement die HierarchicalDataSourceControl -Klasse erweitert, funktioniert es mit hierarchischen Daten. Das XmlDataSource -Steuerelement implementiert auch die IDataSource -Schnittstelle und arbeitet mit Tabellen- oder Listendaten.
Hinweis
Aus Sicherheitsgründen wird keine der XmlDataSource Steuerelementeigenschaften im Ansichtszustand gespeichert. Da es technisch möglich ist, den Inhalt des Ansichtszustands auf dem Client zu decodieren, könnte das Speichern vertraulicher Informationen über die Datenstruktur oder deren Inhalte Sie einer Bedrohung der Offenlegung von Informationen aussetzen. Wenn Sie Informationen wie XPath die Eigenschaft im Ansichtszustand speichern müssen, können Sie die Verschlüsselung aktivieren, um den Inhalt zu schützen, indem Sie die @ Page -Direktive festlegenViewStateEncryptionMode.
Seitenentwickler verwenden das XmlDataSource -Steuerelement, um XML-Daten mithilfe von datengebundenen Steuerelementen anzuzeigen.
Quellen von XML-Daten
Lädt XmlDataSource in der Regel XML-Daten aus einer XML-Datei, die durch die DataFile -Eigenschaft angegeben wird. XML-Daten können mithilfe der -Eigenschaft auch direkt vom Datenquellensteuerelement in Zeichenfolgenform Data gespeichert werden. Wenn Sie die XML-Daten transformieren möchten, bevor sie von einem datengebundenen Steuerelement angezeigt werden, können Sie ein XSL-Stylesheet (Extensible Stylesheet Language) für die Transformation bereitstellen. Wie bei den XML-Daten laden Sie in der Regel das Stylesheet aus einer Datei, die durch die TransformFile -Eigenschaft angegeben wird, aber Sie können es auch direkt mit der Transform -Eigenschaft in Zeichenfolgenform speichern.
Aktualisieren von XML-Daten
Das XmlDataSource Steuerelement wird häufig in schreibgeschützten Datenszenarien verwendet, in denen ein datengebundenes Steuerelement XML-Daten anzeigt. Sie können das XmlDataSource Steuerelement jedoch auch verwenden, um XML-Daten zu bearbeiten. Um die XML-Daten zu bearbeiten, rufen Sie die GetXmlDocument -Methode auf, um ein XmlDataDocument Objekt abzurufen, das eine Im-Arbeitsspeicher-Darstellung der XML-Daten ist. Sie können das Objektmodell verwenden, das von den XmlDataDocument darin enthaltenen Objekten und XmlNode verfügbar gemacht wird, oder einen XPath-Filterausdruck verwenden, um Daten im Dokument zu bearbeiten. Wenn Sie Änderungen an der Darstellung der XML-Daten im Arbeitsspeicher vorgenommen haben, können Sie sie auf dem Datenträger speichern, indem Sie die Save -Methode aufrufen.
Es gibt einige Einschränkungen für die Bearbeitungsfunktionen des Steuerelements XmlDataSource :
Die XML-Daten müssen aus einer XML-Datei geladen werden, die durch die DataFile -Eigenschaft angegeben ist, und nicht aus in der Data -Eigenschaft angegebenen Inline-XML.
In den Transform Eigenschaften oder TransformFile kann keine XSLT-Transformation angegeben werden.
Die Save -Methode verarbeitet keine gleichzeitigen Speichervorgänge durch unterschiedliche Anforderungen. Wenn mehrere Benutzer eine XML-Datei über XmlDataSourcebearbeiten, gibt es keine Garantie, dass alle Benutzer mit den gleichen Daten arbeiten. Es ist auch möglich, dass ein Save Vorgang aufgrund derselben Parallelitätsprobleme fehlschlägt.
Angeben einer XSL-Transformation
Ein allgemeiner Vorgang, der mit XML-Daten ausgeführt wird, ist die Transformation von einem XML-Dataset in ein anderes. Das XmlDataSource Steuerelement unterstützt XML-Transformationen mit den Transform Eigenschaften und, TransformFile die ein XSL-Stylesheet angeben, das auf XML-Daten angewendet werden soll, bevor es an ein datengebundenes Steuerelement übergeben wird, und die -Eigenschaft, mit der TransformArgumentList Sie dynamische XSLT-Stylesheetargumente bereitstellen können, die von einem XSL-Stylesheet während der Transformation verwendet werden. Wenn Sie einen XPath-Filterausdruck mithilfe der XPath -Eigenschaft angeben, wird er nach der Transformation angewendet.
Hinweis
Die XmlDataSource -Klasse verwendet die veraltete XslTransform Klasse, um XSL-Transformationen auszuführen. Wenn Sie Stylesheetfeatures verwenden möchten, die eingeführt wurden, nachdem die XslTransform Klasse veraltet wurde, wenden Sie die Transformationen manuell mithilfe der XslCompiledTransform -Klasse an.
Filtern mithilfe eines XPath-Ausdrucks
Standardmäßig lädt das XmlDataSource Steuerelement alle XML-Daten in der XML-Datei, die durch die DataFile -Eigenschaft identifiziert oder in der Data -Eigenschaft inline gefunden wurde. Sie können die Daten jedoch mithilfe eines XPath-Ausdrucks filtern. Die XPath -Eigenschaft unterstützt einen XPath-Syntaxfilter, der angewendet wird, nachdem XML-Daten geladen und transformiert wurden.
Zwischenspeicherung
Aus Leistungsgründen ist die Zwischenspeicherung für das XmlDataSource Steuerelement standardmäßig aktiviert. Das Öffnen und Lesen einer XML-Datei auf dem Server jedes Mal, wenn eine seite angefordert wird, kann die Leistung Ihrer Anwendung beeinträchtigen. Mit der Zwischenspeicherung können Sie die Verarbeitungslast auf Ihrem Server auf Kosten des Arbeitsspeichers auf dem Webserver reduzieren. in den meisten Fällen ist dies ein guter Kompromiss. Die XmlDataSource speichert Daten automatisch zwischen, wenn die EnableCaching -Eigenschaft auf truefestgelegt ist, und die CacheDuration -Eigenschaft auf die Anzahl von Sekunden festgelegt ist, die der Cache speichert, bevor der Cache ungültig wird. Sie können verwenden CacheExpirationPolicy , um das Zwischenspeicherungsverhalten des Datenquellensteuerelements weiter zu optimieren.
Zusätzliche Funktionen
In der folgenden Tabelle sind zusätzliche Features aufgeführt, die XmlDataSource vom Steuerelement unterstützt werden.
| Funktion | BESCHREIBUNG |
|---|---|
| Sortieren | Vom Steuerelement nicht unterstützt XmlDataSource . |
| Filtern | Die XPath -Eigenschaft kann verwendet werden, um die XML-Daten mithilfe eines entsprechenden XPath-Ausdrucks zu filtern. |
| Paging | Vom Steuerelement nicht unterstützt XmlDataSource . |
| Wird aktualisiert | Wird unterstützt, indem Sie die XmlDataDocument -Methode direkt bearbeiten und dann die Save -Methode aufrufen. |
| Wird gelöscht | Wird unterstützt, indem Sie die XmlDataDocument -Methode direkt bearbeiten und dann die Save -Methode aufrufen. |
| Einfügen | Wird unterstützt, indem Sie die XmlDataDocument -Methode direkt bearbeiten und dann die Save -Methode aufrufen. |
| Zwischenspeicherung | Standardmäßig aktiviert, wobei die CacheDuration -Eigenschaft auf 0 (unendlich) und die CacheExpirationPolicy -Eigenschaft auf festgelegt ist Absolute. |
Datenansichtsobjekt
Da das XmlDataSource Steuerelement datengebundene Steuerelemente unterstützt, die hierarchische Daten anzeigen, sowie Steuerelemente, die tabellarische Daten anzeigen, unterstützt das Datenquellensteuerelement mehrere Typen von Datenquellensichtobjekten für die zugrunde liegenden XML-Daten. Das XmlDataSource Steuerelement ruft ein einzelnes benanntes XmlDataSourceView Objekt ab, wenn es mit einem datengebundenen Steuerelement verwendet wird, das tabellarische Daten anzeigt. Die GetViewNames Methode identifiziert diese einzelne benannte Ansicht. Bei Verwendung mit einem datengebundenen Steuerelement, das hierarchische Daten anzeigt, ruft das XmlDataSource Steuerelement einen XmlHierarchicalDataSourceView für jeden eindeutigen hierarchischen Pfad ab, der an die GetHierarchicalView -Methode übergeben wird.
Deklarative 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>
Konstruktoren
| XmlDataSource() |
Erstellt eine neue Instanz der XmlDataSource-Klasse. |
Eigenschaften
| Adapter |
Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control) |
| AppRelativeTemplateSourceDirectory |
Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Geerbt von Control) |
| BindingContainer |
Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control) |
| CacheDuration |
Ruft die Zeitspanne in Sekunden ab, in der das Datenquellen-Steuerelement abgerufene Daten zwischenspeichert, oder legt diese fest. |
| CacheExpirationPolicy |
Ruft die Cacheablaufrichtlinie ab, die in Kombination mit der Cachedauer das Verhalten des vom Datenquellen-Steuerelement verwendeten Caches bei der Zwischenspeicherung beschreibt, oder legt diese fest. |
| CacheKeyContext |
Ruft den Wert des Cacheschlüssels für das Datenquellensteuerelement vom Ansichtszustand ab bzw. legt diesen fest oder fügt dem Ansichtszustand den Cacheschlüssel hinzu. |
| CacheKeyDependency |
Ruft eine benutzerdefinierte Schlüsselabhängigkeit ab, die mit sämtlichen vom Datenquellen-Steuerelement erstellten Datencacheobjekten verknüpft ist, oder legt diese Schlüsselabhängigkeit fest. Alle Cacheobjekte laufen explizit ab, wenn der Schlüssel abläuft. |
| ChildControlsCreated |
Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control) |
| ClientID |
Ruft den von ASP.NET generierten Bezeichner des Serversteuerelements ab. (Geerbt von HierarchicalDataSourceControl) |
| ClientIDMode |
Diese Eigenschaft wird nicht für Datenquellensteuerelemente verwendet. (Geerbt von HierarchicalDataSourceControl) |
| ClientIDSeparator |
Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Geerbt von Control) |
| Context |
Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Geerbt von Control) |
| Controls |
Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt. (Geerbt von HierarchicalDataSourceControl) |
| Data |
Ruft einen XML-Datenblock ab, an den das Datenquellen-Steuerelement gebunden ist, oder legt ihn fest. |
| DataFile |
Gibt den Dateinamen einer XML-Datei an, an die die Datenquelle gebunden ist. |
| DataItemContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Geerbt von Control) |
| DataKeysContainer |
Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Geerbt von Control) |
| DesignMode |
Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control) |
| EnableCaching |
Ruft einen Wert ab, der angibt, ob für das XmlDataSource-Steuerelement die Zwischenspeicherung von Daten aktiviert ist, oder legt diesen fest. |
| EnableTheming |
Ruft einen Wert ab, der angibt, ob Designs von diesem Objekt unterstützt werden. (Geerbt von HierarchicalDataSourceControl) |
| EnableViewState |
Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest. (Geerbt von Control) |
| Events |
Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control) |
| HasChildViewState |
Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Geerbt von Control) |
| ID |
Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control) |
| IdSeparator |
Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Geerbt von Control) |
| IsChildControlStateCleared |
Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Geerbt von Control) |
| IsTrackingViewState |
Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Geerbt von Control) |
| IsViewStateEnabled |
Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control) |
| LoadViewStateByID |
Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (Geerbt von Control) |
| NamingContainer |
Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann. (Geerbt von Control) |
| Page |
Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control) |
| Parent |
Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Geerbt von Control) |
| RenderingCompatibility |
Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Geerbt von Control) |
| Site |
Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control) |
| SkinID |
Ruft die Skin ab, die auf das HierarchicalDataSourceControl-Steuerelement angewendet werden soll, oder legt diese fest. (Geerbt von HierarchicalDataSourceControl) |
| TemplateControl |
Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Geerbt von Control) |
| TemplateSourceDirectory |
Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Geerbt von Control) |
| Transform |
Ruft einen Block von XSL-Daten (Extensible Stylesheet Language) ab, der eine XSLT-Transformation definiert, die für die vom XmlDataSource-Steuerelement verwalteten XML-Daten durchgeführt werden soll, bzw. legt diesen Block fest. |
| TransformArgumentList |
Stellt eine Liste von XSLT-Argumenten bereit, die mit dem durch die Transform-Eigenschaft oder die TransformFile-Eigenschaft definierten Stylesheet verwendet werden, um eine Transformation der XML-Daten durchzuführen. |
| TransformFile |
Gibt den Dateinamen einer XSL-Datei (Extensible Stylesheet Language) an, die eine XSLT-Transformation definiert, die für die vom XmlDataSource-Steuerelement verwalteten XML-Daten durchgeführt werden soll. |
| UniqueID |
Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control) |
| ValidateRequestMode |
Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft. (Geerbt von Control) |
| ViewState |
Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Control) |
| ViewStateIgnoresCase |
Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Geerbt von Control) |
| ViewStateMode |
Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Geerbt von Control) |
| Visible |
Ruft einen Wert ab, der angibt, ob das Steuerelement visuell dargestellt wird, oder legt diesen fest. (Geerbt von HierarchicalDataSourceControl) |
| XPath |
Gibt einen XPath-Ausdruck an, der auf die XML-Daten angewendet werden soll, die in der Data-Eigenschaft oder in der durch die DataFile-Eigenschaft angegebenen XML-Datei enthalten sind. |
Methoden
| AddedControl(Control, Int32) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Geerbt von Control) |
| AddParsedSubObject(Object) |
Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu. (Geerbt von Control) |
| ApplyStyleSheetSkin(Page) |
Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Geerbt von HierarchicalDataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Startet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| BuildProfileTree(String, Boolean) |
Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control) |
| ClearCachedClientID() |
Legt den zwischengespeicherten ClientID-Wert auf |
| ClearChildControlState() |
Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildState() |
Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearChildViewState() |
Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| ClearEffectiveClientIDMode() |
Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Geerbt von Control) |
| CreateChildControls() |
Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten. (Geerbt von Control) |
| CreateControlCollection() |
Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) des Serversteuerelements enthält. (Geerbt von HierarchicalDataSourceControl) |
| DataBind() |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control) |
| DataBind(Boolean) |
Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Geerbt von Control) |
| DataBindChildren() |
Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control) |
| Dispose() |
Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Geerbt von Control) |
| EndRenderTracing(TextWriter, Object) |
Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control) |
| EnsureChildControls() |
Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control) |
| EnsureID() |
Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Geerbt von Control) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| FindControl(String) |
Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen |
| Focus() |
Setzt den Eingabefokus auf das Steuerelement. (Geerbt von HierarchicalDataSourceControl) |
| GetDesignModeState() |
Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetHierarchicalView(String) |
Ruft das Datenquellen-Ansichtsobjekt für das XmlDataSource-Steuerelement ab. Der |
| GetRouteUrl(Object) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control) |
| GetRouteUrl(String, Object) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetUniqueIDRelativeTo(Control) |
Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control) |
| GetXmlDocument() |
Lädt die XML-Daten in den Speicher – entweder direkt aus dem zugrunde liegenden Datenspeicher oder aus dem Cache – und gibt sie als XmlDataDocument-Objekt zurück. |
| HasControls() |
Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von HierarchicalDataSourceControl) |
| HasEvents() |
Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Geerbt von Control) |
| IsLiteralContent() |
Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Geerbt von Control) |
| LoadControlState(Object) |
Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden. (Geerbt von Control) |
| LoadViewState(Object) |
Stellt die Informationen über den Ansichtszustand aus einer früheren Seitenanforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurden. (Geerbt von Control) |
| MapPathSecure(String) |
Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Geerbt von Control) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| OnBubbleEvent(Object, EventArgs) |
Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird. (Geerbt von Control) |
| OnDataBinding(EventArgs) |
Löst das DataBinding-Ereignis aus. (Geerbt von Control) |
| OnDataSourceChanged(EventArgs) |
Löst das DataSourceChanged-Ereignis aus. (Geerbt von HierarchicalDataSourceControl) |
| OnInit(EventArgs) |
Löst das Init-Ereignis aus. (Geerbt von Control) |
| OnLoad(EventArgs) |
Löst das Load-Ereignis aus. (Geerbt von Control) |
| OnPreRender(EventArgs) |
Löst das PreRender-Ereignis aus. (Geerbt von Control) |
| OnTransforming(EventArgs) |
Löst das Transforming-Ereignis aus, bevor das XmlDataSource-Steuerelement eine XSLT-Transformation für die XML-Daten ausführt. |
| OnUnload(EventArgs) |
Löst das Unload-Ereignis aus. (Geerbt von Control) |
| OpenFile(String) |
Ruft einen Stream zum Lesen einer Datei ab. (Geerbt von Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Geerbt von Control) |
| RemovedControl(Control) |
Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Geerbt von Control) |
| Render(HtmlTextWriter) |
Sendet den Inhalt des Steuerelements an ein angegebenes HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt. (Geerbt von Control) |
| RenderChildren(HtmlTextWriter) |
Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt. (Geerbt von Control) |
| RenderControl(HtmlTextWriter) |
Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Geerbt von HierarchicalDataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus. (Geerbt von Control) |
| ResolveAdapter() |
Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control) |
| ResolveClientUrl(String) |
Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control) |
| ResolveUrl(String) |
Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Geerbt von Control) |
| Save() |
Speichert die für das XmlDataSource-Steuerelement gegenwärtig im Speicher reservierten XML-Daten auf einem Datenträger, wenn die DataFile-Eigenschaft festgelegt ist. |
| SaveControlState() |
Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde. (Geerbt von Control) |
| SaveViewState() |
Speichert alle Ansichtszustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde. (Geerbt von Control) |
| SetDesignModeState(IDictionary) |
Legt die Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control) |
| SetRenderMethodDelegate(RenderMethod) |
Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Geerbt von Control) |
| SetTraceData(Object, Object) |
Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| SetTraceData(Object, Object, Object) |
Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| TrackViewState() |
Veranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können. Auf dieses Objekt kann über die ViewState-Eigenschaft zugegriffen werden. (Geerbt von Control) |
Ereignisse
| DataBinding |
Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Geerbt von Control) |
| Disposed |
Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite. (Geerbt von Control) |
| Init |
Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Geerbt von Control) |
| Load |
Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Geerbt von Control) |
| PreRender |
Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Geerbt von Control) |
| Transforming |
Tritt ein, bevor das Stylesheet, das durch die Transform-Eigenschaft definiert wird oder durch die TransformFile-Eigenschaft identifiziert wird, auf XML-Daten angewendet wird. |
| Unload |
Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Geerbt von Control) |
Explizite Schnittstellenimplementierungen
| IControlBuilderAccessor.ControlBuilder |
Eine Beschreibung dieses Elements finden Sie unter ControlBuilder. (Geerbt von Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState(). (Geerbt von Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control). (Geerbt von Control) |
| IControlDesignerAccessor.UserData |
Eine Beschreibung dieses Elements finden Sie unter UserData. (Geerbt von Control) |
| IDataBindingsAccessor.DataBindings |
Eine Beschreibung dieses Elements finden Sie unter DataBindings. (Geerbt von Control) |
| IDataBindingsAccessor.HasDataBindings |
Eine Beschreibung dieses Elements finden Sie unter HasDataBindings. (Geerbt von Control) |
| IDataSource.DataSourceChanged |
Eine Beschreibung dieses Elements finden Sie unter DataSourceChanged. |
| IDataSource.GetView(String) |
Ruft die benannte Datenquellenansicht ab, die dem Datenquellensteuerelement zugeordnet ist. |
| IDataSource.GetViewNames() |
Eine Beschreibung dieses Elements finden Sie unter GetViewNames(). |
| IExpressionsAccessor.Expressions |
Eine Beschreibung dieses Elements finden Sie unter Expressions. (Geerbt von Control) |
| IExpressionsAccessor.HasExpressions |
Eine Beschreibung dieses Elements finden Sie unter HasExpressions. (Geerbt von Control) |
| IHierarchicalDataSource.DataSourceChanged |
Tritt auf, wenn sich HierarchicalDataSourceControl so geändert hat, dass datengebundene Steuerelemente beeinflusst werden. (Geerbt von HierarchicalDataSourceControl) |
| IHierarchicalDataSource.GetHierarchicalView(String) |
Ruft das Sichthilfsobjekt für die IHierarchicalDataSource-Schnittstelle für den angegebenen Pfad ab. (Geerbt von HierarchicalDataSourceControl) |
| IListSource.ContainsListCollection |
Eine Beschreibung dieses Elements finden Sie unter ContainsListCollection. |
| IListSource.GetList() |
Eine Beschreibung dieses Elements finden Sie unter GetList(). |
| IParserAccessor.AddParsedSubObject(Object) |
Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object). (Geerbt von Control) |
Erweiterungsmethoden
| FindDataSourceControl(Control) |
Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. |
| FindFieldTemplate(Control, String) |
Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. |
| FindMetaTable(Control) |
Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. |
| GetDefaultValues(IDataSource) |
Ruft die Auflistung von Standardwerten für die angegebene Datenquelle ab. |
| GetMetaTable(IDataSource) |
Ruft die Metadaten für eine Tabelle im angegebenen Datenquellenobjekt ab. |
| TryGetMetaTable(IDataSource, MetaTable) |
Bestimmt, ob Tabellenmetadaten verfügbar sind. |
Gilt für:
Weitere Informationen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für