XPathBinder XPathBinder XPathBinder XPathBinder Class

Definizione

Offre supporto a strumenti di progettazione per lo sviluppo rapido di applicazioni (RAD) per l'analisi delle espressioni di associazione dati che usano espressioni XPath.Provides support for rapid application development (RAD) designers to parse data-binding expressions that use XPath expressions. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class XPathBinder sealed
public sealed class XPathBinder
type XPathBinder = class
Public NotInheritable Class XPathBinder
Ereditarietà
XPathBinderXPathBinderXPathBinderXPathBinder

Esempi

Esempio di codice seguente viene illustrato come utilizzare un XmlDataSource controllo con una basata su modelli Repeater controllo per visualizzare i dati XML.The following code example demonstrates how to use an XmlDataSource control with a templated Repeater control to display XML data. In questo esempio è costituito da due parti:This example has two parts:

  • Una pagina Web Form che consente di visualizzare i dati XML.A Web Forms page that displays XML data.

  • Un file XML che contiene i dati.An XML file that contains the data.

La prima parte dell'esempio mostra una pagina Web Form che visualizza i dati XML si accede tramite un XmlDataSource controllo.The first part of the example shows a Web Forms page that displays XML data accessed through an XmlDataSource control. Oggetto Repeater controlli utilizza semplificato Eval(Object, String) la sintassi del metodo da associare agli elementi di dati all'interno del XML del documento che la XmlDataSource rappresenta.A Repeater control uses simplified Eval(Object, String) method syntax to bind to data items within the XML document that the XmlDataSource represents. Usa il Select(Object, String) metodo per recuperare un' IEnumerable elencare e assegnarla come un'associazione tardiva DataSource proprietà per il Repeater controllo.It uses the Select(Object, String) method to retrieve an IEnumerable list and assign it as a late-bound DataSource property for the Repeater control.

<%@ 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>Order</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        XPath="orders/order"
        DataFile="order.xml" />

      <asp:Repeater ID="Repeater1"
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h2>Order</h2>
            <table>
              <tr>
                <td>Customer</td>
                <td><%#XPath("customer/@id")%></td>
                <td><%#XPath("customername/firstn")%></td>
                <td><%#XPath("customername/lastn")%></td>
              </tr>
              <tr>
                <td>Ship To</td>
                <td><%#XPath("shipaddress/address1")%></font></td>
                <td><%#XPath("shipaddress/city")%></td>
                <td><%#XPath("shipaddress/state")%>,
                    <%#XPath("shipaddress/zip")%></td>
              </tr>
            </table>
            <h3>Order Summary</h3>
            <asp:Repeater ID="Repeater2"
                 DataSource='<%#XPathSelect("summary/item")%>'
                 runat="server">
                <ItemTemplate>
                     <b><%#XPath("@dept")%></b> -
                         <%#XPath(".")%><br />
                </ItemTemplate>
            </asp:Repeater>
            <hr />
        </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>Order</title>
</head>
<body> 
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        XPath="orders/order"
        DataFile="order.xml" />

      <asp:Repeater ID="Repeater1"
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h2>Order</h2>
            <table>
              <tr>
                <td>Customer</td>
                <td><%#XPath("customer/@id")%></td>
                <td><%#XPath("customername/firstn")%></td>
                <td><%#XPath("customername/lastn")%></td>
              </tr>
              <tr>
                <td>Ship To</td>
                <td><%#XPath("shipaddress/address1")%></font></td>
                <td><%#XPath("shipaddress/city")%></td>
                <td><%#XPath("shipaddress/state")%>,
                    <%#XPath("shipaddress/zip")%></td>
              </tr>
            </table>
            <h3>Order Summary</h3>
            <asp:Repeater ID="Repeater2"
                 DataSource='<%#XPathSelect("summary/item")%>'
                 runat="server">
                <ItemTemplate>
                     <b><%#XPath("@dept")%></b> -
                         <%#XPath(".")%><br />
                </ItemTemplate>
            </asp:Repeater>
            <hr />
        </ItemTemplate>
    </asp:Repeater>

  </form>
  </body>
</html>

Nel secondo esempio viene fornito il file XML, Order. XML, che viene usato come precedentemente definito l'origine dei dati visualizzati nella pagina Web Form.The second example provides the XML file, Order.xml, that is used as the source of the data displayed in the Web Forms page defined above.

<?xml version="1.0" encoding="iso-8859-1"?>  
  <orders>  
    <order>  
      <customer id="12345" />  
      <customername>  
        <firstn>John</firstn>  
        <lastn>Doe</lastn>  
      </customername>  
      <transaction id="12345" />  
      <shipaddress>  
        <address1>1234 Tenth Avenue</address1>  
        <city>Bellevue</city>  
        <state>Washington</state>  
        <zip>98001</zip>  
      </shipaddress>  
      <summary>  
        <item dept="tools">screwdriver</item>  
        <item dept="tools">hammer</item>  
        <item dept="plumbing">fixture</item>  
      </summary>  
    </order>  
 </orders>  

