Página de inicio Biblioteca Aprender Descargas Soporte técnico Comunidad
Iniciar sesión | United States - English | |
Personas que lo han encontrado útil: 1 de 1 - Valorar este tema

BoundField (Clase)

.NET Framework 2.0
Representa un campo que se muestra como texto en un control enlazado a datos.

Espacio de nombres: System.Web.UI.WebControls
Ensamblado: System.Web (en system.web.dll)

C#
C++
VB
Copiar 
public class BoundField : DataControlField
J#
Copiar 
public class BoundField extends DataControlField
JScript
Copiar 
public class BoundField extends DataControlField
XAML
Copiar 
No aplicable.

Los controles enlazados a datos (como GridView y DetailsView) utilizan la clase BoundField para mostrar el valor de un campo como texto. El objeto BoundField que se muestra de forma diferente según el control enlazado a datos en el que se utilice. Por ejemplo, el control GridView muestra un objeto BoundField como una columna, mientras que el control DetailsView lo muestra como una fila.

Para especificar que el campo se muestre en un objeto BoundField, establezca la propiedad DataField en el nombre del campo. El valor del campo puede codificarse en HTML antes de mostrarlo, estableciendo la propiedad HtmlEncode en true. Puede aplicar una cadena de formato personalizada al valor del campo, estableciendo la propiedad DataFormatString. Cuando la propiedad HtmlEncode es true, el valor de cadena codificado del campo se utiliza en la cadena de formato personalizada. De manera predeterminada, la cadena de formato sólo se aplica a los valores del campo cuando el control enlazado a datos está en modo de sólo lectura. Para aplicar la cadena de formato a los valores mostrados mientras el control enlazado a datos está en modo de edición, establezca la propiedad ApplyFormatInEditMode en true. Si el valor de un campo es nulo, puede mostrar un título personalizado, estableciendo la propiedad NullDisplayText. El objeto BoundField también puede convertir automáticamente los valores de campo de cadena vacía ("") en valores nulos, si se establece la propiedad ConvertEmptyStringToNull en true.

Puede ocultar un objeto BoundField en un control enlazado a datos, estableciendo la propiedad Visible en false. Para evitar que se modifique el valor de un campo en modo de edición, establezca la propiedad ReadOnly en true. En los controles enlazados a datos que admiten la inserción de registros (como el control DetailsView), para ocultar un objeto BoundField, establezca la propiedad InsertVisible en false. Esto se hace habitualmente cuando se desea ocultar automáticamente un campo clave generado en modo de inserción.

Puede personalizar las secciones de encabezado y de pie de página de un objeto BoundField. Para mostrar un título en la sección de encabezado o de pie de página, establezca la propiedad HeaderText o FooterText, respectivamente. En lugar de que se muestre texto en la sección de encabezado, se puede mostrar una imagen estableciendo la propiedad HeaderImageUrl. La sección de encabezado puede ocultarse en el objeto BoundField estableciendo la propiedad ShowHeader en false.

NotaNota:

Algunos controles con enlace a datos (como el control GridView) pueden mostrar u ocultar sólo la sección de encabezado completa del control. Estos controles enlazados a datos no admiten la propiedad ShowHeader para un campo enlazado individual. Para mostrar u ocultar la sección de encabezado completa de un control enlazado a datos (si está disponible), utilice la propiedad ShowHeader del control.

También puede personalizar la apariencia del objeto BoundField (color de fuente, color de fondo, y así sucesivamente) estableciendo las propiedades de estilo para las distintas partes del campo. En la siguiente tabla se muestran las diferentes propiedades de estilo.

Propiedad de estilo

Descripción

ControlStyle

La configuración de estilo para los controles de servidor Web secundarios del objeto BoundField.

FooterStyle

La configuración de estilo de la sección de pie de página del objeto BoundField.

HeaderStyle

La configuración de estilo de la sección de encabezado del objeto BoundField.

ItemStyle

La configuración de estilo de los elementos de datos del objeto BoundField.

En el ejemplo de código siguiente se muestra cómo utilizar un objeto BoundField para que muestre los valores de un campo en un control GridView.

C#
VB
Copiar 

<%@ 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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>
  • AspNetHostingPermission  para trabajar en un entorno alojado en host. Valor de la petición: LinkDemand; valor del permiso: Minimal
  • AspNetHostingPermission  para trabajar en un entorno alojado en host. Valor de la petición: InheritanceDemand; valor del permiso: Minimal
Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
¿Le ha resultado útil?
(Caracteres restantes: 1500)