다음을 통해 공유

HyperLinkField.Target 속성

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

개체의 하이퍼링크를 클릭할 때 연결된 웹 페이지를 표시할 대상 창 또는 프레임을 HyperLinkField 가져오거나 설정합니다.

public:
 virtual property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public virtual string Target { 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

하이퍼링크 HyperLinkField 를 클릭할 때 연결된 웹 페이지를 로드할 대상 창 또는 프레임입니다. 기본값은 이 속성이 설정되지 않음을 나타내는 빈 문자열("")입니다.

특성
TypeConverterAttribute

예제

다음 코드 예제에서는 개체의 Target 하이퍼링크 HyperLinkField 와 연결 된 웹 페이지의 내용을 표시 하는 대상 창을 지정 하는 속성을 사용 하는 방법을 보여 줍니다. 하이퍼링크를 클릭하면 연결된 웹 페이지가 새 창에 표시됩니다.


<%@ 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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </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>HyperLinkField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>HyperLinkField Example</h3>
                    
      <!-- Populate the Columns collection declaratively. -->
      <!-- Set the HyperLinkField field column to a static     -->
      <!-- caption and URL.                                    -->
      <asp:gridview id="OrdersGridView" 
        datasourceid="OrdersSqlDataSource" 
        autogeneratecolumns="false"
        runat="server">
                
        <columns>
                
          <asp:boundfield datafield="OrderID" 
            headertext="OrderID"/>
          <asp:boundfield datafield="CustomerID" 
            headertext="Customer ID"/>
          <asp:boundfield datafield="OrderDate" 
            headertext="Order Date"
            dataformatstring="{0:d}" />
          <asp:hyperlinkfield text="Details..."
            navigateurl="~\details.aspx"            
            headertext="Order Details"
            target="_blank" />
                
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects -->
      <!-- to the Northwind sample database.                   -->
      <asp:sqldatasource id="OrdersSqlDataSource"  
        selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
        connectionstring="server=localhost;database=northwind;integrated security=SSPI"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

설명

Target 하이퍼링크를 클릭할 때 하이퍼링크에 연결된 웹 콘텐츠를 표시할 창이나 프레임을 지정하려면 이 속성을 사용합니다.

값은 다음 표에 나열된 특수 값을 제외하고 A에서 Z(대/소문자를 구분하지 않는) 범위의 문자로 시작해야 합니다. 각 값은 밑줄로 시작합니다.

가치 설명
_blank 프레임 없이 새 창에서 콘텐츠를 렌더링합니다.
_parent 즉시 프레임 세트 부모에 콘텐츠를 렌더링합니다.
_search 검색 창에서 콘텐츠를 렌더링합니다.
_self 포커스를 사용하여 프레임의 콘텐츠를 렌더링합니다.
_top 프레임 없이 전체 창에서 콘텐츠를 렌더링합니다.

메모

브라우저 설명서를 확인하여 값이 _search 지원되는지 여부를 확인합니다. 예를 들어 Microsoft Internet Explorer 5.0 이상 버전은 대상 값을 지원 _search 합니다.

메모

속성 Target 이 특성으로 target 렌더링됩니다. target XHTML 1.1 문서 형식 정의에서는 요소의 특성 anchor 이 허용되지 않습니다. 개체에 Target 대해 HyperLinkField 렌더링된 출력이 XHTML 1.1 규격이어야 하는 경우 속성을 설정하지 마세요. 자세한 내용은 Visual Studio 및 ASP.NET XHTML 표준 항목을 참조하세요.

액세스 가능한 웹 페이지를 만들 때 속성을 사용하여 Target 다른 창을 대상으로 지정하지 않는 것이 좋습니다. 자세한 내용은 ASP.NET 접근성을 참조하세요.

적용 대상

추가 정보