Freigeben über

XmlDataSource.XPath Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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.

public:
 virtual property System::String ^ XPath { System::String ^ get(); void set(System::String ^ value); };
public virtual string XPath { get; set; }
member this.XPath : string with get, set
Public Overridable Property XPath As String

Eigenschaftswert

String

Eine Zeichenfolge, die einen XPath-Ausdruck darstellt, der verwendet werden kann, um die in der Data Eigenschaft enthaltenen Daten oder die durch die DataFile Eigenschaft angegebene XML-Datei zu filtern. Der Standardwert ist Empty.

Ausnahmen

InvalidOperationException

Das Dokument wird geladen.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung eines XmlDataSource Steuerelements mit vorlagenbasiertem Repeater Steuerelement zum Anzeigen von XML-Daten, die mithilfe eines XPath-Ausdrucks gefiltert wurden. In diesem Beispiel wird die XPath-Syntax verwendet, um die XML-Daten zu filtern, wenn die XPath Eigenschaft des Datenquellensteuerelements festgelegt ist, und bindet auch Elemente der Repeater Steuerelementvorlage an die XML-Daten.

<%@ 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="XmlSource"
        DataFile="bookstore.xml"
        runat="server"
        XPath="bookstore/genre[@name='fiction']"/>

      <asp:Repeater
        DataSourceID="XmlSource"
        runat="server">
          <ItemTemplate>
              <h1><%# XPath ("book/title") %></h1>
              <b>Price:</b>
              <%# XPath ("book/price") %>
          </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>ASP.NET Example</title>
</head>
<body>

    <form id="form1" runat="server">
      <asp:XmlDataSource
        id="XmlSource"
        DataFile="bookstore.xml"
        runat="server"
        XPath="bookstore/genre[@name='fiction']"/>

      <asp:Repeater
        DataSourceID="XmlSource"
        runat="server">
          <ItemTemplate>
              <h1><%# XPath ("book/title") %></h1>
              <b>Price:</b>
              <%# XPath ("book/price") %>
          </ItemTemplate>
      </asp:Repeater>
    </form>

  </body>
</html>

Die XML-Datei im Codebeispiel weist die folgenden Daten auf:

<bookstore>
   <genre name="fiction">
     <book ISBN="0000000000">
       <title>Secrets of Silicon Valley</title>
       <price>12.95</price>
       <chapters>
         <chapter num="1" name="Introduction" />
         <chapter num="2" name="Body" />
         <chapter num="3" name="Conclusion" />
       </chapters>
     </book>
   </genre>
   <genre name="novel">
     <book genre="novel" ISBN="1111111111">
       <title>Straight Talk About Computers</title>
       <price>24.95</price>
       <chapters>
         <chapter num="1" name="Introduction" />
         <chapter num="2" name="Body" />
         <chapter num="3" name="Conclusion" />
       </chapters>
     </book>
   </genre>
</bookstore>

Hinweise

Weitere Informationen zu XPath-Datenbindungsausdrücken finden Sie unter Binden eines tabellarischen Steuerelements an das XmlDataSource-Steuerelement.

Gilt für: