XmlDataSource.DataFile Eigenschaft
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.
Gibt den Dateinamen einer XML-Datei an, an die die Datenquelle gebunden ist.
public:
virtual property System::String ^ DataFile { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataFile { get; set; }
member this.DataFile : string with get, set
Public Overridable Property DataFile As String
Eigenschaftswert
Der absolute physische Pfad oder der relative Pfad der XML-Datei, die die vom XmlDataSource-Steuerelement dargestellten Daten enthält. Der Standardwert ist Empty.
Ausnahmen
Das Dokument wird geladen.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie sie ein XmlDataSource -Steuerelement verwenden, um xml-Daten anzuzeigen, die in einer Datei mit einem TreeView -Steuerelement enthalten sind.
<%@ 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>
Hinweise
Wenn sowohl die -Eigenschaft als auch die DataFile -Eigenschaft festgelegt sind, hat die DataFile -Eigenschaft Vorrang, und die Daten in der XML-Datei werden anstelle der in der Data -Eigenschaft angegebenen XML-Daten Data verwendet.
Wenn Sie den Wert der DataFile -Eigenschaft ändern, wird das DataSourceChanged -Ereignis ausgelöst. Wenn die Zwischenspeicherung aktiviert ist und Sie den Wert von DataFileändern, wird der Cache ungültig.