HyperLinkField Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un campo que se muestra como un hipervínculo en un control enlazado a datos.
public ref class HyperLinkField : System::Web::UI::WebControls::DataControlFieldpublic class HyperLinkField : System.Web.UI.WebControls.DataControlFieldtype HyperLinkField = class
inherit DataControlFieldPublic Class HyperLinkField
Inherits DataControlField- Herencia
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar un HyperLinkField objeto para mostrar una columna de hipervínculos estáticos en un GridView control . Cada hipervínculo del HyperLinkField objeto comparte el mismo título y dirección URL de navegación especificado por las Text propiedades y NavigateUrl , 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>
En el ejemplo de código siguiente se muestra cómo enlazar un HyperLinkField objeto a campos de un origen de datos. Las DataTextField propiedades y DataNavigateUrlFields se usan para especificar los campos que se van a enlazar al título y a la dirección URL de navegación, respectivamente, de cada hipervínculo que se muestra en el 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>
Comentarios
Los controles enlazados a datos (como GridView y DetailsView) usan la HyperLinkField clase para mostrar un hipervínculo para cada registro mostrado. Cuando el usuario hace clic en un hipervínculo, se le dirige a la página web asociada al hipervínculo. El HyperLinkField objeto se muestra de forma diferente según el control enlazado a datos en el que se use. Por ejemplo, el GridView control muestra un HyperLinkField objeto como una columna, mientras que el DetailsView control lo muestra como una fila.
Para especificar el título que se va a mostrar para los hipervínculos, use la Text propiedad . Utilice la NavigateUrl propiedad para especificar la dirección URL a la que navegar cuando se hace clic en un hipervínculo. Si desea mostrar el contenido vinculado en una ventana o marco específico, establezca la Target propiedad .
Nota
Cuando se establecen las Text propiedades y NavigateUrl , todos los hipervínculos del HyperLinkField objeto comparten el mismo título y dirección URL de navegación. Del mismo modo, la Target propiedad también se aplica a todos los hipervínculos.
Como alternativa, puede enlazar el HyperLinkField objeto a campos de un origen de datos. Esto le permite mostrar un título diferente para cada hipervínculo del HyperLinkField objeto y hacer que cada hipervínculo navegue a una ubicación diferente. Para enlazar un campo a un título, establezca la DataTextField propiedad . Para crear una dirección URL para la navegación, establezca la DataNavigateUrlFields propiedad en una lista separada por comas de campos que se usará para crear la dirección URL.
Puede especificar un formato personalizado para los títulos y las direcciones URL de navegación estableciendo las DataTextFormatString propiedades y DataNavigateUrlFormatString , respectivamente.
Puede ocultar un HyperLinkField objeto en un control enlazado a datos estableciendo la Visible propiedad falseen .
Puede personalizar las secciones de encabezado y pie de página de un HyperLinkField objeto . Para mostrar un título en las secciones de encabezado o pie de página, establezca las HeaderText propiedades o FooterText , respectivamente. Para mostrar una imagen en la sección de encabezado en lugar de texto, establezca la HeaderImageUrl propiedad . La sección de encabezado se puede ocultar en el HyperLinkField objeto estableciendo la ShowHeader propiedad falseen .
Nota
Algunos controles enlazados a datos (como el GridView control) pueden mostrar u ocultar solo la sección de encabezado completa del control. Estos controles enlazados a datos no admiten la ShowHeader propiedad para un campo enlazado individual. Para mostrar u ocultar toda la sección de encabezado de un control enlazado a datos, use la propiedad del ShowHeader control (si está disponible).
También puede personalizar la apariencia del HyperLinkField objeto (color de fuente, color de fondo, etc.) estableciendo las propiedades de estilo para las distintas partes del campo. En la tabla siguiente se enumeran las diferentes propiedades de estilo.
| Propiedad Style | Descripción |
|---|---|
| ControlStyle | La configuración de estilo para los controles secundarios del servidor web del HyperLinkField objeto . |
| FooterStyle | La configuración de estilo de la sección de pie de página del HyperLinkField objeto . |
| HeaderStyle | La configuración de estilo de la sección de encabezado del HyperLinkField objeto. |
| ItemStyle | La configuración de estilo de los elementos de datos del HyperLinkField objeto . |
Constructores
| HyperLinkField() |
Inicializa una nueva instancia de la clase HyperLinkField. |
Propiedades
| AccessibleHeaderText |
Obtiene o establece el texto que se representa como el valor de la propiedad |
| Control |
Obtiene una referencia al control de datos al que está asociado el objeto DataControlField. (Heredado de DataControlField) |
| ControlStyle |
Obtiene el estilo de cualquier control de servidor web contenido en el objeto DataControlField. (Heredado de DataControlField) |
| DataNavigateUrlFields |
Obtiene o establece los nombres de los campos del origen de datos utilizados para generar las direcciones URL de los hipervínculos del objeto HyperLinkField. |
| DataNavigateUrlFormatString |
Obtiene o establece la cadena que especifica el formato con el que se representan las direcciones URL de los hipervínculos de un objeto HyperLinkField. |
| DataTextField |
Obtiene o establece el nombre del campo del origen de datos que contiene el texto que se va a mostrar para los títulos de hipervínculo del objeto HyperLinkField. |
| DataTextFormatString |
Obtiene o establece la cadena que especifica el formato con el que se muestran los títulos de hipervínculo en un objeto HyperLinkField. |
| DesignMode |
Obtiene un valor que indica si un campo de control de datos está visible actualmente en un entorno en tiempo de diseño. (Heredado de DataControlField) |
| FooterStyle |
Obtiene o establece el estilo del pie de página del campo del control de datos. (Heredado de DataControlField) |
| FooterText |
Obtiene o establece el texto que se muestra en el elemento de pie de página de un campo de control de datos. (Heredado de DataControlField) |
| HeaderImageUrl |
Obtiene o establece la dirección URL de una imagen que se muestra en el elemento de encabezado de un campo de control de datos. (Heredado de DataControlField) |
| HeaderStyle |
Obtiene o establece el estilo del encabezado del campo del control de datos. (Heredado de DataControlField) |
| HeaderText |
Obtiene o establece el texto que se muestra en el elemento de encabezado de un campo de control de datos. (Heredado de DataControlField) |
| InsertVisible |
Obtiene un valor que indica si el objeto DataControlField está visible cuando su control enlazado a datos primario está en modo de inserción. (Heredado de DataControlField) |
| IsTrackingViewState |
Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista. (Heredado de DataControlField) |
| ItemStyle |
Obtiene el estilo de cualquier contenido basado en texto mostrado por un campo de control de datos. (Heredado de DataControlField) |
| NavigateUrl |
Obtiene o establece la dirección URL a la que se navega al hacer clic en un hipervínculo de un objeto HyperLinkField. |
| ShowHeader |
Obtiene o establece un valor que indica si se representa el elemento de encabezado de un campo de control de datos. (Heredado de DataControlField) |
| SortExpression |
Obtiene o establece una expresión de ordenación utilizada por un control de origen de datos para ordenar los datos. (Heredado de DataControlField) |
| Target |
Obtiene o establece la ventana o el marco de destino donde se va a mostrar la página Web vinculada al hacer clic en un hipervínculo de un objeto HyperLinkField. |
| Text |
Obtiene o establece el texto que se muestra para cada hipervínculo del objeto HyperLinkField. |
| ValidateRequestMode |
Obtiene o establece un valor que especifica si el control valida la entrada de cliente. (Heredado de DataControlField) |
| ViewState |
Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto DataControlField en las distintas solicitudes de la misma página. (Heredado de DataControlField) |
| Visible |
Obtiene o establece un valor que indica si se representa un campo de control de datos. (Heredado de DataControlField) |
Métodos
| CloneField() |
Crea una copia duplicada del objeto actual derivado de DataControlField. (Heredado de DataControlField) |
| CopyProperties(DataControlField) |
Copia las propiedades del objeto HyperLinkField actual en el objeto especificado. |
| CreateField() |
Devuelve una nueva instancia de la clase HyperLinkField. |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Extrae el valor del campo de control de datos de la celda de la tabla actual y agrega su valor a la colección IDictionary especificada. (Heredado de DataControlField) |
| FormatDataNavigateUrlValue(Object[]) |
Da formato a la dirección URL de navegación utilizando la cadena de formato que especifique la propiedad DataNavigateUrlFormatString. |
| FormatDataTextValue(Object) |
Da formato al texto de título utilizando la cadena de formato que especifique la propiedad DataTextFormatString. |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Initialize(Boolean, Control) |
Inicializa el objeto HyperLinkField. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inicializa una celda en un objeto HyperLinkField. |
| LoadViewState(Object) |
Restaura la vista del origen de datos tal y como se guardó previamente. (Heredado de DataControlField) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| OnFieldChanged() |
Genera el evento |
| SaveViewState() |
Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor. (Heredado de DataControlField) |
| ToString() |
Devuelve una cadena que representa este objeto DataControlField. (Heredado de DataControlField) |
| TrackViewState() |
Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de DataControlField) |
| ValidateSupportsCallback() |
Indica que los controles que contiene un objeto HyperLinkField admiten las devoluciones de llamada. |
Implementaciones de interfaz explícitas
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Obtiene o establece el esquema asociado a este objeto DataControlField. (Heredado de DataControlField) |
| IStateManager.IsTrackingViewState |
Obtiene un valor que indica si el objeto DataControlField está guardando los cambios en su estado de vista. (Heredado de DataControlField) |
| IStateManager.LoadViewState(Object) |
Restaura el estado de vista que se guardó previamente del campo de control de datos. (Heredado de DataControlField) |
| IStateManager.SaveViewState() |
Guarda los cambios efectuados en el estado de vista de DataControlField desde el momento en que se devolvió la página al servidor. (Heredado de DataControlField) |
| IStateManager.TrackViewState() |
Hace que el objeto DataControlField lleve un seguimiento de los cambios de su estado de vista, de modo que puedan almacenarse en la propiedad ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de DataControlField) |