HyperLink.Text Property

Definition

Возвращает или задает заголовок текста для элемента управления HyperLink.Gets or sets the text caption for the HyperLink control.

public:
 virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerDefaultProperty)]
public virtual string Text { get; set; }
member this.Text : string with get, set
Public Overridable Property Text As String

Property Value

String

Текстовая подпись для элемента управления HyperLink.The text caption for the HyperLink control. Значением по умолчанию является пустая строка ("").The default value is an empty string ("").

Attributes

Examples

В следующем примере показано использование свойства Text для указания текста, отображаемого для элемента управления HyperLink.The following example demonstrates how to use the Text property to specify the text to display for the HyperLink control.

<%@ 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 Sample</title>
</head>
<body>
<form id="Form1" runat="server">


    <h3>HyperLink Sample</h3>

    Click on the HyperLink:<br />  

    <asp:HyperLink id="hyperlink1" 
                   NavigateUrl="http://www.microsoft.com"
                   Text="Microsoft Official Site"
                   Target="_new"
                   runat="server"/>       
</form>
</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>HyperLink Sample</title>
</head>
<body>
<form id="Form1" runat="server">

    <h3>HyperLink Sample</h3>

    Click on the HyperLink:<br />  

    <asp:HyperLink id="hyperlink1" 
                   NavigateUrl="http://www.microsoft.com"
                   Text="Microsoft Official Site"
                   Target="_new"
                   runat="server"/>       

</form>
</body>
</html>

Remarks

Элемент управления HyperLink может отображаться как текст или изображение.The HyperLink control can be displayed as text or an image. Используйте свойство Text, чтобы указать текст, отображаемый для элемента управления HyperLink.Use the Text property to specify the text to display for the HyperLink control.

Если заданы свойства Text и ImageUrl, то свойство ImageUrl имеет приоритет.If both the Text and ImageUrl properties are set, the ImageUrl property takes precedence. Если изображение недоступно, отображается текст свойства Text.If the image is unavailable, the text in the Text property is displayed. В браузерах, поддерживающих функцию ToolTip, свойство Text также превращается в подсказку.In browsers that support ToolTip functionality, the Text property also becomes the ToolTip.

Caution

Этот элемент управления можно использовать для вывода вводимых пользователем данных, которые могут включать вредоносный клиентский скрипт.This control can be used to display user input, which might include malicious client script. Проверьте все данные, отправляемые клиентом для исполняемого скрипта, инструкций SQL или другого кода, прежде чем отображать его в приложении.Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. ASP.NET предоставляет функцию проверки входных запросов, которая блокирует скрипты и HTML-код при вводе данных пользователем.ASP.NET provides an input request validation feature to block script and HTML in user input. Также предоставляются проверочные элементы управления для оценки вводимых пользователем данных.Validation server controls are also provided to assess user input. Дополнительные сведения см. в разделе Проверка синтаксиса серверных элементов управления.For more information, see Validation Server Control Syntax.

Значение этого свойства, если оно задано, можно автоматически сохранить в файл ресурсов с помощью средства конструктора.The value of this property, when set, can be saved automatically to a resource file by using a designer tool. Дополнительные сведения см. в разделе LocalizableAttribute и Глобализация и локализация.For more information, see LocalizableAttribute and Globalization and Localization.

Applies to

See also