HyperLinkField Classe
Definição
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.
Representa um campo exibido como um hiperlink em um controle de associação de dados.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlFieldpublic class HyperLinkField : System.Web.UI.WebControls.DataControlFieldtype HyperLinkField = class
inherit DataControlFieldPublic Class HyperLinkField
Inherits DataControlField- Herança
Exemplos
O exemplo de código a seguir demonstra como usar um HyperLinkField objeto para exibir uma coluna de hiperlinks estáticos em um GridView controle. Cada hiperlink no HyperLinkField objeto compartilha a mesma legenda e URL de navegação especificadas pelo e NavigateUrl pelas Text propriedades, respectivamente.
<%@ Page language="C#" %>
<!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 runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Set the HyperLinkField field column to a static -->
<!-- caption and URL. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="OrderID"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID"/>
<asp:boundfield datafield="OrderDate"
headertext="Order Date"
dataformatstring="{0:d}" />
<asp:hyperlinkfield text="Details..."
navigateurl="~\details.aspx"
headertext="Order Details"
target="_blank" />
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!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 runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- Set the HyperLinkField field column to a static -->
<!-- caption and URL. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="OrderID"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID"/>
<asp:boundfield datafield="OrderDate"
headertext="Order Date"
dataformatstring="{0:d}" />
<asp:hyperlinkfield text="Details..."
navigateurl="~\details.aspx"
headertext="Order Details"
target="_blank" />
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [CustomerID], [OrderDate] FROM [Orders]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
O exemplo de código a seguir demonstra como associar um HyperLinkField objeto a campos em uma fonte de dados. As DataTextField propriedades e DataNavigateUrlFields as propriedades são usadas para especificar os campos a serem associados à legenda e à URL de navegação, respectivamente, de cada hiperlink exibido no HyperLinkField objeto.
<%@ Page language="C#" %>
<!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 runat="server">
<title>HyperLinkField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- The UnitPrice field values are bound to the -->
<!-- captions of the hyperlinks in the HyperLinkField -->
<!-- field column, formatted as currency. The ProductID -->
<!-- field values are bound to the navigate URLs of the -->
<!-- hyperlinks. However, instead of being the actual -->
<!-- URL values, the product ID is passed to the linked -->
<!-- page as a parameter in the URL specified by the -->
<!-- DataNavigateUrlFormatString property. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="Order ID"/>
<asp:boundfield datafield="ProductID"
headertext="Product ID"/>
<asp:hyperlinkfield datatextfield="UnitPrice"
datatextformatstring="{0:c}"
datanavigateurlfields="ProductID"
datanavigateurlformatstring="~\details.aspx?ProductID={0}"
headertext="Price"
target="_blank" />
<asp:boundfield datafield="Quantity"
headertext="Quantity"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!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 runat="server">
<title>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>HyperLinkField DataTextFormatString and DataNavigateUrlFormatString Example</h3>
<!-- Populate the Columns collection declaratively. -->
<!-- The UnitPrice field values are bound to the -->
<!-- captions of the hyperlinks in the HyperLinkField -->
<!-- field column, formatted as currency. The ProductID -->
<!-- field values are bound to the navigate URLs of the -->
<!-- hyperlinks. However, instead of being the actual -->
<!-- URL values, the product ID is passed to the linked -->
<!-- page as a parameter in the URL specified by the -->
<!-- DataNavigateUrlFormatString property. -->
<asp:gridview id="OrdersGridView"
datasourceid="OrdersSqlDataSource"
autogeneratecolumns="false"
runat="server">
<columns>
<asp:boundfield datafield="OrderID"
headertext="Order ID"/>
<asp:boundfield datafield="ProductID"
headertext="Product ID"/>
<asp:hyperlinkfield datatextfield="UnitPrice"
datatextformatstring="{0:c}"
datanavigateurlfields="ProductID"
datanavigateurlformatstring="~\details.aspx?ProductID={0}"
headertext="Price"
target="_blank" />
<asp:boundfield datafield="Quantity"
headertext="Quantity"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. -->
<asp:sqldatasource id="OrdersSqlDataSource"
selectcommand="SELECT [OrderID], [ProductID], [UnitPrice], [Quantity] FROM [Order Details]"
connectionstring="server=localhost;database=northwind;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Comentários
A HyperLinkField classe é usada por controles associados a dados (como GridView e DetailsView) para exibir um hiperlink para cada registro exibido. Quando o usuário clica em um hiperlink, ele é direcionado para a página da Web associada ao hiperlink. O HyperLinkField objeto é exibido de forma diferente dependendo do controle associado a dados no qual ele é usado. Por exemplo, o GridView controle exibe um HyperLinkField objeto como uma coluna, enquanto o controle o DetailsView exibe como uma linha.
Para especificar a legenda a ser exibida para os hiperlinks, use a Text propriedade. Use a NavigateUrl propriedade para especificar a URL para navegar quando um hiperlink for clicado. Se você quiser exibir o conteúdo vinculado em uma janela ou quadro específico, defina a Target propriedade.
Observação
Quando as propriedades e NavigateUrl as Text propriedades são definidas, todos os hiperlinks no HyperLinkField objeto compartilham a mesma URL de legenda e navegação. Da mesma forma, a Target propriedade também se aplica a todos os hiperlinks.
Como alternativa, você pode associar o HyperLinkField objeto a campos em uma fonte de dados. Isso permite que você exiba uma legenda diferente para cada hiperlink no HyperLinkField objeto e faça com que cada hiperlink navegue até um local diferente. Para associar um campo a uma legenda, defina a DataTextField propriedade. Para criar uma URL para navegação, defina a DataNavigateUrlFields propriedade como uma lista separada por vírgulas de campos a serem usados para criar a URL.
Você pode especificar um formato personalizado para as legendas e URLs de navegação definindo as propriedades e DataNavigateUrlFormatString as DataTextFormatString propriedades, respectivamente.
Você pode ocultar um HyperLinkField objeto em um controle associado a dados definindo a Visible propriedade como false.
Você pode personalizar as seções de cabeçalho e rodapé de um HyperLinkField objeto. Para exibir uma legenda nas seções de cabeçalho ou rodapé, defina as propriedades ou FooterText as HeaderText propriedades, respectivamente. Para exibir uma imagem na seção de cabeçalho em vez de texto, defina a HeaderImageUrl propriedade. A seção de cabeçalho pode ser oculta no HyperLinkField objeto definindo a ShowHeader propriedade como false.
Observação
Alguns controles associados a dados (como o GridView controle) podem mostrar ou ocultar apenas toda a seção de cabeçalho do controle. Esses controles associados a dados não dão suporte à ShowHeader propriedade para um campo associado individual. Para mostrar ou ocultar toda a seção de cabeçalho de um controle associado a dados, use a propriedade do ShowHeader controle (se disponível).
Você também pode personalizar a aparência do objeto (cor da HyperLinkField fonte, cor da tela de fundo e assim por diante) definindo as propriedades de estilo para as diferentes partes do campo. A tabela a seguir lista as diferentes propriedades de estilo.
| Propriedade Style | Descrição |
|---|---|
| ControlStyle | As configurações de estilo para os controles filho do servidor Web do HyperLinkField objeto. |
| FooterStyle | As configurações de estilo para a seção de rodapé do HyperLinkField objeto. |
| HeaderStyle | As configurações de estilo para a seção de cabeçalho do HyperLinkField objeto. |
| ItemStyle | As configurações de estilo para os itens de dados no HyperLinkField objeto. |
Construtores
| HyperLinkField() |
Inicializa uma nova instância da classe HyperLinkField. |
Propriedades
| AccessibleHeaderText |
Obtém ou define o texto que é renderizado como o valor da propriedade |
| Control |
Obtém uma referência ao controle de dados ao qual o objeto DataControlField está associado. (Herdado de DataControlField) |
| ControlStyle |
Obtém o estilo de qualquer controle do servidor Web contido pelo objeto DataControlField. (Herdado de DataControlField) |
| DataNavigateUrlFields |
Obtém ou define os nomes dos campos da fonte de dados usada para construir as URLs dos hiperlinks no objeto HyperLinkField. |
| DataNavigateUrlFormatString |
Obtém ou define a cadeia de caracteres que especifica o formato no qual as URLs dos hiperlinks em um objeto HyperLinkField são renderizadas. |
| DataTextField |
Obtém ou define o nome do campo da fonte de dados que contém o texto a ser exibido nas legendas de hiperlink no objeto HyperLinkField. |
| DataTextFormatString |
Obtém ou define a cadeia de caracteres que especifica o formato no qual as legendas de hiperlink em um objeto HyperLinkField são exibidas. |
| DesignMode |
Obtém um valor que indica se um campo de controle de dados é atualmente exibido em um ambiente de tempo de design. (Herdado de DataControlField) |
| FooterStyle |
Obtém ou define o estilo do rodapé do campo de controle de dados. (Herdado de DataControlField) |
| FooterText |
Obtém ou define o texto exibido no item de rodapé de um campo de controle de dados. (Herdado de DataControlField) |
| HeaderImageUrl |
Obtém ou define a URL de uma imagem exibida no item de cabeçalho de um campo de controle de dados. (Herdado de DataControlField) |
| HeaderStyle |
Obtém ou define o estilo do cabeçalho do campo de controle de dados. (Herdado de DataControlField) |
| HeaderText |
Obtém ou define o texto exibido no item de cabeçalho de um campo de controle de dados. (Herdado de DataControlField) |
| InsertVisible |
Obtém um valor que indica se o objeto DataControlField fica visível quando o controle associado a dados pai está no modo de inserção. (Herdado de DataControlField) |
| IsTrackingViewState |
Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição. (Herdado de DataControlField) |
| ItemStyle |
Obtém o estilo de qualquer conteúdo baseado em texto exibido por um campo de controle de dados. (Herdado de DataControlField) |
| NavigateUrl |
Obtém ou define a URL para navegar quando se clica em um hiperlink em um objeto HyperLinkField. |
| ShowHeader |
Obtém ou define um valor que indica se o item de cabeçalho de um campo de controle de dados é renderizado. (Herdado de DataControlField) |
| SortExpression |
Obtém ou define uma expressão de classificação que é usada por um controle de fonte de dados para classificar os dados. (Herdado de DataControlField) |
| Target |
Obtém ou define a janela de destino ou quadro no qual exibir a página da Web vinculada quando um hiperlink em um objeto HyperLinkField é clicado. |
| Text |
Obtém ou define o texto a ser exibido para cada hiperlink no objeto HyperLinkField. |
| ValidateRequestMode |
Obtém ou define um valor que especifica se o controle valida a entrada do cliente. (Herdado de DataControlField) |
| ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um objeto DataControlField em várias solicitações da mesma página. (Herdado de DataControlField) |
| Visible |
Obtém ou define um valor que indica se um campo de controle de dados é renderizado. (Herdado de DataControlField) |
Métodos
| CloneField() |
Cria uma cópia duplicada do objeto atual derivado de DataControlField. (Herdado de DataControlField) |
| CopyProperties(DataControlField) |
Copia as propriedades do objeto HyperLinkField atual para o objeto especificado. |
| CreateField() |
Retorna uma nova instância da classe HyperLinkField. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Extrai o valor do campo de controle de dados da célula da tabela atual e adiciona o valor à coleção IDictionary especificada. (Herdado de DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Formata a URL de navegação usando a cadeia de caracteres de formato especificada pela propriedade DataNavigateUrlFormatString. |
| FormatDataTextValue(Object) |
Formata o texto de legenda usando a cadeia de caracteres de formato especificada 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(Boolean, Control) |
Inicializa o objeto HyperLinkField. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inicializa uma célula em um objeto HyperLinkField. |
| LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente da exibição de fonte de dados. (Herdado de DataControlField) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| OnFieldChanged() |
Aciona o evento |
| SaveViewState() |
Salva as alterações feitas no estado de exibição DataControlField desde a hora em que a página foi postada de volta no servidor. (Herdado de DataControlField) |
| ToString() |
Retorna uma cadeia de caracteres que representa este objeto DataControlField. (Herdado de DataControlField) |
| TrackViewState() |
Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página. (Herdado de DataControlField) |
| ValidateSupportsCallback() |
Indica que os controles contidos pelo objeto HyperLinkField são compatíveis com retornos de chamada. |
Implantações explícitas de interface
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Obtém ou define o esquema associado a este objeto DataControlField. (Herdado de DataControlField) |
| IStateManager.IsTrackingViewState |
Obtém um valor que indica se o objeto DataControlField está salvando alterações no estado de exibição. (Herdado de DataControlField) |
| IStateManager.LoadViewState(Object) |
Restaura o estado de exibição salvo anteriormente do campo de controle de dados. (Herdado de DataControlField) |
| IStateManager.SaveViewState() |
Salva as alterações feitas no estado de exibição DataControlField desde a hora em que a página foi postada de volta no servidor. (Herdado de DataControlField) |
| IStateManager.TrackViewState() |
Faz com que o objeto DataControlField controle as alterações em seu estado de exibição, de modo que elas possam ser armazenadas na propriedade ViewState do controle e persistidas entre solicitações para a mesma página. (Herdado de DataControlField) |