BoundField Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

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 texto en un control enlazado a datos.

public ref class BoundField : System::Web::UI::WebControls::DataControlField

public class BoundField : System.Web.UI.WebControls.DataControlField

type BoundField = class
    inherit DataControlField

Public Class BoundField
Inherits DataControlField

Herencia: Object

DataControlField
BoundField

Derivado: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Ejemplos

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


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


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

Comentarios

Los controles enlazados a datos (como GridView y DetailsView) usan la BoundField clase para mostrar el valor de un campo como texto. El BoundField 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 BoundField objeto como una columna, mientras que el DetailsView control lo muestra como una fila.

Para especificar el campo que se va a mostrar en un BoundField objeto, establezca la DataField propiedad en el nombre del campo. El valor del campo se puede codificar en HTML antes de que se muestre estableciendo la HtmlEncode propiedad trueen . Puede aplicar una cadena de formato personalizada al valor del campo estableciendo la DataFormatString propiedad . Cuando la HtmlEncode propiedad es true, el valor de cadena codificado del campo se usa en la cadena de formato personalizado. De forma predeterminada, la cadena de formato se aplica a los valores de campo solo cuando el control enlazado a datos está en modo de solo 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 ApplyFormatInEditMode propiedad trueen . Si el valor de un campo es NULL, puede mostrar un título personalizado estableciendo la NullDisplayText propiedad . El BoundField objeto también puede convertir automáticamente valores de campo de cadena vacía ("") en valores NULL estableciendo la ConvertEmptyStringToNull propiedad trueen .

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

Puede personalizar las secciones de encabezado y pie de página de un BoundField objeto . Para mostrar un título en las secciones de encabezado o pie de página, establezca las HeaderText propiedades o FooterText , respectivamente. En lugar de mostrar texto en la sección de encabezado, puede mostrar una imagen estableciendo la HeaderImageUrl propiedad . La sección de encabezado se puede ocultar en el BoundField 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 (si está disponible), use la propiedad del ShowHeader control.

También puede personalizar la apariencia del BoundField 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 BoundField objeto .
FooterStyle	La configuración de estilo de la sección de pie de página del BoundField objeto .
HeaderStyle	La configuración de estilo de la sección de encabezado del BoundField objeto.
ItemStyle	La configuración de estilo de los elementos de datos del BoundField objeto .

Constructores

BoundField()

Inicializa una nueva instancia de la clase BoundField.

Campos

ThisExpression

Esta API admite la infraestructura de producto y no está pensada para usarse directamente en el código.

Representa "esta" expresión.

Propiedades

AccessibleHeaderText	Obtiene o establece el texto que se representa como el valor de la propiedad `AbbreviatedText` en algunos controles. (Heredado de DataControlField)
ApplyFormatInEditMode	Obtiene o establece un valor que indica si la cadena de formato especificada por la propiedad DataFormatString se aplica a los valores de campo cuando el control enlazado a datos que contiene el objeto BoundField está en modo de edición.
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)
ConvertEmptyStringToNull	Obtiene o establece un valor que indica si los valores de cadena vacía ("") se convierten automáticamente en valores nulos cuando se actualiza el campo de datos en el origen de datos.
DataField	Obtiene o establece el nombre del campo de datos que se enlaza al objeto BoundField.
DataFormatString	Obtiene o establece la cadena que especifica el formato de presentación del valor del campo.
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 encabezado de un control de datos.
HtmlEncode	Obtiene o establece un valor que indica si los valores de campo se codifican en HTML antes de mostrarlos en un objeto BoundField.
HtmlEncodeFormatString	Obtiene o establece un valor que indica si el texto que se crea aplicando la propiedad DataFormatString al valor BoundField debería mostrarse codificado como HTML.
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)
NullDisplayText	Obtiene o establece el título mostrado para un campo cuando el valor del campo es nulo.
ReadOnly	Obtiene o establece un valor que indica si el valor del campo se puede modificar en modo de edición.
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)
SupportsHtmlEncode	Obtiene un valor que indica si un objeto BoundField admite la codificación HTML.
ValidateRequestMode	Obtiene o establece un valor que determina si el control valida la entrada de cliente o no.
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 BoundField actual al objeto DataControlField especificado.
CreateField()	Crea un objeto BoundField vacío.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	El objeto IDictionary especificado se rellena con los valores del objeto TableCell especificado.
FormatDataValue(Object, Boolean)	Da formato al valor de campo especificado para una celda del objeto BoundField.
GetDesignTimeValue()	Recupera el valor utilizado como valor de un campo al representar el objeto BoundField en un diseñador.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValue(Control)	Recupera el valor del campo enlazado al objeto BoundField.
Initialize(Boolean, Control)	Inicializa el objeto BoundField.
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializa el objeto TableCell especificado en el estado de fila especificado.
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializa el objeto TableCell especificado en el estado de fila especificado.
LoadViewState(Object)	Restaura la información de estado de vista almacenada previamente para este campo.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnDataBindField(Object, EventArgs)	Enlaza el valor de un campo al objeto BoundField.
OnFieldChanged()	Genera el evento `FieldChanged`. (Heredado de DataControlField)
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()	Determina si los controles que contiene un objeto BoundField admiten 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)

Se aplica a