HyperLinkColumn.DataTextField 속성

정의

HyperLinkColumn에 있는 하이퍼링크의 텍스트 캡션에 바인딩할 데이터 소스의 필드를 가져오거나 설정합니다.

public virtual string DataTextField { get; set; }

속성 값

HyperLinkColumn에 있는 하이퍼링크의 텍스트 캡션에 바인딩할 데이터 소스의 필드 이름입니다.

예제

다음 예제에서는 사용 하는 방법에 설명 합니다 DataTextField 속성에 있는 하이퍼링크의 텍스트 캡션에 바인딩할 데이터 소스의 필드를 지정 하는 HyperLinkColumn합니다.

참고

다음 코드 샘플 단일 파일 코드 모델을 사용 하 고 코드 숨김 파일에 직접 복사 하는 경우 제대로 작동 하지 않을 수 있습니다. 이 코드 샘플.aspx 확장명이 있는 빈 텍스트 파일에 복사 해야 합니다. Web Forms 코드 모델에 대 한 자세한 내용은 참조 하세요. ASP.NET Web Forms 페이지 코드 모델합니다.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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>
    <title>HyperLinkColumn Example</title>
<script runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("PriceValue", typeof(Double)));
       
         for (int i = 0; i < 3; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = (Double)i * 1.23;

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {
         MyDataGrid.DataSource = CreateDataSource();
         MyDataGrid.DataBind();
      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

다음 예제는 이전 예제에서 선택한 항목을 표시 합니다.

<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>
    <title>Details page for DataGrid</title>
<script runat="server">
 
      void Page_Load(Object sender, EventArgs e) 
      {
         Label1.Text = "You selected item: " + Request.QueryString["id"];
      }
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

설명

사용 된 DataTextField 에 있는 하이퍼링크의 텍스트 캡션에 바인딩할 데이터 소스의 필드 이름을 지정 하는 속성 HyperLinkColumn합니다. 텍스트 캡션을 데이터 필드에 바인딩된 경우 각 열의 하이퍼링크의 텍스트 캡션에 지정된 된 필드에 해당 값을 사용 하 여 설정 됩니다. 이 옵션을 사용 하면 열에 각 하이퍼링크에 대해 다른 텍스트 캡션을 설정할 수 있습니다. 각 행에 대해 동일한 텍스트 캡션 열에서을 지정 하려면 설정의 Text 이 속성 대신 합니다.

참고

합니다 DataTextFieldText 속성 동시에 설정할 수 없습니다. 두 속성을 설정 하는 경우는 DataTextField 속성이 우선 합니다.

경우 데이터 바인딩을 사용 하 여 사용자 지정할 수 있습니다 하이퍼링크의 텍스트 캡션에 대 한 사용자 지정 표시 형식을 설정 하 여는 DataTextFormatString 속성입니다.

적용 대상

제품 버전
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

추가 정보