업데이트: 2007년 11월
이 컨트롤은 사용자가 클릭하여 다른 페이지로 이동할 수 있는 링크를 페이지에 만드는 데 사용합니다.
<asp:HyperLink
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
ImageUrl="uri"
href="uri"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Target="string|_blank|_parent|_search|_self|_top"
Text="string"
ToolTip="string"
Visible="True|False"
Width="size"
/>
설명
HyperLink 컨트롤을 사용하여 페이지의 특정 위치 또는 다른 페이지로 이동하는 링크를 만들 수 있습니다. href 속성을 사용하면 이동할 대상 페이지 또는 위치를 지정할 수 있습니다. 링크는 텍스트 또는 이미지로 표시할 수 있습니다. 텍스트를 표시하려면 Text 속성을 설정하거나, HyperLink 컨트롤의 여는 태그와 닫는 태그 사이에 텍스트를 추가합니다. 이미지를 표시하려면 ImageUrl 속성을 설정합니다.
참고
<asp:HyperLink> 요소에는 내용을 포함할 필요가 없으므로 별도의 닫는 태그 대신 />를 사용하여 태그를 닫을 수 있습니다.
Text 속성과 ImageUrl 속성을 모두 설정하면 ImageUrl 속성이 우선적으로 적용됩니다. 이미지를 사용할 수 없으면 Text 속성에 설정한 텍스트가 표시됩니다. 도구 설명 기능을 지원하는 브라우저에서는 마우스 포인터를 HyperLink 컨트롤 위에 놓으면 Text 속성의 값이 표시됩니다.
Target 속성을 설정하면 연결된 페이지를 표시할 프레임 또는 창을 지정할 수 있습니다. 이 값은 다음과 같이 밑줄로 시작하는 특수한 값을 제외하고는 대/소문자를 구분하여 a-z 사이의 문자로 시작해야 합니다.
_blank |
연결된 페이지를 프레임 없이 새 창에 표시합니다. |
_parent |
연결된 페이지를 바로 위 프레임셋 부모에 표시합니다. |
_self |
연결된 페이지를 포커스가 있는 프레임에 표시합니다. |
_top |
연결된 페이지를 프레임 없이 최대화된 창에 표시합니다. |
경고
텍스트는 HyperLink 컨트롤에 표시된 후에 HTML로 인코딩됩니다. 따라서 텍스트의 HTML 태그 내에 스크립트를 포함시킬 수 있습니다. 컨트롤 값을 사용자 입력에서 가져온 경우 값이 유효한지 확인하여 보안상의 허점을 방지합니다.
HyperLink 웹 서버 컨트롤의 속성과 이벤트에 대한 자세한 내용은 HyperLink 설명서를 참조하십시오.
HyperLink 웹 서버 컨트롤을 사용하여 응용 프로그램에서 여러 페이지 간을 탐색하는 경우 물결표("~") 와일드카드를 사용하면 디렉터리 이름을 응용 프로그램 상대 URL로 하드 코드하지 않고도 응용 프로그램 루트를 나타낼 수 있습니다. 예를 들어 응용 프로그램 하위 디렉터리의 모든 페이지에서 응용 프로그램의 Default.aspx 페이지를 다시 탐색하려는 경우 "~/Default.aspx"를 사용하면 됩니다.
예제
다음 예제에서는 HyperLink 컨트롤을 사용하여 다른 웹 페이지로 이동하는 방법을 보여 줍니다.
<%@ 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>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HyperLink Example</h3>
Click on the HyperLink:<br />
<asp:HyperLink id="hyperlink1"
ImageUrl="images/pict.jpg"
href="https://www.microsoft.com"
Text="Microsoft Official Site"
Target="_new"
runat="server"/>
</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>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HyperLink Example</h3>
Click on the HyperLink:<br />
<asp:HyperLink id="hyperlink1"
ImageUrl="images/pict.jpg"
href="https://www.microsoft.com"
Text="Microsoft Official Site"
Target="_new"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="JScript" 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>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>HyperLink Example</h3>
Click on the HyperLink:<br />
<asp:HyperLink id="hyperlink1"
ImageUrl="images/pict.jpg"
href="https://www.microsoft.com"
Text="Microsoft Official Site"
Target="_new"
runat="server"/>
</form>
</body>
</html>