Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Свойство GridView.Columns

 

Опубликовано: Октябрь 2016

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

Пространство имен:   System.Web.UI.WebControls
Сборка:  System.Web (в System.Web.dll)

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public virtual DataControlFieldCollection Columns { get; }

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

Type: System.Web.UI.WebControls.DataControlFieldCollection

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

Поле столбца представляет собой столбец в GridView элемента управления. Columns Свойство (коллекция) используется для хранения всех явно заданные поля столбцов, отображаемые в GridView элемента управления. Можно также использовать Columns коллекции для программного управления коллекцией полей столбцов.

System_CAPS_noteПримечание

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

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

Тип поля столбца

Описание

BoundField

Отображает значение поля в источнике данных. Это тип столбца по умолчанию GridView элемента управления.

ButtonField

Отображает кнопку для каждого элемента в GridView элемента управления. Это позволяет создать столбец пользовательских кнопочных элементов управления, таких как добавление или кнопку «Удалить».

CheckBoxField

Отображает флажок для каждого элемента в GridView элемента управления. Данный тип поля столбца обычно используется для отображения полей с логическими значениями.

CommandField

Отображает предопределенные кнопки select, редактирование и удаление операций.

HyperLinkField

Отображает значение поля в источнике данных как гиперссылку. Данный тип поля столбца позволяет привязывать второе поле к URL-адрес гиперссылки.

ImageField

Отображает изображение для каждого элемента в GridView элемента управления.

TemplateField

Отображает определенное пользователем содержимое для каждого элемента в GridView управления в соответствии с указанным шаблоном. Данный тип поля столбца позволяет создать поле пользовательского столбца.

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

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

Следующий пример демонстрирует заполнения 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>

.NET Framework
Доступно с 2.0
Вернуться в начало
Показ: