Декларативный синтаксис серверного веб-элемента управления Label

Статья
11/16/2008

Обновлен: Ноябрь 2007

Отображает статический текст на странице веб-формы и позволяет управлять им программными средствами.

<asp:Label
    AccessKey="string"
    AssociatedControlID="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"
    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"
    Text="string"
    ToolTip="string"
    Visible="True|False"
    Width="size"
/>

Заметки

Элемент управления Label используется для отображения текста в заданной области страницы. В отличие от статического текста, отображаемый текст можно настраивать с помощью установки свойства Text.

Внимание!
Отображаемый в элементе управления Label текст не преобразуется в формат HTML. Это позволяет внедрять в текст сценарий, заключенные в теги HTML. Если значения элемента управления вводятся пользователем, следует проверить их на допустимость, чтобы избежать появления уязвимых мест в системе безопасности.

Отображаемый в элементе управления Label текст не преобразуется в формат HTML. Это позволяет внедрять в текст сценарий, заключенные в теги HTML. Если значения элемента управления вводятся пользователем, следует проверить их на допустимость, чтобы избежать появления уязвимых мест в системе безопасности.

Подробные сведения о свойствах и событиях серверного веб-элемента управления Label см. в документации по классу Label.

Пример

Следующий пример демонстрирует способ создания элемента управления Label на странице.

Примечание.
В следующем примере кода используется однофайловая модель кода. Если скопировать его в файл кода программной части, он может работать неправильно. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением ASPX. Дополнительные сведения о модели кода веб-форм см. в разделе Модель кода веб-страниц ASP.NET.

В следующем примере кода используется однофайловая модель кода. Если скопировать его в файл кода программной части, он может работать неправильно. Этот пример кода необходимо скопировать в пустой текстовый файл с расширением ASPX. Дополнительные сведения о модели кода веб-форм см. в разделе Модель кода веб-страниц ASP.NET.

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

      Sub Button_Click(Sender As Object, e As EventArgs) 
         Label1.Text = Server.HtmlEncode(Text1.Text)
      End Sub

   </script>

</head>

<body>

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

      <h3>Label Example</h3>

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

      <p>

      <asp:TextBox id="Text1" 
           Text="Copy this text to the label"
           Width="200px"  
           runat="server" />

      <asp:Button id="Button1" 
           Text="Copy" 
           OnClick="Button_Click" 
           runat="server"/>
      </p>
   </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>Label Example</title>
<script language="C#" runat="server">

      void Button_Click(Object Sender, EventArgs e) 
      {
         Label1.Text = Server.HtmlEncode(Text1.Text);
      }

   </script>

</head>

<body>

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

      <h3>Label Example</h3>

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

      <p>

      <asp:TextBox id="Text1" 
           Text="Copy this text to the label"
           Width="200px"  
           runat="server" />

      <asp:Button id="Button1" 
           Text="Copy" 
           OnClick="Button_Click" 
           runat="server"/>
      </p>

   </form>

</body>
</html>

См. также

Ссылки

Label

Другие ресурсы

Синтаксис серверного веб-элемента управления

Поделиться через