Commenti

È possibile usare l'overload Eval metodo di questa classe da associare al risultato di un'espressione XPath eseguita su un oggetto che implementa le IXPathNavigable un'interfaccia, ad esempio un XmlNode.You can use the overloaded Eval method of this class to bind to the result of an XPath expression executed against an object that implements the IXPathNavigable interface, such as an XmlNode. È possibile usare la Select metodo per recuperare i risultati di un'espressione XPath eseguita su un IXPathNavigable dell'oggetto come un IEnumerable elenco di nodi.You can use the Select method to retrieve the results of an XPath expression executed against an IXPathNavigable object as an IEnumerable list of nodes. Questo elenco di nodi può essere enumerato direttamente o assegnato per il DataSource proprietà di un elenco di controllo, ad esempio un Repeater o DataList.This list of nodes can be enumerated directly or assigned to the DataSource property of a list control, such as a Repeater or DataList.

È possibile usare una versione semplificata della sintassi di associazione dati quando si usa il XPathBinder metodi in modo dichiarativo.You can use a simplified version of data-binding syntax when using the XPathBinder methods declaratively. Invece di chiamare XPathBinder.Eval(Container.DataItem, xpath) è possibile usare XPath(xpath).Instead of calling XPathBinder.Eval(Container.DataItem, xpath) you can use XPath(xpath). Analogamente, invece di chiamare XPathBinder.Select(Container.DataItem,xpath), è possibile usare XPathSelect(xpath) per recuperare un IEnumerable set di nodi.Similarly, instead of calling XPathBinder.Select(Container.DataItem,xpath), you can use XPathSelect(xpath) to retrieve an IEnumerable set of nodes. Quando si utilizza questa sintassi semplificata, la Eval e Select metodi presuppongono predefinito Container.DataItem oggetto di contesto.When using this simplified syntax, the Eval and Select methods assume a default Container.DataItem context object.

Per altre informazioni sull'associazione dati ai controlli server ASP.NET, vedere sintassi di espressione di associazione dati.For more information about data binding to ASP.NET server controls, see Data-Binding Expression Syntax.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Eval(Object, String) Eval(Object, String) Eval(Object, String) Eval(Object, String)

Valuta le espressioni di associazione dati XPath in fase di esecuzione.Evaluates XPath data-binding expressions at run time.

Eval(Object, String, IXmlNamespaceResolver) Eval(Object, String, IXmlNamespaceResolver) Eval(Object, String, IXmlNamespaceResolver) Eval(Object, String, IXmlNamespaceResolver)

Valuta le espressioni di data binding XPath in fase di esecuzione e formatta il risultato come testo da visualizzare nel browser richiedente usando l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi degli spazi dei nomi nell'espressione XPath.Evaluates XPath data-binding expressions at run time and formats the result as text to be displayed in the requesting browser, using the IXmlNamespaceResolver object specified to resolve namespace prefixes in the XPath expression.

Eval(Object, String, String) Eval(Object, String, String) Eval(Object, String, String) Eval(Object, String, String)

Valuta le espressioni di data binding XPath in fase di esecuzione e formatta il risultato come testo da visualizzare nel browser richiedente.Evaluates XPath data-binding expressions at run time and formats the result as text to be displayed in the requesting browser.

Eval(Object, String, String, IXmlNamespaceResolver) Eval(Object, String, String, IXmlNamespaceResolver) Eval(Object, String, String, IXmlNamespaceResolver) Eval(Object, String, String, IXmlNamespaceResolver)

Valuta le espressioni di data binding XPath in fase di esecuzione e formatta il risultato come testo da visualizzare nel browser richiedente usando l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi degli spazi dei nomi nell'espressione XPath.Evaluates XPath data-binding expressions at run time and formats the result as text to be displayed in the requesting browser, using the IXmlNamespaceResolver object specified to resolve namespace prefixes in the XPath expression.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
Select(Object, String) Select(Object, String) Select(Object, String) Select(Object, String)

Usa un'espressione di data binding XPath in fase di esecuzione per restituire un elenco di nodi.Uses an XPath data-binding expression at run time to return a list of nodes.

Select(Object, String, IXmlNamespaceResolver) Select(Object, String, IXmlNamespaceResolver) Select(Object, String, IXmlNamespaceResolver) Select(Object, String, IXmlNamespaceResolver)

Usa un'espressione di data binding XPath in fase di esecuzione per restituire un elenco di nodi, usando l'oggetto IXmlNamespaceResolver specificato per risolvere i prefissi degli spazi dei nomi nell'espressione XPath.Uses an XPath data-binding expression at run time to return a list of nodes, using the IXmlNamespaceResolver object specified to resolve namespace prefixes in the XPath expression.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a