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 свойство.

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

GridView.Columns Свойство

Определение

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

Примеры

Комментарии

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

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

Дополнительные ресурсы