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


BoundColumn Класс

Определение

Тип столбца для элемента управления 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
Наследование
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 элемента управления .

Примечание

Этот тип столбца используется по умолчанию для 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)

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

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