Sdílet prostřednictvím

XmlDataSource.DataFile Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Určuje název souboru XML, ke kterému zdroj dat vytvoří vazbu.

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

Hodnota vlastnosti

String

Absolutní fyzická cesta nebo relativní cesta souboru XML obsahující data, která XmlDataSource ovládací prvek představuje. Výchozí hodnota je Empty.

Výjimky

InvalidOperationException

Dokument se načítá.

Příklady

Následující příklad kódu ukazuje použití XmlDataSource ovládacího prvku k zobrazení dat XML obsažených v souboru s ovládacím TreeView prvku.

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

Soubor XML v příkladu kódu obsahuje následující data:

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

Poznámky

Pokud jsou nastaveny obě vlastnosti DataFileData , DataFile má tato vlastnost přednost a data v souboru XML se používají místo dat XML zadaných Data ve vlastnosti.

Pokud změníte hodnotu DataFile vlastnosti, DataSourceChanged vyvolá se událost. Pokud je ukládání do mezipaměti povolené a změníte hodnotu DataFile, mezipaměť se zneplatní.

Platí pro

Viz také