GridView.Columns (Propiedad)

Obtiene una colección de objetos DataControlField que representan los campos de columna de un control GridView.

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

public virtual DataControlFieldCollection Columns { get; }
/** @property */
public DataControlFieldCollection get_Columns ()

public function get Columns () : DataControlFieldCollection

No aplicable.

Valor de propiedad

DataControlFieldCollection que contiene todos los campos de columna del control GridView.

Un campo de columna representa una columna en un control GridView. La propiedad Columns (colección) se utiliza para almacenar todos los campos de columna declarados explícitamente que se representan en el control GridView. También puede utilizar la colección Columns para administrar la colección de campos de columna mediante programación.

NotaNota:

Los campos de columna declarados explícitamente se pueden utilizar junto con los campos de columna generados automáticamente. Cuando se utilizan ambos, primero se representan los campos de columna declarados explícitamente, seguidos de los campos de columna generados automáticamente. Los campos de columna generados automáticamente no se agregan a la colección Columns.

Los campos de columna se muestran en el control GridView en el orden en que aparecen en la colección Columns. En la siguiente tabla se muestran las diferentes clases de campos de columna que se derivan de la clase DataControlField y que se pueden utilizar en la colección Columns.

Tipo de campo de columna

Descripción

BoundField

Muestra el valor de un campo en un origen de datos. Éste es el tipo de columna predeterminado del control GridView.

ButtonField

Muestra un botón de comando para cada elemento del control GridView. Esto permite crear una columna de controles de botón personalizados, como el botón Agregar o Quitar.

CheckBoxField

Muestra una casilla de verificación para cada elemento del control GridView. Normalmente, este tipo de campo de columna se utiliza para mostrar los campos con un valor booleano.

CommandField

Muestra los botones de comando predefinidos para realizar operaciones de selección, edición o eliminación.

HyperLinkField

Muestra el valor de un campo en un origen de datos como un hipervínculo. Este tipo de campo de columna permite enlazar un segundo campo a la dirección URL del hipervínculo.

ImageField

Muestra una imagen para cada elemento del control GridView.

TemplateField

Muestra el contenido definido por el usuario para cada elemento del control GridView, según una plantilla especificada. Este tipo de campo de columna permite crear un campo de columna personalizado.

Aunque puede agregar campos de columna mediante programación a la colección Columns, es más fácil mostrar los campos de columna mediante declaración en el control GridView y, a continuación, utilizar la propiedad Visible de cada campo de columna para mostrarlo u ocultarlo.

Si la propiedad Visible de un campo de columna se establece en false, la columna no se muestra en el control GridView y los datos de la columna no vuelven al cliente. Si desea que los datos de una columna que no es visible realicen una acción de ida y vuelta, agregue el nombre de campo a la propiedad DataKeyNames.

En el ejemplo de código siguiente se muestra cómo rellenar la colección Columns mediante declaración.


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

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        runat="server">
        
        <columns>
          <asp:boundfield datafield="CustomerID" headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName" headertext="Company Name"/>
          <asp:boundfield datafield="Address" headertext="Address"/>
          <asp:boundfield datafield="City" headertext="City"/>
          <asp:boundfield datafield="PostalCode" headertext="Postal Code"/>
          <asp:boundfield datafield="Country" 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="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>


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
Mostrar: