HyperLinkColumn Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Um tipo de coluna para o controle DataGrid que contém um hiperlink para cada item na coluna.

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

Herança: Object

DataGridColumn
HyperLinkColumn

Exemplos

O exemplo a seguir demonstra como criar um HyperLinkColumn links para uma página separada.

Observação

O exemplo de código a seguir usa o modelo de código de arquivo único e pode não funcionar corretamente se copiado diretamente em um arquivo code-behind. Este exemplo de código deve ser copiado em um arquivo de texto vazio que tenha uma extensão .aspx. Para obter mais informações sobre o modelo de código Web Forms, consulte ASP.NET Web Forms Modelo de Código de Página.

<%@ 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>

O exemplo correspondente a seguir exibe o item selecionado no exemplo anterior.

<%@ 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>

Comentários

Use o HyperLinkColumn tipo de coluna em um DataGrid controle para criar um hiperlink para cada linha no DataGrid. Defina a Text propriedade para especificar o texto da legenda para o hiperlink. Para especificar a URL à qual vincular quando o hiperlink for clicado, defina a NavigateUrl propriedade.

Observação

Se você definir o e NavigateUrl as Text propriedades, todos os hiperlinks na coluna compartilharão a mesma legenda e URL.

Você também pode associar a legenda de texto e a URL dos hiperlinks em HyperLinkColumn um campo em uma fonte de dados em vez de definir as propriedades e NavigateUrl as Text propriedades. Isso permite que você exiba uma legenda diferente e especifique uma URL diferente para cada hiperlink na coluna.

Use a DataTextField propriedade para especificar um campo em uma fonte de dados para associar à legenda de texto dos hiperlinks na coluna.

Observação

As DataTextField propriedades e Text as propriedades não podem ser definidas ao mesmo tempo. Se ambas as propriedades estiverem definidas, a DataTextField propriedade terá precedência.

Especifique o campo a ser associado à URL do hiperlink definindo a DataNavigateUrlField propriedade.

Observação

As DataNavigateUrlField propriedades e NavigateUrl as propriedades não podem ser definidas ao mesmo tempo. Se ambas as propriedades estiverem definidas, a DataNavigateUrlField propriedade terá precedência.

A Target propriedade permite que você especifique a janela ou o quadro para exibir o conteúdo da página da Web vinculado quando o hiperlink é clicado.

Ao usar a associação de dados, você pode formatar a legenda de texto e a URL do hiperlink definindo as propriedades e DataNavigateUrlFormatString as DataTextFormatString propriedades, respectivamente.

Cuidado

Esse controle pode ser usado para exibir a entrada do usuário, o que pode incluir script de cliente mal-intencionado. Verifique todas as informações enviadas de um cliente para script executável, instruções SQL ou outro código antes de exibi-lo em seu aplicativo. Você pode usar controles de validação para verificar a entrada do usuário antes de exibir o texto de entrada em um controle. ASP.NET fornece um recurso de validação de solicitação de entrada para bloquear script e HTML na entrada do usuário. Para obter mais informações, consulte Como proteger controles padrão, como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres e validando a entrada do usuário em Páginas da Web do ASP.NET.

Construtores

HyperLinkColumn()

Inicializa uma nova instância da classe HyperLinkColumn.

Propriedades

DataNavigateUrlField	Obtém ou define o campo de uma fonte de dados a ser associado à URL dos hiperlinks no HyperLinkColumn.
DataNavigateUrlFormatString	Obtém ou define o formato de exibição para a URL de hiperlinks em HyperLinkColumn quando a URL é limitada por dados para um campo em uma fonte de dados.
DataTextField	Obtém ou define o campo de uma fonte de dados a ser associado à legenda de texto dos hiperlinks no HyperLinkColumn.
DataTextFormatString	Obtém ou define o formato de exibição para a legenda de texto dos hiperlinks na coluna HyperLinkColumn.
DesignMode	Obtém um valor que indica se a coluna está no modo de design. (Herdado de DataGridColumn)
FooterStyle	Obtém as propriedades de estilo da seção de rodapé da coluna. (Herdado de DataGridColumn)
FooterText	Obtém ou define o texto exibido na seção de rodapé da coluna. (Herdado de DataGridColumn)
HeaderImageUrl	Obtém ou define o local de uma imagem a ser exibida na seção de cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderStyle	Obtém as propriedades de estilo para a seção de cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderText	Obtém ou define o texto exibido na seção de cabeçalho da coluna. (Herdado de DataGridColumn)
IsTrackingViewState	Obtém um valor que determina se o objeto DataGridColumn está marcado para salvar seu estado. (Herdado de DataGridColumn)
ItemStyle	Obtém as propriedades de estilo para as células do item da coluna. (Herdado de DataGridColumn)
NavigateUrl	Obtém ou define a URL à qual vincular quando se clica em um hiperlink na coluna.
Owner	Obtém o controle DataGrid do qual a coluna é membro. (Herdado de DataGridColumn)
SortExpression	Obtém ou define o nome do campo ou expressão a ser passado para o método OnSortCommand(DataGridSortCommandEventArgs) quando uma coluna for selecionada para classificação. (Herdado de DataGridColumn)
Target	Obtém ou define a janela ou o quadro destino para exibir o conteúdo da página da Web vinculada quando se clica no hiperlink na coluna.
Text	Obtém ou define o texto da legenda a ser exibido para os hiperlinks na coluna.
ViewState	Obtém o objeto StateBag que permite que uma coluna derivada da classe DataGridColumn armazene suas propriedades. (Herdado de DataGridColumn)
Visible	Obtém ou define um valor que indica se a coluna está visível no controle DataGrid. (Herdado de DataGridColumn)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FormatDataNavigateUrlValue(Object)	Formata uma URL com limite de dados usando o formato especificado pela propriedade DataNavigateUrlFormatString.
FormatDataTextValue(Object)	Formata uma legenda de texto com limite de dados usando o formato especificado pela propriedade DataTextFormatString.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Initialize()	Fornece a implementação base para redefinir uma coluna derivada da classe DataGridColumn para seu estado inicial.
InitializeCell(TableCell, Int32, ListItemType)	Inicializa a célula que representa essa coluna com o hiperlink independente.
LoadViewState(Object)	Carrega o estado do objeto DataGridColumn. (Herdado de DataGridColumn)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnColumnChanged()	Chama o método OnColumnsChanged(). (Herdado de DataGridColumn)
SaveViewState()	Salva o estado atual do objeto DataGridColumn. (Herdado de DataGridColumn)
ToString()	Retorna a representação de cadeia de caracteres da coluna. (Herdado de DataGridColumn)
TrackViewState()	Causa o acompanhamento das alterações de estado de exibição para o controle de servidor, para que elas possam ser armazenadas no objeto StateBag do controle de servidor. (Herdado de DataGridColumn)

Implantações explícitas de interface

IStateManager.IsTrackingViewState	Obtém um valor que indica se a coluna está controlando suas alterações de estado de exibição. (Herdado de DataGridColumn)
IStateManager.LoadViewState(Object)	Carrega o estado salvo anteriormente. (Herdado de DataGridColumn)
IStateManager.SaveViewState()	Retorna um objeto que contém as alterações de estado. (Herdado de DataGridColumn)
IStateManager.TrackViewState()	Inicia o controle de alterações de estado. (Herdado de DataGridColumn)

Aplica-se a

HyperLinkColumn Classe

Definição

Exemplos

Comentários

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Aplica-se a

Confira também

Recursos adicionais