TemplateControl.XPathSelect Methode

Definition

Stellt die Datenbindung anhand XML-basierter Daten zur Laufzeit bereit und gibt eine Knotenauflistung zurück, die die IEnumerable-Schnittstelle implementiert.

Überlädt

XPathSelect(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus und gibt eine Knotenauflistung zurück, die die IEnumerable-Schnittstelle implementiert.

XPathSelect(String)

Wertet einen XPath-Datenbindungsausdruck aus und gibt eine Knotenauflistung zurück, die die IEnumerable-Schnittstelle implementiert.

XPathSelect(String, IXmlNamespaceResolver)

Wertet einen XPath-Datenbindungsausdruck mithilfe der angegebenen Präfix- und Namespacezuordnungen für die Namespaceauflösung aus und gibt eine Knotenauflistung zurück, die die IEnumerable-Schnittstelle implementiert.

protected public:
 System::Collections::IEnumerable ^ XPathSelect(System::String ^ xPathExpression, System::Xml::IXmlNamespaceResolver ^ resolver);
protected internal System.Collections.IEnumerable XPathSelect (string xPathExpression, System.Xml.IXmlNamespaceResolver resolver);
member this.XPathSelect : string * System.Xml.IXmlNamespaceResolver -> System.Collections.IEnumerable
Protected Friend Function XPathSelect (xPathExpression As String, resolver As IXmlNamespaceResolver) As IEnumerable

Parameter

xPathExpression
String

Der auszuwertende XPath-Ausdruck. Weitere Informationen finden Sie unter XPathBinder.

resolver
IXmlNamespaceResolver

Eine Gruppe von Präfix- und Namespacezuordnungen, die für die Namespaceauflösung verwendet werden.

Gibt zurück

Eine IEnumerable-Knotenliste.

Hinweise

Die XPathSelect -Methode ruft die XPathBinder.Select -Methode mithilfe der GetDataItem -Methode auf, um den IXPathNavigable Objektverweis aufzulösen, für den der Ausdruck ausgewertet wird.

Weitere Informationen

Gilt für:

XPathSelect(String)

Wertet einen XPath-Datenbindungsausdruck aus und gibt eine Knotenauflistung zurück, die die IEnumerable-Schnittstelle implementiert.

protected public:
 System::Collections::IEnumerable ^ XPathSelect(System::String ^ xPathExpression);
protected internal System.Collections.IEnumerable XPathSelect (string xPathExpression);
member this.XPathSelect : string -> System.Collections.IEnumerable
Protected Friend Function XPathSelect (xPathExpression As String) As IEnumerable

Parameter

xPathExpression
String

Der auszuwertende XPath-Ausdruck. Weitere Informationen finden Sie unter XPathBinder.

Gibt zurück

Eine IEnumerable-Knotenliste.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die XPathSelect -Methode in einem Repeater -Steuerelement verwendet wird.

<%@ 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>TemplateControl XPath and XPathSelect Example</title>
</head>
<body>
    <h3>TemplateControl XPath Example</h3>
    <form id="form1" runat="server">
    <div>
      <asp:XmlDataSource
        id="XmlDataSource1" 
        runat="server"
        XPath="contacts" 
        DataFile="contacts.xml" />    
      <asp:FormView 
        id="FormView1" 
        runat="server" 
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
          <hr />
          <asp:Repeater 
            id="Repeater1" 
            runat="server" 
            DataSource='<%# XPathSelect("contact") %>' >
            <ItemTemplate>
              Name: <%# XPath("name") %> <br />
              Note: <%# XPath("note") %> <br />
              <hr />
            </ItemTemplate>
          </asp:Repeater>
        </ItemTemplate>
      </asp:FormView>
    </div>
    </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 id="Head1" runat="server">
    <title>TemplateControl XPath Example</title>
</head>
<body>
    <h3>TemplateControl XPath and XPathSelect Example</h3>
    <form id="form1" runat="server">
    <div>
      <asp:XmlDataSource
        id="XmlDataSource1" 
        runat="server"
        XPath="contacts" 
        DataFile="contacts.xml" />    
      <asp:FormView 
        id="FormView1" 
        runat="server" 
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
          <hr />
          <asp:Repeater 
            id="Repeater1" 
            runat="server" 
            DataSource='<%# XPathSelect("contact") %>' >
            <ItemTemplate>
              Name: <%# XPath("name") %> <br />
              Note: <%# XPath("note") %> <br />
              <hr />
            </ItemTemplate>
          </asp:Repeater>
        </ItemTemplate>
      </asp:FormView>
    </div>
    </form>
</body>
</html>

Die folgenden XML-Testdaten können im vorherigen Codebeispiel verwendet werden.

<contacts>  
   <contact id="1">  
     <name>contact name 1</name>  
     <note>contact note 1</note>  
   </contact>  
   <contact id="2">  
     <name>contact name 2</name>  
     <note>contact note 2</note>  
   </contact>  
</contacts>  

Hinweise

Die XPathSelect -Methode ruft die XPathBinder.Select -Methode mithilfe der GetDataItem -Methode auf, um den IXPathNavigable Objektverweis aufzulösen, für den der Ausdruck ausgewertet wird.

Weitere Informationen

Gilt für: