XmlDataSource.DataFile Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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

String

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

InvalidOperationException

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.

Gilt für: