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


BoundField Класс

Определение

Представляет поле, которое отображается как текст в элементе управления с привязкой к данным.

public ref class BoundField : System::Web::UI::WebControls::DataControlField
public class BoundField : System.Web.UI.WebControls.DataControlField
type BoundField = class
    inherit DataControlField
Public Class BoundField
Inherits DataControlField
Наследование
Производный

Примеры

В следующем примере кода показано, как использовать BoundField объект для отображения значений поля в элементе GridView управления .


<%@ 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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </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>BoundField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>BoundField Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        autogenerateeditbutton="true"
        allowpaging="true" 
        datakeynames="CustomerID"  
        runat="server">
         
        <columns>
          <asp:boundfield datafield="CustomerID"
            readonly="true"      
            headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName"
            convertemptystringtonull="true"
            headertext="Customer Name"/>
          <asp:boundfield datafield="Address"
            convertemptystringtonull="true"
            headertext="Address"/>
          <asp:boundfield datafield="City"
            convertemptystringtonull="true"
            headertext="City"/>
          <asp:boundfield datafield="PostalCode"
            convertemptystringtonull="true"
            headertext="ZIP Code"/>
          <asp:boundfield datafield="Country"
            convertemptystringtonull="true"
            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="CustomersSqlDataSource"  
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
        runat="server">
      </asp:sqldatasource>
            
    </form>
  </body>
</html>

Комментарии

Класс BoundField используется элементами управления с привязкой к данным (например, GridView и DetailsView) для отображения значения поля в виде текста. Объект BoundField отображается по-разному в зависимости от элемента управления с привязкой к данным, в котором он используется. Например, GridView элемент управления отображает BoundField объект в виде столбца, а DetailsView элемент управления — в виде строки.

Чтобы указать поле, которое будет отображаться в объекте BoundField , присвойте DataField свойству имя поля. Значение поля можно закодировать в ФОРМАТЕ HTML перед отображением, задав свойству HtmlEncode значение true. Вы можете применить настраиваемую строку форматирования к значению поля, задав DataFormatString свойство . HtmlEncode Если свойство имеет значение true, в строке настраиваемого формата используется закодированное строковое значение поля. По умолчанию строка форматирования применяется к значениям полей, только если элемент управления с привязкой к данным находится в режиме только для чтения. Чтобы применить строку форматирования к значениям, отображаемым, когда элемент управления с привязкой к данным находится в режиме редактирования, присвойте свойству ApplyFormatInEditMode значение true. Если значение поля равно NULL, можно отобразить настраиваемый заголовок, задав NullDisplayText свойство . Объект BoundField также может автоматически преобразовать пустые строковые значения поля ("") в значения NULL, задав свойству ConvertEmptyStringToNull значение true.

Вы можете скрыть объект в элементе BoundField управления с привязкой к данным, задав свойству Visible значение false. Чтобы предотвратить изменение значения поля в режиме редактирования, присвойте свойству ReadOnly значение true. В элементах управления с привязкой к данным, поддерживающих вставку записей (таких как DetailsView элемент управления), можно скрыть BoundField объект, задав свойству InsertVisible значение false. Обычно это делается, если требуется скрыть автоматически созданное ключевое поле в режиме вставки.

Вы можете настроить разделы BoundField колонтитулов объекта . Чтобы отобразить заголовок в разделах верхнего или нижнего колонтитула, задайте HeaderText свойства или FooterText соответственно. Вместо отображения текста в разделе заголовка можно отобразить изображение, задав HeaderImageUrl свойство . Раздел заголовка можно скрыть в объекте , BoundField задав свойству ShowHeader значение false.

Примечание

Некоторые элементы управления с привязкой к данным (например, GridView элемент управления) могут отображать или скрывать только весь раздел заголовка элемента управления. Эти элементы управления с привязкой к данным не поддерживают ShowHeader свойство для отдельного привязанного поля. Чтобы отобразить или скрыть весь раздел заголовка элемента управления с привязкой к данным (если он доступен), используйте свойство элемента управления ShowHeader .

Вы также можете настроить внешний вид объекта (цвет шрифта BoundField , цвет фона и т. д.), задав свойства стиля для различных частей поля. В следующей таблице перечислены различные свойства стиля.

Свойство Style Описание
ControlStyle Параметры стиля для дочерних элементов управления BoundField веб-сервера объекта .
FooterStyle Параметры стиля для нижнего колонтитула BoundField объекта.
HeaderStyle Параметры стиля для раздела заголовка BoundField объекта.
ItemStyle Параметры стиля для элементов данных в объекте BoundField .

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

BoundField()

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

Поля

ThisExpression

Этот API поддерживает инфраструктуру продукта и не предназначен для использования непосредственно из программного кода.

Представляет выражение "this".

Свойства

AccessibleHeaderText

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

(Унаследовано от DataControlField)
ApplyFormatInEditMode

Возвращает или задает значение, указывающее на применения форматирующей строки, указанной свойством DataFormatString к значениям поля, если элемент управления, привязанный к данным и содержащий объект BoundField находится в режиме правки.

