XmlDataSource.DataFile Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Określa nazwę pliku XML, z którą jest powiązane źródło danych.

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

Wartość właściwości

String

Bezwzględna ścieżka fizyczna lub ścieżka względna pliku XML zawierającego dane reprezentowane przez kontrolkę XmlDataSource . Wartość domyślna to Empty.

Wyjątki

InvalidOperationException

Trwa ładowanie dokumentu.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać XmlDataSource kontrolki do wyświetlania danych XML zawartych w pliku z kontrolką TreeView .

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

Plik XML w przykładzie kodu zawiera następujące dane:

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

Uwagi

DataFile Jeśli właściwości i Data są ustawione, DataFile właściwość ma pierwszeństwo, a dane w pliku XML są używane zamiast danych XML określonych we Data właściwości .

Jeśli zmienisz wartość DataFile właściwości, DataSourceChanged zdarzenie zostanie zgłoszone. Jeśli buforowanie jest włączone i zmieniasz wartość DataFile, pamięć podręczna zostanie unieważniona.

Dotyczy

Share via