BoundColumn Класс

Определение

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

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

Важно!

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

Тип столбца DataGrid для элемента управления, привязанного к полю в источнике данных.

public ref class BoundColumn : System::Web::UI::WebControls::DataGridColumn

public class BoundColumn : System.Web.UI.WebControls.DataGridColumn

type BoundColumn = class
    inherit DataGridColumn

Public Class BoundColumn
Inherits DataGridColumn

Наследование: Object

DataGridColumn
BoundColumn

Примеры

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

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="C#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!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" >
   <script language="VB" runat="server">
    Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " + i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
   </script>
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

BoundColumn Используйте тип столбца в элементе DataGrid управления, чтобы отобразить содержимое поля в источнике данных. Значения перечислены в одном столбце. Поле связано с BoundColumnполем, поэтому любые обновления в источнике данных будут отражаться в соответствующих ячейках DataGrid элемента управления.

Note

Этот тип столбца DataGrid используется по умолчанию для элемента управления.

Чтобы управлять внешним видом этого столбца DataGrid , используйте свойства стиля элемента управления.

Предостережение

Текст не закодирован в формате HTML, прежде чем он отображается в файле BoundColumn. Это позволяет внедрить скрипт в html-теги в текст. Если значения этого столбца исходят из входных данных пользователя, обязательно проверьте значения, чтобы уменьшить уязвимости безопасности.

Конструкторы

Имя	Описание
BoundColumn()	Инициализирует новый экземпляр класса BoundColumn.

Поля

Имя	Описание
thisExpr	Представляет строку "!". Это поле может использоваться только для чтения.

Свойства

Имя	Описание
DataField	Возвращает или задает имя поля из источника данных для привязки к объекту BoundColumn.
DataFormatString	Возвращает или задает строку, указывающую формат отображения элементов в столбце.
DesignMode	Возвращает значение, указывающее, находится ли столбец в режиме конструктора. (Унаследовано от DataGridColumn)
FooterStyle	Возвращает свойства стиля для нижнего колонтитула столбца. (Унаследовано от DataGridColumn)
FooterText	Возвращает или задает текст, отображаемый в нижнем колонтитуле столбца. (Унаследовано от DataGridColumn)
HeaderImageUrl	Возвращает или задает расположение изображения, отображаемого в разделе заголовка столбца. (Унаследовано от DataGridColumn)
HeaderStyle	Возвращает свойства стиля для раздела заголовка столбца. (Унаследовано от DataGridColumn)
HeaderText	Возвращает или задает текст, отображаемый в разделе заголовка столбца. (Унаследовано от DataGridColumn)
IsTrackingViewState	Возвращает значение, определяющее, помечен ли DataGridColumn объект для сохранения состояния. (Унаследовано от DataGridColumn)
ItemStyle	Возвращает свойства стиля для ячеек элемента столбца. (Унаследовано от DataGridColumn)
Owner	DataGrid Возвращает элемент управления, в который входит столбец. (Унаследовано от DataGridColumn)
ReadOnly	Возвращает или задает значение, указывающее, можно ли изменять элементы в элементе BoundColumn .
SortExpression	Возвращает или задает имя поля или выражения, передаваемого OnSortCommand(DataGridSortCommandEventArgs) методу при выборе столбца для сортировки. (Унаследовано от DataGridColumn)
ViewState	Возвращает объект, позволяющий столбцу StateBag , производным от DataGridColumn класса, хранить его свойства. (Унаследовано от DataGridColumn)
Visible	Возвращает или задает значение, указывающее, отображается ли столбец в элементе DataGrid управления. (Унаследовано от DataGridColumn)

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FormatDataValue(Object)	Преобразует указанное значение в формат, указанный свойством DataFormatString .
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Initialize()	Сбрасывает исходное BoundColumn состояние.
InitializeCell(TableCell, Int32, ListItemType)	Сбрасывает указанную ячейку в исходном BoundColumn состоянии.
LoadViewState(Object)	Загружает состояние DataGridColumn объекта. (Унаследовано от DataGridColumn)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnColumnChanged()	Вызывает метод OnColumnsChanged(). (Унаследовано от DataGridColumn)
SaveViewState()	Сохраняет текущее состояние DataGridColumn объекта. (Унаследовано от DataGridColumn)
ToString()	Возвращает строковое представление столбца. (Унаследовано от DataGridColumn)
TrackViewState()	Вызывает отслеживание изменений состояния представления в серверном элементе управления, чтобы они могли храниться в объекте серверного элемента управления StateBag . (Унаследовано от DataGridColumn)

Явные реализации интерфейса

Имя	Описание
IStateManager.IsTrackingViewState	Возвращает значение, указывающее, изменяется ли столбец в режиме отслеживания состояния. (Унаследовано от DataGridColumn)
IStateManager.LoadViewState(Object)	Загружает ранее сохраненное состояние. (Унаследовано от DataGridColumn)
IStateManager.SaveViewState()	Возвращает объект, содержащий изменения состояния. (Унаследовано от DataGridColumn)
IStateManager.TrackViewState()	Запускает отслеживание изменений состояния. (Унаследовано от DataGridColumn)

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

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

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

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