Share via

LinkButton 웹 서버 컨트롤 선언 구문

  • 아티클

업데이트: 2007년 11월

Web Forms 페이지에 하이퍼링크 스타일의 단추를 만드는 데 사용하는 컨트롤입니다.

<asp:LinkButton
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CommandArgument="string"
    CommandName="string"
    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"
    OnClick="Click event handler"
    OnClientClick="string"
    OnCommand="Command event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PostBackUrl="uri"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

설명

LinkButton 컨트롤을 사용하여 Web Forms 페이지에 하이퍼링크 스타일의 단추를 만들 수 있습니다. Text 속성을 설정하거나, LinkButton 컨트롤의 여는 태그와 닫는 태그 사이에 텍스트를 추가하여 LinkButton 컨트롤에 표시할 텍스트를 지정합니다. submit 단추나 command 단추를 만들 수도 있습니다.

참고

LinkButton 컨트롤은 HyperLink 컨트롤과 모양이 같지만 기능은 Button 컨트롤과 같습니다. 이 컨트롤을 클릭할 때 다른 웹 페이지로 연결되게 하려면 HyperLink 컨트롤을 사용합니다.

submit 단추에는 명령 이름이 연결되어 있지 않으며 이 단추를 클릭하면 단순히 웹 페이지가 서버에 다시 게시됩니다. 기본적으로 LinkButton 컨트롤은 submit 단추를 렌더링합니다. submit 단추를 클릭하는 경우 수행되는 작업을 프로그래밍 방식으로 제어하기 위해 Click 이벤트에 대한 이벤트 처리기를 제공할 수 있습니다.

CommandName 속성을 설정하여 명령 단추에 명령 이름(예: Sort)을 연결할 수 있습니다. 따라서 웹 페이지에 여러 개의 LinkButton 컨트롤을 만들고 어떤 LinkButton 컨트롤을 클릭했는지 프로그래밍 방식으로 확인할 수 있습니다. 명령 단추에 CommandArgument 속성을 사용하면 수행할 명령에 대한 추가 정보(예: Ascending)를 제공할 수도 있습니다. 명령 단추를 클릭하는 경우 수행되는 작업을 프로그래밍 방식으로 제어하기 위해 Command 이벤트에 대한 이벤트 처리기를 제공할 수 있습니다.

참고

LinkButton 컨트롤은 클라이언트 브라우저에서 JavaScript를 렌더링합니다. 이 컨트롤이 제대로 작동하려면 클라이언트 브라우저에서 JavaScript를 사용할 수 있어야 합니다. 클라이언트 스크립트에 대한 자세한 내용은 ASP.NET 웹 페이지의 클라이언트 스크립트를 참조하십시오. 기본적으로 LinkButton 컨트롤을 클릭하면 페이지 유효성 검사가 수행됩니다. 페이지 유효성 검사에서는 페이지에 있는 유효성 검사 컨트롤과 연결된 입력 컨트롤이 유효성 검사 컨트롤에서 지정한 유효성 검사 규칙을 통과하는지 여부를 확인합니다. reset 단추와 같이 이 동작을 비활성화해야 하는 LinkButton 컨트롤에 대해서는 CausesValidation 속성을 false로 설정합니다.

경고

텍스트는 LinkButton 컨트롤에 표시된 후에 HTML로 인코딩됩니다. 따라서 텍스트의 HTML 태그 내에 스크립트를 포함시킬 수 있습니다. 컨트롤 값을 사용자 입력에서 가져온 경우 값이 유효한지 확인하여 보안상의 허점을 방지합니다.

Command 단추(예: LinkButton 컨트롤)는 템플릿 기반 컨트롤에서 부모 컨트롤에 작업을 알리는 데 주로 사용됩니다. DataList에서 선택하거나 FormView에서 모드를 변경하는 경우를 예로 들 수 있습니다.

LinkButton 웹 서버 컨트롤의 속성과 이벤트에 대한 자세한 내용은 LinkButton 클래스 설명서를 참조하십시오.

예제

다음 예제에서는 LinkButton 컨트롤을 클릭하면 메시지가 표시되도록 컨트롤을 사용하는 방법을 보여 줍니다.

<%@ 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>LinkButton Example</title>
<script language="VB" runat="server">

      Sub LinkButton_Click(sender As Object, e As EventArgs) 
         Label1.Text = "You clicked the link button"
      End Sub

   </script>

</head>
<body>

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

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" 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>LinkButton Example</title>
<script language="C#" runat="server">

      void LinkButton_Click(Object sender, EventArgs e) 
      {
         Label1.Text="You clicked the link button";
      }

   </script>

</head>
<body>

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

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" 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>LinkButton Example</title>
<script language="JSCRIPT" runat="server">

      function LinkButton_Click(sender : Object, e : EventArgs){
         Label1.Text = "You clicked the link button"
      }

   </script>

</head>
<body>

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

      <h3>LinkButton Example</h3>

      <asp:LinkButton id="LinkButton1" 
           Text="Click Me" 
           Font-Names="Verdana" 
           Font-Size="14pt" 
           OnClick="LinkButton_Click" 
           runat="server"/>

      <br />

      <asp:Label id="Label1" runat="server" />

   </form>

</body>
</html>

참고 항목

참조

LinkButton

기타 리소스

웹 서버 컨트롤 구문