HyperLinkColumn.Target 속성

참조

정의

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

어셈블리:: System.Web.dll

중요

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

열의 하이퍼링크를 클릭할 때 링크되는 웹 페이지 내용을 표시할 대상 창이나 프레임을 가져오거나 설정합니다.

public:
 virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };

public virtual string Target { get; set; }

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { get; set; }

member this.Target : string with get, set

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set

Public Overridable Property Target As String

속성 값

String

열의 하이퍼링크를 클릭할 때 링크되는 웹 페이지를 로드할 대상 창이나 프레임입니다. 기본값은 빈 문자열("")이며 이 경우 포커스가 있는 창이나 프레임이 새로 고쳐집니다.

특성: TypeConverterAttribute

예제

다음 예제에서는 사용 하는 방법에 설명 합니다 Target 열에서 하이퍼링크를 클릭할 때 웹 페이지의 콘텐츠를 표시할 기간을 지정 하는 속성에 연결 합니다. 이 예제에서는 새 창에서 연결된 된 웹 페이지를 표시 합니다.

참고

다음 코드 샘플 단일 파일 코드 모델을 사용 하 고 코드 숨김 파일에 직접 복사 하는 경우 제대로 작동 하지 않을 수 있습니다. 이 코드 샘플.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>

설명

사용 하 여는 Target 열에서 하이퍼링크를 클릭할 때 속성 프레임이 나 웹 페이지를 표시 하는 창 지정을 연결 합니다.

이 속성을 설정 하지 않으면, 브라우저 또는 포커스가 있는 창을 새로 고칩니다 열에서 하이퍼링크를 클릭할 때.

참고

합니다 Target 속성으로 렌더링 한 target 특성입니다. 합니다 target 특성을 anchor 요소 XHTML 1.1 문서 종류 정의에서 허용 되지 않습니다. 설정 하지 않으면 합니다 Target 속성 경우 렌더링된 된 출력에 대 한는 HyperLinkColumn XHTML 1.1 호환 되어야 합니다. 자세한 내용은 항목을 참조 XHTML 표준 Visual Studio 및 ASP.NET에입니다.

액세스할 수 있는 웹 페이지를 만들 때이 가장 좋습니다 사용 하지 마십시오는 Target 다른 창을 대상으로 하는 속성입니다. 자세한 내용은 ASP.NET 접근성을 참조하세요.

Target 값의 범위의 A ~ Z (대/소문자 구분), 다음과 같은 특수 값을 제외 하 고 밑줄로 시작 하는 문자로 시작 해야 합니다.

대상 값	Description
`_blank`	콘텐츠를 프레임이 없는 새 창에 렌더링합니다.
`_parent`	콘텐츠를 직접 실행 프레임셋 부모에 렌더링합니다.
`_search`	콘텐츠를 검색 창에 렌더링합니다.
`_self`	콘텐츠를 포커스가 있는 프레임에 렌더링합니다.
`_top`	콘텐츠를 프레임이 없는 전체 창에 렌더링합니다.

참고

_search 값이 지원되는지 여부를 확인하려면 브라우저 설명서를 참조하십시오. 예를 들어, Internet Explorer 5.0 이상을 지원 합니다 _search 대상 값입니다.

적용 대상

추가 정보

ASP.NET 웹 서버 컨트롤 및 브라우저 기능

다음을 통해 공유

HyperLinkColumn.Target 속성

정의

속성 값

예제

설명

적용 대상

추가 정보

추가 리소스