XmlDataSource.XPath 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 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 zum Filtern der Daten verwendet werden kann, die in der Data-Eigenschaft oder in der durch die DataFile-Eigenschaft angegebenen XML-Datei enthalten sind. Der Standardwert ist Empty.

Ausnahmen

InvalidOperationException

Das Dokument wird geladen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie ein XmlDataSource Steuerelement mit einem steuerelement mit Vorlagen Repeater verwenden, um XML-Daten anzuzeigen, 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. Außerdem werden Elemente der Repeater Steuerelementvorlage an die XML-Daten gebunden.

<%@ 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 enthält die folgenden Daten:

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

Freigeben über