BoundField Класс

Определение

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

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

Важно!

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

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

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

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

DataControlField
BoundField

Производный: System.Web.UI.WebControls.AutoGeneratedField

System.Web.UI.WebControls.CheckBoxField

Примеры

В следующем примере кода показано, как использовать 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".

Имя

Описание

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	Возвращает или задает заголовок, отображаемый для поля, если значение поля равно NULL.
ReadOnly	Возвращает или задает значение, указывающее, можно ли изменить значение поля в режиме редактирования.
ShowHeader	Возвращает или задает значение, указывающее, отображается ли элемент заголовка поля управления данными. (Унаследовано от DataControlField)
SortExpression	Возвращает или задает выражение сортировки, используемое элементом управления источниками данных для сортировки данных. (Унаследовано от DataControlField)
SupportsHtmlEncode	Возвращает значение, указывающее, поддерживается BoundField ли кодировка HTML объектом.
ValidateRequestMode	Возвращает или задает значение, определяющее, проверяет ли элемент управления входные данные клиента.
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)

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

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

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

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

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