Control

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

(Унаследовано от DataControlField)
ControlStyle

Получает стиль любых серверных веб-элементов управления, содержащихся в объекте DataControlField.

(Унаследовано от DataControlField)
ConvertEmptyStringToNull

Возвращает или задает значение, показывающее, преобразовываются ли пустые строковые значения ("") автоматически в значения null, когда в источнике данных обновляется поле данных.

DataField

Возвращает или задает имя поля данных, привязываемого к объекту BoundField.

DataFormatString

Получает или задает строку, определяющую формат отображения значения поля.

DesignMode

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

(Унаследовано от DataControlField)
FooterStyle

Возвращает или задает стиль нижнего колонтитула поля элемента управления данными.

(Унаследовано от DataControlField)
FooterText

Возвращает или задает текст для отображения в нижнем колонтитуле поля элемента управления данными.

(Унаследовано от DataControlField)
HeaderImageUrl

Возвращает или задает URL -адрес изображения для отображения в верхнем колонтитуле поля элемента управления данными.

(Унаследовано от DataControlField)
HeaderStyle

Возвращает или задает стиль верхнего колонтитула поля элемента управления данными.

(Унаследовано от DataControlField)
HeaderText

Возвращает или задает текст для отображения в верхнем колонтитуле элемента управления данными.

HtmlEncode

Возвращает или задает значение, позволяющее определить, следует ли кодировать в HTML значения полей, перед отображением в объекте BoundField.

HtmlEncodeFormatString

Получает или задает значение, указывающее, нужно ли отображать текст, созданный применением свойства DataFormatString к значению BoundField, в кодировке HTML.

InsertVisible

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

(Унаследовано от DataControlField)
IsTrackingViewState

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.

(Унаследовано от DataControlField)
ItemStyle

Возвращает стиль любого текстового содержимого, отображаемого полем элемента управления содержанием.

(Унаследовано от DataControlField)
NullDisplayText

Возвращает или задает заголовок для поля, имеющего нулевое значение.

ReadOnly

Возвращает или задает значение, позволяющее определить, можно ли менять значения поля, в режиме редактирования.

ShowHeader

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

(Унаследовано от DataControlField)
SortExpression

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

(Унаследовано от DataControlField)
SupportsHtmlEncode

Возвращает значение, указывающее поддержку HTML кодирования объектом BoundField.

ValidateRequestMode

Получает или задает значение, указывающее, проверяет ли элемент управления клиентский ввод.

ValidateRequestMode

Получает или задает значение, указывающее, проверяет ли элемент управления клиентский ввод.

(Унаследовано от DataControlField)
ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта DataControlField при нескольких запросах одной и той же страницы.

(Унаследовано от DataControlField)
Visible

Возвращает или задает значение, определяющее, отображается ли поле элемента управления данными.

(Унаследовано от DataControlField)

Методы

CloneField()

Создает точную копию текущего объекта, производного от DataControlField.

(Унаследовано от DataControlField)
CopyProperties(DataControlField)

Копирует свойства текущего объекта BoundField в указанный объект DataControlField.

CreateField()

Создает пустой объект BoundField.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Заполняет указанный объект IDictionary значениями из указанного объекта TableCell.

FormatDataValue(Object, Boolean)

Форматирует указанное значение поля для ячейки в объекте BoundField.

GetDesignTimeValue()

Возвращает значение, используемое для значения поля при отрисовке объекта BoundField в конструкторе.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
GetValue(Control)

Извлекает значения поля, привязанного к объекту BoundField.

Initialize(Boolean, Control)

Выполняет инициализацию объекта BoundField.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Инициализирует указанный объект TableCell заданным состоянием строки.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

Инициализирует указанный объект TableCell заданным состоянием строки.

LoadViewState(Object)

Восстанавливает сохраненное раннее состояние просмотра для данного поля.

MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
OnDataBindField(Object, EventArgs)

Привязывает значение поля к указанному объекту BoundField.

OnFieldChanged()

Вызывает событие FieldChanged.

(Унаследовано от DataControlField)
SaveViewState()

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.

(Унаследовано от DataControlField)
ToString()

Возврат строки, представляющей объект DataControlField.

(Унаследовано от DataControlField)
TrackViewState()

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.

(Унаследовано от DataControlField)
ValidateSupportsCallback()

Определяет поддержку обратных вызовов элементами управления, содержащимися в объекте BoundField.

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

IDataSourceViewSchemaAccessor.DataSourceViewSchema

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

(Унаследовано от DataControlField)
IStateManager.IsTrackingViewState

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.

(Унаследовано от DataControlField)
IStateManager.LoadViewState(Object)

Восстанавливает сохраненное раннее состояние представления поля источника данных.

(Унаследовано от DataControlField)
IStateManager.SaveViewState()

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.

(Унаследовано от DataControlField)
IStateManager.TrackViewState()

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.

(Унаследовано от DataControlField)

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

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