XmlDataSource.XPath Eigenschap

Definitie

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

Hiermee geeft u een XPath-expressie op die moet worden toegepast op de XML-gegevens die zijn opgenomen in de Data eigenschap of door het XML-bestand dat wordt aangegeven door de DataFile eigenschap.

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

Waarde van eigenschap

String

Een tekenreeks die een XPath-expressie vertegenwoordigt die kan worden gebruikt om de gegevens te filteren die zijn opgenomen in de Data eigenschap of door het XML-bestand dat wordt aangegeven door de DataFile eigenschap. De standaardwaarde is Empty.

Uitzonderingen

InvalidOperationException

Het document wordt geladen.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een XmlDataSource besturingselement gebruikt met een sjabloonbesturingselement Repeater om XML-gegevens weer te geven die zijn gefilterd met behulp van een XPath-expressie. In dit voorbeeld wordt de XPath-syntaxis gebruikt om de XML-gegevens te filteren wanneer de XPath eigenschap van het besturingselement voor de gegevensbron is ingesteld en worden ook elementen van de Repeater besturingssjabloon gekoppeld aan de XML-gegevens.

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

Het XML-bestand in het codevoorbeeld bevat de volgende gegevens:

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

Opmerkingen

Zie Een tabellair besturingselement binden aan het XmlDataSource-besturingselement voor meer informatie over XPath-expressies voor gegevensbinding.

Van toepassing op