GridView.Columns Свойство

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает коллекцию объектов, представляющих поля столбцов DataControlField в элементе GridView управления.

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; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.Columns : System.Web.UI.WebControls.DataControlFieldCollection

Public Overridable ReadOnly Property Columns As DataControlFieldCollection

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

DataControlFieldCollection

Объект, DataControlFieldCollection содержащий все поля столбцов в элементе GridView управления.

Атрибуты: PersistenceModeAttribute

Примеры

В следующем примере показано, как заполнять коллекцию Columns декларативно.


<%@ 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 управления. Свойство Columns (коллекция) используется для хранения всех явно объявленных полей столбцов, которые отображаются в элементе GridView управления. Вы также можете использовать коллекцию Columns для программного управления коллекцией полей столбцов.

Замечание

Явно объявленные поля столбцов можно использовать в сочетании с автоматически созданными полями столбцов. При использовании оба поля явно объявленных столбцов отображаются сначала, а затем автоматически созданные поля столбцов. Автоматически созданные поля столбцов не добавляются в коллекцию Columns .

Поля столбцов отображаются в элементе управления в GridView том порядке, в котором отображаются поля столбцов Columns в коллекции. В следующей таблице показаны различные классы полей столбцов, производные от DataControlField класса и которые могут использоваться в Columns коллекции.

Тип поля столбца	Описание
BoundField	Отображает значение поля в источнике данных. Это тип столбца по умолчанию элемента GridView управления.
ButtonField	Отображает кнопку команды для каждого элемента в элементе GridView управления. Это позволяет создать столбец настраиваемых элементов управления кнопками, например кнопку "Добавить" или "Удалить".
CheckBoxField	Отображает флажок для каждого элемента в элементе GridView управления. Этот тип поля столбца обычно используется для отображения полей с логическим значением.
CommandField	Отображает предопределенные кнопки команд для выполнения операций выбора, редактирования или удаления.
HyperLinkField	Отображает значение поля в источнике данных в виде гиперссылки. Этот тип поля столбца позволяет привязать второе поле к URL-адресу гиперссылки.
ImageField	Отображает изображение для каждого элемента в элементе GridView управления.
TemplateField	Отображает определяемое пользователем содержимое для каждого элемента в элементе GridView управления в соответствии с указанным шаблоном. Этот тип поля столбца позволяет создать настраиваемое поле столбца.

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

Visible Если задано свойство поля столбца, столбец не отображается falseв GridView элементе управления, а данные для столбца не делают круглый путь к клиенту. Если вы хотите, чтобы данные для столбца, который не отображается для выполнения круговой поездки, добавьте имя поля в DataKeyNames свойство.

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

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через