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


HyperLinkColumn Класс

Определение

Тип столбца для элемента управления 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
Наследование
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 чтобы указать поле в источнике данных для привязки к текстовому заголовку гиперссылок в столбце.

Примечание

Свойства 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)

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

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