HyperLinkColumn Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Тип столбца для элемента управления DataGrid, в котором содержится гиперссылка для каждого элемента столбца.

public ref class HyperLinkColumn : System::Web::UI::WebControls::DataGridColumn

public class HyperLinkColumn : System.Web.UI.WebControls.DataGridColumn

type HyperLinkColumn = class
    inherit DataGridColumn

Public Class HyperLinkColumn
Inherits DataGridColumn

Наследование: Object

DataGridColumn
HyperLinkColumn

Примеры

В следующем примере показано, как создать HyperLinkColumn объект , который ссылается на отдельную страницу.

Примечание

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

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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>HyperLinkColumn Example</title>
<script runat="server">

      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;

         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("PriceValue", typeof(Double)));
       
         for (int i = 0; i < 3; i++) 
         {
            dr = dt.NewRow();

            dr[0] = i;
            dr[1] = (Double)i * 1.23;

            dt.Rows.Add(dr);
         }

         DataView dv = new DataView(dt);
         return dv;
      }

      void Page_Load(Object sender, EventArgs e) 
      {
         MyDataGrid.DataSource = CreateDataSource();
         MyDataGrid.DataBind();
      }

   </script>

</head>

<body>

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

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!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>HyperLinkColumn Example</title>
<script runat="server">

      Function CreateDataSource() As ICollection 
      
         Dim dt As DataTable = New DataTable()
         Dim dr As DataRow
         Dim i As Integer

         dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
         dt.Columns.Add(New DataColumn("PriceValue", GetType(Double)))
       
         For i = 0 to 2 
         
            dr = dt.NewRow()

            dr(0) = i
            dr(1) = CDbl(i) * 1.23

            dt.Rows.Add(dr)

         Next i

         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function

      Sub Page_Load(sender As Object, e As EventArgs) 
    
         MyDataGrid.DataSource = CreateDataSource()
         MyDataGrid.DataBind()

      End Sub

   </script>

</head>

<body>

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

      <h3>HyperLinkColumn Example</h3>

      <asp:DataGrid id="MyDataGrid" 
           BorderColor="black"
           BorderWidth="1"
           GridLines="Both"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#aaaadd"/>

         <Columns>

            <asp:HyperLinkColumn
                 HeaderText="Select an Item"
                 DataNavigateUrlField="IntegerValue"
                 DataNavigateUrlFormatString="detailspage.aspx?id={0}"
                 DataTextField="PriceValue"
                 DataTextFormatString="{0:c}"
                 Target="_blank"/>
           
         </Columns>

      </asp:DataGrid>

   </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>Details page for DataGrid</title>
<script runat="server">
 
      void Page_Load(Object sender, EventArgs e) 
      {
         Label1.Text = "You selected item: " + Request.QueryString["id"];
      }
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</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>Details page for DataGrid</title>
<script runat="server">
 
      Sub Page_Load(sender As Object, e As EventArgs) 
      
         Label1.Text = "You selected item: " & Request.QueryString("id")
      
      End Sub
 
   </script>
 
</head>
<body>
 
   <h3>Details page for DataGrid</h3>
 
   <asp:Label id="Label1"
        runat="server"/>
 
</body>
</html>

Используйте тип столбца HyperLinkColumn в элементе DataGrid управления , чтобы создать гиперссылку для каждой DataGridстроки в . Text Задайте свойство , чтобы указать текст заголовка для гиперссылки. Чтобы указать URL-адрес, на который будет ссылаться ссылка при щелчке гиперссылки NavigateUrl , задайте свойство .

Примечание

Если задать Text свойства и NavigateUrl , все гиперссылки в столбце будут использовать один и тот же заголовок и URL-адрес.

Кроме того, можно привязать текстовый заголовок и URL-адрес гиперссылок к HyperLinkColumn полю в источнике данных, а не задавать Text свойства и NavigateUrl . Это позволяет отображать разные заголовки и указывать разные URL-адреса для каждой гиперссылки в столбце.

Используйте свойство , DataTextField чтобы указать поле в источнике данных для привязки к текстовому заголовку гиперссылок в столбце.

Примечание

Свойства DataTextField и Text нельзя задать одновременно. Если заданы оба свойства, DataTextField свойство имеет приоритет.

Укажите поле для привязки к URL-адресу гиперссылки, задав DataNavigateUrlField свойство .

Примечание

Свойства DataNavigateUrlField и NavigateUrl нельзя задать одновременно. Если заданы оба свойства, DataNavigateUrlField свойство имеет приоритет.

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

При использовании привязки данных можно отформатировать заголовок текста и URL-адрес гиперссылки, задав DataTextFormatString свойства и DataNavigateUrlFormatString соответственно.

Внимание!

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

Конструкторы

HyperLinkColumn()

