GridView.Columns GridView.Columns GridView.Columns GridView.Columns Property

Definición

Obtiene una colección de objetos DataControlField que representan los campos de columna de un control GridView.Gets a collection of DataControlField objects that represent the column fields in a GridView control.

public:
 virtual property System::Web::UI::WebControls::DataControlFieldCollection ^ Columns { System::Web::UI::WebControls::DataControlFieldCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.DataControlFieldCollection Columns { get; }
member this.Columns : System.Web.UI.WebControls.DataControlFieldCollection
Public Overridable ReadOnly Property Columns As DataControlFieldCollection

Valor de propiedad

DataControlFieldCollection que contiene todos los campos de columna del control GridView.A DataControlFieldCollection that contains all the column fields in the GridView control.

Ejemplos

En el ejemplo siguiente se muestra cómo rellenar la Columns colección mediante declaración.The following example demonstrates how to populate the Columns collection declaratively.


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


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

Comentarios

Un campo de columna representa una columna de GridView un control.A column field represents a column in a GridView control. La Columns propiedad (colección) se usa para almacenar todos los campos de columna declarados explícitamente que se GridView representan en el control.The Columns property (collection) is used to store all the explicitly declared column fields that get rendered in the GridView control. También puede utilizar la Columns colección para administrar mediante programación la colección de campos de columna.You can also use the Columns collection to programmatically manage the collection of column fields.

Nota

Los campos de columna declarados explícitamente se pueden usar en combinación con campos de columna generados automáticamente.Explicitly declared column fields can be used in combination with automatically generated column fields. Cuando se usan ambos, los campos de columna declarados explícitamente se representan en primer lugar, seguidos de los campos de columna generados automáticamente.When both are used, explicitly declared column fields are rendered first, followed by the automatically generated column fields. Los campos de columna generados automáticamente no se Columns agregan a la colección.Automatically generated column fields are not added to the Columns collection.

Los campos de columna se muestran en GridView el control en el orden en que aparecen los campos de Columns columna en la colección.The column fields are displayed in the GridView control in the order that the column fields appear in the Columns collection. En la tabla siguiente se muestran las distintas clases de campos de columna DataControlField que derivan de la clase y Columns que se pueden usar en la colección.The following table shows the different column field classes that derive from the DataControlField class and can be used in the Columns collection.

Tipo de campo de columnaColumn field type DescripciónDescription
BoundField Muestra el valor de un campo en un origen de datos.Displays the value of a field in a data source. Es el tipo de columna predeterminado del GridView control.This is the default column type of the GridView control.
ButtonField Muestra un botón de comando para cada elemento GridView del control.Displays a command button for each item in the GridView control. Esto le permite crear una columna de controles de botón personalizados, como el botón Agregar o quitar.This enables you to create a column of custom button controls, such as the Add or the Remove button.
CheckBoxField Muestra una casilla para cada elemento GridView del control.Displays a check box for each item in the GridView control. Este tipo de campo de columna se utiliza normalmente para mostrar los campos con un valor booleano.This column field type is commonly used to display fields with a Boolean value.
CommandField Muestra botones de comando predefinidos para realizar operaciones SELECT, Edit o DELETE.Displays predefined command buttons to perform select, edit, or delete operations.
HyperLinkField Muestra el valor de un campo en un origen de datos como un hipervínculo.Displays the value of a field in a data source as a hyperlink. Este tipo de campo de columna permite enlazar un segundo campo a la dirección URL del hipervínculo.This column field type enables you to bind a second field to the hyperlink's URL.
ImageField Muestra una imagen para cada elemento GridView del control.Displays an image for each item in the GridView control.
TemplateField Muestra el contenido definido por el GridView usuario para cada elemento del control, de acuerdo con una plantilla especificada.Displays user-defined content for each item in the GridView control, according to a specified template. Este tipo de campo de columna le permite crear un campo de columna personalizado.This column field type enables you to create a custom column field.

Aunque puede agregar campos de columna mediante programación a la Columns colección, es más fácil enumerar los campos de columna de forma declarativa GridView en el control y, Visible a continuación, utilizar la propiedad de cada campo de columna para mostrar u ocultar cada campo de columna.Although you can programmatically add column fields to the Columns collection, it is easier to list the column fields declaratively in the GridView control and then use the Visible property of each column field to show or hide each column field.

Si la Visible propiedad de un campo de columna está establecida falseen, la columna no se muestra en GridView el control y los datos de la columna no realizan un viaje de ida y vuelta al cliente.If the Visible property of a column field is set to false, the column is not displayed in the GridView control and the data for the column does not make a round trip to the client. Si desea que los datos de una columna no estén visibles para realizar un viaje de ida y vuelta, agregue el nombre del DataKeyNames campo a la propiedad.If you want the data for a column that is not visible to make a round trip, add the field name to the DataKeyNames property.

Se aplica a

Consulte también: