HyperLinkColumn 클래스

참조

정의

네임스페이스:: System.Web.UI.WebControls

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

열의 각 항목에 대한 하이퍼링크를 포함하는 DataGrid 컨트롤의 열 형식입니다.

public ref class HyperLinkColumn : System::Web::UI::WebControls::DataGridColumn

public class HyperLinkColumn : System.Web.UI.WebControls.DataGridColumn

type HyperLinkColumn = class
    inherit DataGridColumn

Public Class HyperLinkColumn
Inherits DataGridColumn

상속: Object

DataGridColumn
HyperLinkColumn

예제

다음 예제에서는 만드는 방법을 보여 줍니다는 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="VB" 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">

      Function CreateDataSource() As ICollection 
      
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow
         Dim i As Integer

         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("PriceValue", GetType(Double)))
       
         For i = 0 to 2 
         
            dr = dt.NewRow()

            dr(0) = i
            dr(1) = CDbl(i) * 1.23

            dt.Rows.Add(dr)

         Next i

         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function

      Sub Page_Load(sender As Object, e As EventArgs) 
    
         MyDataGrid.DataSource = CreateDataSource()
         MyDataGrid.DataBind()

      End Sub

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

<%@ Page Language="VB" 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">
 
      Sub Page_Load(sender As Object, e As EventArgs) 
      
         Label1.Text = "You selected item: " & Request.QueryString("id")
      
      End Sub
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

설명

사용 하 여는 HyperLinkColumn 열의 형식에는 DataGrid 컨트롤의 각 행에 대 한 하이퍼링크를 만들려면는 DataGrid합니다. 설정 된 Text 하이퍼링크에 대 한 캡션 텍스트를 지정 하는 속성입니다. 하이퍼링크를 클릭할 때 링크할 URL을 지정 하려면 설정의 NavigateUrl 속성입니다.

참고

설정 하는 경우는 Text 및 NavigateUrl 속성을 모든 열의 하이퍼링크에에서 동일한 캡션 및 URL을 공유 합니다.

텍스트 캡션 및 있는 하이퍼링크의 URL을 바인딩할 수도 있습니다는 HyperLinkColumn 설정 하는 대신 데이터 원본의 필드에는 Text 및 NavigateUrl 속성입니다. 이렇게 하면 다른 캡션을 표시 하 고 열에서 각 하이퍼링크에 대해 다른 URL을 지정할 수 있습니다.

사용 된 DataTextField 열에 있는 하이퍼링크의 텍스트 캡션에 바인딩할 데이터 소스의 필드를 지정 하는 속성입니다.

참고

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

하이퍼링크의 URL을 설정 하 여 바인딩할 필드를 지정 합니다 DataNavigateUrlField 속성입니다.

참고

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

Target 속성을 사용 하면 창이 나 하이퍼링크를 클릭할 때 링크 되는 웹 페이지 콘텐츠를 표시 하는 프레임을 지정할 수 있습니다.

텍스트 캡션 및 하이퍼링크의 URL을 설정 하 여 서식을 지정할 수 있습니다 데이터 바인딩을 사용할 때의 DataTextFormatString 및 DataNavigateUrlFormatString 속성을 각각.

주의

악성 클라이언트 스크립트 포함 될 수 있는 사용자 입력을 표시 하려면이 제어를 사용할 수 있습니다. 애플리케이션에서 표시 하기 전에 실행 스크립트, SQL 문 또는 다른 코드에 대 한 클라이언트에서 전송 되는 모든 정보를 확인 합니다. 입력된 텍스트 컨트롤에 표시 하기 전에 사용자 입력을 확인 하려면 유효성 검사 컨트롤을 사용할 수 있습니다. ASP.NET에서는 사용자 입력에서 차단 스크립트를 HTML 입력된 요청 유효성 검사 기능을 제공 합니다. 자세한 내용은 표준 컨트롤 보호, 방법: 보호에 대 한 스크립트 악용 문자열을 HTML 인코딩 적용 하 여 웹 애플리케이션에서, 및 에서 사용자 입력 유효성 검사 ASP.NET 웹 페이지합니다.

생성자

HyperLinkColumn()

HyperLinkColumn 클래스의 새 인스턴스를 초기화합니다.

속성

DataNavigateUrlField	HyperLinkColumn에 있는 하이퍼링크의 URL에 바인딩할 데이터 소스의 필드를 가져오거나 설정합니다.
DataNavigateUrlFormatString	URL이 데이터 소스의 필드에 데이터 바인딩된 경우 HyperLinkColumn에 있는 하이퍼링크의 URL에 대한 표시 형식을 가져오거나 설정합니다.
DataTextField	HyperLinkColumn에 있는 하이퍼링크의 텍스트 캡션에 바인딩할 데이터 소스의 필드를 가져오거나 설정합니다.
DataTextFormatString	HyperLinkColumn 열에 있는 하이퍼링크의 텍스트 캡션에 대한 표시 형식을 가져오거나 설정합니다.
DesignMode	열이 디자인 모드인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataGridColumn)
FooterStyle	열의 바닥글 구역에 대한 스타일 속성을 가져옵니다. (다음에서 상속됨 DataGridColumn)
FooterText	열의 바닥글 구역에 표시할 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataGridColumn)
HeaderImageUrl	열의 머리글 구역에 표시할 이미지의 위치를 가져오거나 설정합니다. (다음에서 상속됨 DataGridColumn)
HeaderStyle	열의 머리글 구역에 대한 스타일 속성을 가져옵니다. (다음에서 상속됨 DataGridColumn)
HeaderText	열의 머리글 구역에 표시할 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataGridColumn)
IsTrackingViewState	DataGridColumn 개체가 상태를 저장하도록 표시되었는지 여부를 확인하는 값을 가져옵니다. (다음에서 상속됨 DataGridColumn)
ItemStyle	열의 항목 셀에 대한 스타일 속성을 가져옵니다. (다음에서 상속됨 DataGridColumn)
NavigateUrl	열의 하이퍼링크를 클릭할 때 링크되는 URL을 가져오거나 설정합니다.
Owner	열을 멤버로 갖는 DataGrid 컨트롤을 가져옵니다. (다음에서 상속됨 DataGridColumn)
SortExpression	정렬할 열을 선택한 경우 OnSortCommand(DataGridSortCommandEventArgs) 메서드에 전달할 필드 또는 식 이름을 가져오거나 설정합니다. (다음에서 상속됨 DataGridColumn)
Target	열의 하이퍼링크를 클릭할 때 링크되는 웹 페이지 내용을 표시할 대상 창이나 프레임을 가져오거나 설정합니다.
Text	열의 하이퍼링크에 대해 표시할 텍스트 캡션을 가져오거나 설정합니다.
ViewState	StateBag 클래스에서 파생된 열이 자신의 속성을 저장할 수 있게 하는 DataGridColumn 개체를 가져옵니다. (다음에서 상속됨 DataGridColumn)
Visible	DataGrid 컨트롤에서 열을 볼 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataGridColumn)

메서드

Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
FormatDataNavigateUrlValue(Object)	DataNavigateUrlFormatString 속성으로 지정한 형식을 사용하여 데이터 바인딩된 URL의 서식을 지정합니다.
FormatDataTextValue(Object)	DataTextFormatString 속성으로 지정한 형식을 사용하여 데이터 바인딩된 텍스트 캡션의 서식을 지정합니다.
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
Initialize()	DataGridColumn 클래스에서 파생된 열을 초기 상태로 다시 설정하는 기본 구현을 제공합니다.
InitializeCell(TableCell, Int32, ListItemType)	포함된 하이퍼링크를 사용하여 이 열을 나타내는 셀을 초기화합니다.
LoadViewState(Object)	DataGridColumn 개체의 상태를 로드합니다. (다음에서 상속됨 DataGridColumn)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnColumnChanged()	OnColumnsChanged() 메서드를 호출합니다. (다음에서 상속됨 DataGridColumn)
SaveViewState()	DataGridColumn 개체의 현재 상태를 저장합니다. (다음에서 상속됨 DataGridColumn)
ToString()	열의 문자열 표현을 반환합니다. (다음에서 상속됨 DataGridColumn)
TrackViewState()	서버 컨트롤의 뷰 상태 변경 사항 추적 작업을 실행하여 서버 컨트롤의 StateBag 개체에 변경 사항이 저장되도록 합니다. (다음에서 상속됨 DataGridColumn)

명시적 인터페이스 구현

IStateManager.IsTrackingViewState	열에서 뷰 상태 변경 내용을 추적하는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataGridColumn)
IStateManager.LoadViewState(Object)	이전에 저장된 상태를 로드합니다. (다음에서 상속됨 DataGridColumn)
IStateManager.SaveViewState()	상태 변경 사항이 포함된 개체를 반환합니다. (다음에서 상속됨 DataGridColumn)
IStateManager.TrackViewState()	상태 변경 사항 추적을 시작합니다. (다음에서 상속됨 DataGridColumn)

적용 대상

HyperLinkColumn 클래스

정의

예제

설명

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 정보

추가 리소스