Инициализирует новый экземпляр класса HyperLinkColumn.

Свойства

DataNavigateUrlField	Получает или задает поле источника данных, которое необходимо привязать к URL-адресам гиперссылок в элементе управления HyperLinkColumn.
DataNavigateUrlFormatString	Получает или задает формат отображения URL-адресов гиперссылок в элемент управления HyperLinkColumn, если URL-адрес привязан к данным поля источника данных.
DataTextField	Получает или задает поле источника данных, к которому необходимо привязать текстовую подпись гиперссылок в элементе управления HyperLinkColumn.
DataTextFormatString	Получает или задает формат отображения текстовой подписи гиперссылок в столбце HyperLinkColumn.
DesignMode	Возвращает значение, показывающее, находится ли столбец в режиме конструктора. (Унаследовано от DataGridColumn)
FooterStyle	Возвращает свойства стиля для раздела нижнего колонтитула столбца. (Унаследовано от DataGridColumn)
FooterText	Получает или задает текст, отображаемый в разделе нижнего колонтитула столбца. (Унаследовано от DataGridColumn)
HeaderImageUrl	Получает или задает размещение изображения, отображаемого в разделе нижнего колонтитула столбца. (Унаследовано от DataGridColumn)
HeaderStyle	Возвращает свойства стиля для раздела верхнего колонтитула столбца. (Унаследовано от DataGridColumn)
HeaderText	Получает или задает текст, отображаемый в разделе верхнего колонтитула столбца. (Унаследовано от DataGridColumn)
IsTrackingViewState	Возвращает значение, которое определяет, отмечается ли объект DataGridColumn, чтобы сохранить его состояние. (Унаследовано от DataGridColumn)
ItemStyle	Возвращает свойства стиля для ячеек столбца. (Унаследовано от DataGridColumn)
NavigateUrl	Получает или задает URL-адрес для перехода при выборе гиперссылки в столбце.
Owner	Возвращает элемент управления DataGrid, в который входит данный столбец. (Унаследовано от DataGridColumn)
SortExpression	Получает или задает имя поля или выражения, передаваемого методу OnSortCommand(DataGridSortCommandEventArgs), когда столбец выбран для сортировки. (Унаследовано от DataGridColumn)
Target	Получает или задает целевое окно или фрейм для отображения содержимого веб-страницы, на которую осуществляется переход при выборе гиперссылки в столбце.
Text	Получает или задает текстовую подпись, отображаемую для гиперссылок в столбце.
ViewState	Возвращает объект StateBag, что позволяет столбцу, полученному из класса DataGridColumn, сохранять свои свойства. (Унаследовано от DataGridColumn)
Visible	Получает или задает значение, показывающее, является ли столбец видимым в элементе управления DataGrid. (Унаследовано от DataGridColumn)

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FormatDataNavigateUrlValue(Object)	Форматирует URL-адрес с привязкой к данным, используя формат, заданный свойством DataNavigateUrlFormatString.
FormatDataTextValue(Object)	Форматирует текстовую подпись с привязкой к данным с использованием формата, заданного свойством DataTextFormatString.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
Initialize()	Предоставляет базовую реализацию для сброса столбца, полученного из класса DataGridColumn, в исходное состояние.
InitializeCell(TableCell, Int32, ListItemType)	Инициализирует ячейку, представляющую этот столбец содержащейся в ней гиперссылкой.
LoadViewState(Object)	Загружает состояние объекта DataGridColumn. (Унаследовано от DataGridColumn)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnColumnChanged()	Вызывает метод OnColumnsChanged(). (Унаследовано от DataGridColumn)
SaveViewState()	Сохраняет текущее состояние объекта DataGridColumn. (Унаследовано от DataGridColumn)
ToString()	Возвращает строковое представление столбца. (Унаследовано от DataGridColumn)
TrackViewState()	Вызывает отслеживание изменений состояния представления серверного элемента управления для сохранения в объекте StateBag серверного элемента управления. (Унаследовано от DataGridColumn)

Явные реализации интерфейса

IStateManager.IsTrackingViewState	Возвращает значение, указывающее, отслеживает ли столбец изменения состояния представления. (Унаследовано от DataGridColumn)
IStateManager.LoadViewState(Object)	Загружает сохраненное ранее состояние. (Унаследовано от DataGridColumn)
IStateManager.SaveViewState()	Возвращает объект, содержащий данные об изменении состояния. (Унаследовано от DataGridColumn)
IStateManager.TrackViewState()	Запускает отслеживание изменений состояния. (Унаследовано от DataGridColumn)

Применяется к

HyperLinkColumn Класс

Определение

Примеры

Комментарии

Конструкторы

Свойства

Методы

Явные реализации интерфейса

Применяется к

См. также раздел

Обратная связь

Дополнительные ресурсы