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".

Свойства

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)

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

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