HyperLinkColumn Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Um tipo de coluna para o DataGrid controlo que contém um hiperlink para cada item da 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 seguinte demonstra como criar um HyperLinkColumn que liga para uma página separada.

Note

O exemplo de código seguinte utiliza o modelo de código de ficheiro único e pode não funcionar corretamente se for copiado diretamente para um ficheiro code-behind. Este exemplo de código deve ser copiado para um ficheiro de texto vazio que tenha uma extensão .aspx. Para mais informações sobre o modelo de código Web Forms, consulte ASP.NET Web Forms Page Code Model.

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

Observações

Use o HyperLinkColumn tipo de coluna num DataGrid controlo para criar um hiperlink para cada linha do DataGrid. Defina a Text propriedade para especificar o texto da legenda para o hiperlink. Para especificar a URL a que se deve ligar quando o hiperlink é clicado, defina a NavigateUrl propriedade.

Note

Se definires as Text propriedades e NavigateUrl , todos os hiperlinks na coluna partilharão a mesma legenda e URL.

Também podes associar a legenda de texto e o URL dos hiperlinks HyperLinkColumn num campo numa fonte de dados em vez de definir as Text propriedades e.NavigateUrl Isto permite-lhe mostrar uma legenda diferente e especificar um URL distinto para cada hiperligação na coluna.

Use a DataTextField propriedade para especificar um campo numa fonte de dados para se ligar à legenda de texto dos hiperlinks na coluna.

Note

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

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

Note

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

A Target propriedade permite-lhe especificar a janela ou frame para mostrar o conteúdo da página Web ligado quando o hiperlink é clicado.

Ao usar ligação de dados, pode formatar a legenda de texto e o URL do hiperlink definindo as DataTextFormatString propriedades e DataNavigateUrlFormatString respetivamente.

Caution

Este controlo pode ser usado para mostrar a entrada do utilizador, que pode incluir scripts de cliente maliciosos. Verifique qualquer informação enviada por um cliente para scripts executáveis, instruções SQL ou outro código antes de a exibir na sua aplicação. Pode usar controlos de validação para verificar a entrada do utilizador antes de mostrar o texto de entrada num controlo. ASP.NET fornece uma funcionalidade de validação de pedidos de entrada para bloquear scripts e HTML na entrada do utilizador. Para mais informações, veja Securing Standard Controls, How to: Protect Against Scripts Exploits numa Aplicação de Scripts Aplicando Codificação HTML a Strings, e Validating User Input in ASP.NET Web Pages.

Construtores

Name	Description
HyperLinkColumn()	Inicializa uma nova instância da HyperLinkColumn classe.

Propriedades

Name	Description
DataNavigateUrlField	Obtém ou define o campo de uma fonte de dados para se ligar à URL dos hiperlinks no HyperLinkColumn.
DataNavigateUrlFormatString	Obtém ou define o formato de visualização para a URL dos hiperlinks em quando HyperLinkColumn a URL está ligada a dados a um campo numa fonte de dados.
DataTextField	Obtém ou define o campo de uma fonte de dados para se ligar à 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 HyperLinkColumn coluna.
DesignMode	Recebe um valor que indica se a coluna está em modo de design. (Herdado de DataGridColumn)
FooterStyle	Obtém as propriedades de estilo para a secção de rodapé da coluna. (Herdado de DataGridColumn)
FooterText	Recebe ou define o texto apresentado na secção de rodapé da coluna. (Herdado de DataGridColumn)
HeaderImageUrl	Obtém ou define a localização de uma imagem para ser exibida na secção do cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderStyle	Obtém as propriedades de estilo para a secção do cabeçalho da coluna. (Herdado de DataGridColumn)
HeaderText	Recebe ou define o texto apresentado na secção de cabeçalho da coluna. (Herdado de DataGridColumn)
IsTrackingViewState	Obtém um valor que determina se o DataGridColumn objeto está marcado para guardar o seu estado. (Herdado de DataGridColumn)
ItemStyle	Obtém as propriedades de estilo das células do item da coluna. (Herdado de DataGridColumn)
NavigateUrl	Obtém ou define o URL para ligar quando um hiperlink na coluna é clicado.
Owner	Obtém o DataGrid controlo do qual a coluna pertence. (Herdado de DataGridColumn)
SortExpression	Recebe ou define o nome do campo ou expressão a passar ao OnSortCommand(DataGridSortCommandEventArgs) método quando uma coluna é selecionada para ordenação. (Herdado de DataGridColumn)
Target	Obtém ou define a janela ou frame alvo para mostrar o conteúdo da página Web ao qual está ligado quando o hiperlink na coluna é clicado.
Text	Obtém ou define a legenda do texto para mostrar os hiperlinks na coluna.
ViewState	Obtém o StateBag objeto que permite que uma coluna derivada da DataGridColumn classe armazene as suas propriedades. (Herdado de DataGridColumn)
Visible	Recebe ou define um valor que indica se a coluna é visível no DataGrid controlo. (Herdado de DataGridColumn)

Métodos

Name	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FormatDataNavigateUrlValue(Object)	Formata uma URL limitada a dados usando o formato especificado pela DataNavigateUrlFormatString propriedade.
FormatDataTextValue(Object)	Formata uma legenda de texto encadernada por dados usando o formato especificado pela DataTextFormatString propriedade.
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Initialize()	Fornece a implementação base para reiniciar uma coluna derivada da DataGridColumn classe para o seu estado inicial.
InitializeCell(TableCell, Int32, ListItemType)	Inicializa a célula que representa esta coluna com a ligação contida.
LoadViewState(Object)	Carrega o estado do DataGridColumn objeto. (Herdado de DataGridColumn)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnColumnChanged()	Chama o método OnColumnsChanged(). (Herdado de DataGridColumn)
SaveViewState()	Guarda o estado atual do DataGridColumn objeto. (Herdado de DataGridColumn)
ToString()	Devolve a representação da cadeia da coluna. (Herdado de DataGridColumn)
TrackViewState()	Causa o rastreio das alterações de estado de visualização no controlo do servidor para que possam ser armazenadas no objeto do StateBag controlo do servidor. (Herdado de DataGridColumn)

Implementações de Interface Explícita

Name	Description
IStateManager.IsTrackingViewState	Recebe um valor que indica se a coluna está a acompanhar alterações no estado da vista. (Herdado de DataGridColumn)
IStateManager.LoadViewState(Object)	Carrega o estado previamente guardado. (Herdado de DataGridColumn)
IStateManager.SaveViewState()	Devolve um objeto contendo alterações de estado. (Herdado de DataGridColumn)
IStateManager.TrackViewState()	Começa a acompanhar as alterações de estado. (Herdado de DataGridColumn)

Aplica-se a

Ver também

Comentários

Esta página foi útil?