TemplateControl.XPath 메서드

정의

구문 분석 하 고 런타임에 개체에 대해 XPath 데이터 바인딩 식을 계산 하기 위한 지원을 제공 합니다.Provides support for parsing and evaluating an XPath data-binding expression against an object at run time.

오버로드

XPath(String, String, IXmlNamespaceResolver)

지정된 된 접두사 및 네임 스페이스 확인에 대 한 네임 스페이스 매핑 및 지정된 된 서식 문자열을 사용 하 여 결과 표시 하려면 XPath 데이터 바인딩 식을 계산 합니다.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.

XPath(String, IXmlNamespaceResolver)

네임 스페이스 확인을 위해 지정한 접두사와 네임 스페이스 매핑을 사용 하는 XPath 데이터 바인딩 식을 계산 합니다.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.

XPath(String)

XPath 데이터 바인딩 식을 계산합니다.Evaluates an XPath data-binding expression.

XPath(String, String)

지정된 된 서식 문자열을 사용 하 여 결과 표시 하려면 XPath 데이터 바인딩 식을 계산 합니다.Evaluates an XPath data-binding expression using the specified format string to display the result.

XPath(String, String, IXmlNamespaceResolver)

지정된 된 접두사 및 네임 스페이스 확인에 대 한 네임 스페이스 매핑 및 지정된 된 서식 문자열을 사용 하 여 결과 표시 하려면 XPath 데이터 바인딩 식을 계산 합니다.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution and the specified format string to display the result.

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

매개 변수

xPathExpression
String

평가할 XPath 식입니다.The XPath expression to evaluate. 자세한 내용은 XPathBinder을 참조하세요.For more information, see XPathBinder.

format
String

결과에 적용할.NET Framework 형식 문자열입니다.A .NET Framework format string to apply to the result.

resolver
IXmlNamespaceResolver

네임 스페이스 확인에 사용 되는 접두사 및 네임 스페이스 매핑 집합입니다.A set of prefix and namespace mappings used for namespace resolution.

반환

문자열 형식으로 변환 하 고 데이터 바인딩 식의 평가 결과로 생성 되는 문자열입니다.A string that results from the evaluation of the data-binding expression and conversion to a string type.

예외

데이터 바인딩 메서드는 Page에 포함된 컨트롤에만 사용할 수 있습니다.The data-binding method can be used only for controls contained on a Page.

설명

XPath 메서드는 GetDataItem 메서드를 사용 하 여 XPathBinder.Eval 메서드를 호출 하 여 식이 계산 되는 IXPathNavigable 개체 참조를 확인 합니다.The XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

추가 정보

XPath(String, IXmlNamespaceResolver)

네임 스페이스 확인을 위해 지정한 접두사와 네임 스페이스 매핑을 사용 하는 XPath 데이터 바인딩 식을 계산 합니다.Evaluates an XPath data-binding expression using the specified prefix and namespace mappings for namespace resolution.

protected public:
 System::Object ^ XPath(System::String ^ xPathExpression, System::Xml::IXmlNamespaceResolver ^ resolver);
protected internal object XPath (string xPathExpression, System.Xml.IXmlNamespaceResolver resolver);
member this.XPath : string * System.Xml.IXmlNamespaceResolver -> obj
Protected Friend Function XPath (xPathExpression As String, resolver As IXmlNamespaceResolver) As Object

매개 변수

xPathExpression
String

평가할 XPath 식입니다.The XPath expression to evaluate. 자세한 내용은 XPathBinder을 참조하세요.For more information, see XPathBinder.

resolver
IXmlNamespaceResolver

네임 스페이스 확인에 사용 되는 접두사 및 네임 스페이스 매핑 집합입니다.A set of prefix and namespace mappings used for namespace resolution.

반환

데이터 바인딩 식 계산한 결과로 생성 되는 개체입니다.An object that results from the evaluation of the data-binding expression.

예외

데이터 바인딩 메서드는 Page에 포함된 컨트롤에만 사용할 수 있습니다.The data-binding method can be used only for controls contained on a Page.

설명

XPath 메서드는 GetDataItem 메서드를 사용 하 여 XPathBinder.Eval 메서드를 호출 하 여 식이 계산 되는 IXPathNavigable 개체 참조를 확인 합니다.The XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

추가 정보

XPath(String)

XPath 데이터 바인딩 식을 계산합니다.Evaluates an XPath data-binding expression.

protected public:
 System::Object ^ XPath(System::String ^ xPathExpression);
protected internal object XPath (string xPathExpression);
member this.XPath : string -> obj
Protected Friend Function XPath (xPathExpression As String) As Object

매개 변수

xPathExpression
String

평가할 XPath 식입니다.The XPath expression to evaluate. 자세한 내용은 XPathBinder을 참조하세요.For more information, see XPathBinder.

반환

데이터 바인딩 식 계산한 결과로 생성 되는 개체입니다.An object that results from the evaluation of the data-binding expression.

예외

데이터 바인딩 메서드는 Page에 포함된 컨트롤에만 사용할 수 있습니다.The data-binding method can be used only for controls contained on a Page.

예제

다음 코드 예제에서는 Repeater 컨트롤에서 XPath 메서드를 사용 하는 방법을 보여 줍니다.The following code example demonstrates how to use the XPath method in a 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>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>

앞의 코드 예제에 테스트 XML 데이터를 사용할 수 있습니다.The following test XML data can be used in the preceding code example.

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

설명

XPath 메서드는 GetDataItem 메서드를 사용 하 여 XPathBinder.Eval 메서드를 호출 하 여 식이 계산 되는 IXPathNavigable 개체 참조를 확인 합니다.The XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

추가 정보

XPath(String, String)

지정된 된 서식 문자열을 사용 하 여 결과 표시 하려면 XPath 데이터 바인딩 식을 계산 합니다.Evaluates an XPath data-binding expression using the specified format string to display the result.

protected public:
 System::String ^ XPath(System::String ^ xPathExpression, System::String ^ format);
protected internal string XPath (string xPathExpression, string format);
member this.XPath : string * string -> string
Protected Friend Function XPath (xPathExpression As String, format As String) As String

매개 변수

xPathExpression
String

평가할 XPath 식입니다.The XPath expression to evaluate. 자세한 내용은 XPathBinder을 참조하세요.For more information, see XPathBinder.

format
String

결과에 적용할.NET Framework 형식 문자열입니다.A .NET Framework format string to apply to the result.

반환

문자열 형식으로 변환 하 고 데이터 바인딩 식의 평가 결과로 생성 되는 문자열입니다.A string that results from the evaluation of the data-binding expression and conversion to a string type.

예외

데이터 바인딩 메서드는 Page에 포함된 컨트롤에만 사용할 수 있습니다.The data-binding method can be used only for controls contained on a Page.

설명

XPath 메서드는 GetDataItem 메서드를 사용 하 여 XPathBinder.Eval 메서드를 호출 하 여 식이 계산 되는 IXPathNavigable 개체 참조를 확인 합니다.The XPath method calls the XPathBinder.Eval method using the GetDataItem method to resolve the IXPathNavigable object reference that the expression is evaluated against.

추가 정보

적용 대상