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 модель кода веб-форм.

<%@ 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 Используйте свойство, чтобы указать поле в источнике данных для привязки к заголовку текста гиперссылок в столбце.

Замечание

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

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

Замечание

NavigateUrl Одновременно DataNavigateUrlField нельзя задать оба свойства. Если заданы оба свойства, 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 Класс

Определение

Примеры

Комментарии

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

Свойства

Методы

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

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

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