GridView.Columns Свойство

Определение

Возвращает коллекцию объектов DataControlField, предоставляющих поля столбцов элемента управления 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

Значение свойства

Коллекция DataControlFieldCollection, которая содержит все поля столбцов элемента управления GridView.A DataControlFieldCollection that contains all the column fields in the GridView control.

Атрибуты

Примеры

В следующем примере показано, как декларативно заполнить коллекцию Columns.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>

Комментарии

Поле столбца представляет столбец в элементе управления GridView.A column field represents a column in a GridView control. Свойство Columns (Collection) используется для хранения всех явно объявленных полей столбцов, которые отображаются в элементе управления GridView.The Columns property (collection) is used to store all the explicitly declared column fields that get rendered in the GridView control. Можно также использовать коллекцию Columns для программного управления коллекцией полей столбцов.You can also use the Columns collection to programmatically manage the collection of column fields.

Примечание

Явно объявленные поля столбцов можно использовать в сочетании с автоматически создаваемыми полями столбцов.Explicitly declared column fields can be used in combination with automatically generated column fields. При использовании обоих типов сначала выводятся явно объявленные поля столбцов, за которыми следуют автоматически создаваемые поля столбцов.When both are used, explicitly declared column fields are rendered first, followed by the automatically generated column fields. Автоматически созданные поля столбцов не добавляются в коллекцию Columns.Automatically generated column fields are not added to the Columns collection.

Поля столбцов отображаются в элементе управления GridView в том порядке, в котором поля столбца отображаются в коллекции Columns.The column fields are displayed in the GridView control in the order that the column fields appear in the Columns collection. В следующей таблице показаны различные классы полей столбцов, производные от класса DataControlField и которые можно использовать в коллекции Columns.The following table shows the different column field classes that derive from the DataControlField class and can be used in the Columns collection.

Тип поля столбцаColumn field type ОписаниеDescription
BoundField Отображает значение поля в источнике данных.Displays the value of a field in a data source. Это тип столбца по умолчанию для элемента управления GridView.This is the default column type of the GridView control.
ButtonField Отображает кнопку команды для каждого элемента в элементе управления GridView.Displays a command button for each item in the GridView control. Это позволяет создать столбец пользовательских элементов управления "Кнопка", таких как кнопка "Добавить" или "Удалить".This enables you to create a column of custom button controls, such as the Add or the Remove button.
CheckBoxField Отображает флажок для каждого элемента в элементе управления GridView.Displays a check box for each item in the GridView control. Этот тип поля столбца обычно используется для вывода полей с логическим значением.This column field type is commonly used to display fields with a Boolean value.
CommandField Отображает предопределенные командные кнопки для выполнения операций выбора, изменения или удаления.Displays predefined command buttons to perform select, edit, or delete operations.
HyperLinkField Отображает значение поля в источнике данных в виде гиперссылки.Displays the value of a field in a data source as a hyperlink. Этот тип поля столбца позволяет привязать второе поле к URL-адресу гиперссылки.This column field type enables you to bind a second field to the hyperlink's URL.
ImageField Отображает изображение для каждого элемента в элементе управления GridView.Displays an image for each item in the GridView control.
TemplateField Отображает определенное пользователем содержимое для каждого элемента в элементе управления GridView в соответствии с заданным шаблоном.Displays user-defined content for each item in the GridView control, according to a specified template. Этот тип поля столбца позволяет создать настраиваемое поле столбца.This column field type enables you to create a custom column field.

Хотя можно программно добавлять поля столбцов в коллекцию Columns, проще перечислять поля столбцов декларативно в элементе управления GridView, а затем использовать свойство Visible каждого поля столбца для отображения или скрытия каждого поля столбца.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.

Если свойство Visible поля столбца имеет значение false, то столбец не отображается в элементе управления GridView, а данные для этого столбца не выполняют круговой путь к клиенту.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. Если требуется, чтобы данные для столбца, который не является видимым, не обменялись, добавьте имя поля в свойство DataKeyNames.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.

Применяется к

Дополнительно