BoundField Класс

Определение

Представляет поле, которое отображается как текст в элементе управления с привязкой к данным.Represents a field that is displayed as text in a data-bound control.

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 в элементе управления.The following code example demonstrates how to use a BoundField object to display the values of a field in a GridView control.


<%@ 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>

Комментарии

Класс используется элементами управления с привязкой к данным ( GridView например, и DetailsView) для вывода значения поля в виде текста. BoundFieldThe BoundField class is used by data-bound controls (such as GridView and DetailsView) to display the value of a field as text. BoundField Объект отображается по-разному в зависимости от привязанного к данным элемента управления, в котором он используется.The BoundField object is displayed differently depending on the data-bound control in which it is used. Например, GridView элемент управления BoundField отображает объект как столбец, а DetailsView элемент управления отображает его как строку.For example, the GridView control displays a BoundField object as a column, while the DetailsView control displays it as a row.

Чтобы указать поле, отображаемое в BoundField объекте, DataField задайте для свойства имя поля.To specify the field to display in a BoundField object, set the DataField property to the field's name. Значение поля может быть закодировано в HtmlEncode trueформате HTML перед отображением путем присвоения свойству значения.The field's value can be HTML-encoded before it is displayed by setting the HtmlEncode property to true. Пользовательскую строку форматирования можно применить к значению поля, задав DataFormatString свойство.You can apply a custom formatting string to the field's value by setting the DataFormatString property. Если свойство равно true, в строке настраиваемого формата используется закодированное строковое значение поля. HtmlEncodeWhen the HtmlEncode property is true, the encoded string value of the field is used in the custom format string. По умолчанию строка форматирования применяется к значениям полей только в том случае, если элемент управления с привязкой к данным находится в режиме только для чтения.By default, the formatting string is applied to field values only when the data-bound control is in read-only mode. Чтобы применить строку форматирования к значениям, отображаемым, когда элемент управления с привязкой к данным находится в ApplyFormatInEditMode режиме редактирования true, задайте для свойства значение.To apply the formatting string to values displayed while the data-bound control is in edit mode, set the ApplyFormatInEditMode property to true. Если значение поля равно null, можно отобразить пользовательский заголовок, задав NullDisplayText свойство.If a field's value is null, you can display a custom caption by setting the NullDisplayText property. Объект также может автоматически преобразовывать пустые строковые ("") значения полей в значения NULL, ConvertEmptyStringToNull присвоив свойству trueзначение. BoundFieldThe BoundField object can also automatically convert empty string ("") field values to null values by setting the ConvertEmptyStringToNull property to true.

Можно скрыть BoundField объект в элементе управления с привязкой к данным, Visible задав свойству falseзначение.You can hide a BoundField object in a data-bound control by setting the Visible property to false. Чтобы запретить изменение значения поля в режиме редактирования, задайте ReadOnly для trueсвойства значение.To prevent the value of a field from being modified in edit mode, set the ReadOnly property to true. В элементах управления с привязкой к данным, поддерживающих вставку DetailsView записей (например, элемент управления) BoundField , можно скрыть объект InsertVisible , задав falseдля свойства значение.In data-bound controls that support inserting records (such as the DetailsView control), you can hide a BoundField object by setting the InsertVisible property to false. Обычно это делается, когда необходимо скрыть автоматически созданное ключевое поле в режиме вставки.This is commonly done when you want to hide an automatically generated key field in insert mode.

Можно настроить разделы BoundField верхнего и нижнего колонтитула объекта.You can customize the header and footer sections of a BoundField object. Чтобы отобразить заголовок в разделах верхнего или нижнего колонтитула, задайте HeaderText свойства или FooterText соответственно.To display a caption in the header or footer sections, set the HeaderText or FooterText properties, respectively. Вместо отображения текста в разделе заголовка можно отобразить изображение, задав HeaderImageUrl свойство.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. Раздел заголовка можно скрыть в BoundField объекте, ShowHeader задав свойству falseзначение.The header section can be hidden in the BoundField object by setting the ShowHeader property to false.

Примечание

Некоторые элементы управления с привязкой к данным ( GridView например, элемент управления) могут отображать или скрывать только весь раздел заголовка элемента управления.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Эти элементы управления с привязкой к данным не ShowHeader поддерживают свойство для отдельного привязанного поля.These data-bound controls do not support the ShowHeader property for an individual bound field. Чтобы показать или скрыть весь раздел заголовка элемента управления с привязкой к данным (если он доступен), используйте ShowHeader свойство элемента управления.To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

Можно также настроить внешний вид BoundField объекта (цвет шрифта, цвет фона и т. д.), задав свойства стиля для различных частей поля.You also can customize the appearance of the BoundField object (font color, background color, and so on) by setting the style properties for the different parts of the field. В следующей таблице перечислены различные свойства стиля.The following table lists the different style properties.

Свойство StyleStyle property ОписаниеDescription
ControlStyle Параметры стиля для дочерних серверных веб-элементов управления BoundField объекта.The style settings for the child Web server controls of the BoundField object.
FooterStyle Параметры стиля для нижнего колонтитула BoundField объекта.The style settings for the footer section of the BoundField object.
HeaderStyle Параметры стиля для раздела BoundField заголовка объекта.The style settings for the header section of the BoundField object.
ItemStyle Параметры стиля для элементов данных в BoundField объекте.The style settings for the data items in the BoundField object.

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

BoundField()

Инициализирует новый экземпляр класса BoundField.Initializes a new instance of the BoundField class.

Поля

ThisExpression

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

Свойства

AccessibleHeaderText

Возвращает или задает текст, отображающийся как значение свойство AbbreviatedText некоторых элементов управления.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

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

Возвращает или задает значение, указывающее на применения форматирующей строки, указанной свойством DataFormatString к значениям поля, если элемент управления, привязанный к данным и содержащий объект BoundField находится в режиме правки.Gets or sets a value indicating whether the formatting string specified by the DataFormatString property is applied to field values when the data-bound control that contains the BoundField object is in edit mode.

Control

Возвращает ссылку на элемент управления данными, с которым связан объект DataControlField.Gets a reference to the data control that the DataControlField object is associated with.

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

Получает стиль любых серверных веб-элементов управления, содержащихся в объекте DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

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

Возвращает или задает значение, показывающее, преобразовываются ли пустые строковые значения ("") автоматически в значения null, когда в источнике данных обновляется поле данных.Gets or sets a value indicating whether empty string values ("") are automatically converted to null values when the data field is updated in the data source.

DataField

Возвращает или задает имя поля данных, привязываемого к объекту BoundField.Gets or sets the name of the data field to bind to the BoundField object.

DataFormatString

Получает или задает строку, определяющую формат отображения значения поля.Gets or sets the string that specifies the display format for the value of the field.

DesignMode

Возвращает значение, указывающее, просматривается ли в данный момент поле элемента управления данными в среде режима разработки.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

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

Возвращает или задает стиль нижнего колонтитула поля элемента управления данными.Gets or sets the style of the footer of the data control field.

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

Возвращает или задает текст для отображения в нижнем колонтитуле поля элемента управления данными.Gets or sets the text that is displayed in the footer item of a data control field.

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

Возвращает или задает URL -адрес изображения для отображения в верхнем колонтитуле поля элемента управления данными.Gets or sets the URL of an image that is displayed in the header item of a data control field.

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

Возвращает или задает стиль верхнего колонтитула поля элемента управления данными.Gets or sets the style of the header of the data control field.

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

Возвращает или задает текст для отображения в верхнем колонтитуле элемента управления данными.Gets or sets the text that is displayed in the header of a data control.

HtmlEncode

Возвращает или задает значение, позволяющее определить, следует ли кодировать в HTML значения полей, перед отображением в объекте BoundField.Gets or sets a value indicating whether field values are HTML-encoded before they are displayed in a BoundField object.

HtmlEncodeFormatString

Получает или задает значение, указывающее, нужно ли отображать текст, созданный применением свойства DataFormatString к значению BoundField, в кодировке HTML.Gets or sets a value that indicates whether text that is created by applying the DataFormatString property to the BoundField value should be HTML encoded when it is displayed.

InsertVisible

Возвращает значение, указывающее состояние отображения объекта DataControlField во время пребывания его родительского элемента управления, привязанного к данным, в режиме вставки.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

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

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.Gets a value indicating whether the DataControlField object is saving changes to its view state.

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

Возвращает стиль любого текстового содержимого, отображаемого полем элемента управления содержанием.Gets the style of any text-based content displayed by a data control field.

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

Возвращает или задает заголовок для поля, имеющего нулевое значение.Gets or sets the caption displayed for a field when the field's value is null.

ReadOnly

Возвращает или задает значение, позволяющее определить, можно ли менять значения поля, в режиме редактирования.Gets or sets a value indicating whether the value of the field can be modified in edit mode.

ShowHeader

Возвращает или задает значение, указывающее на необходимость отображения верхнего колонтитула для поля элемента управления данными.Gets or sets a value indicating whether the header item of a data control field is rendered.

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

Возвращает или задает выражение сортировки, используемое элементом управления источником данных для сортировки данных.Gets or sets a sort expression that is used by a data source control to sort data.

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

Возвращает значение, указывающее поддержку HTML кодирования объектом BoundField.Gets a value indicating whether HTML encoding is supported by a BoundField object.

ValidateRequestMode

Получает или задает значение, указывающее, проверяет ли элемент управления клиентский ввод.Gets or sets a value that determines whether the control validates client input or not.

ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта DataControlField при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

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

Возвращает или задает значение, определяющее, отображается ли поле элемента управления данными.Gets or sets a value indicating whether a data control field is rendered.

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

Методы

CloneField()

Создает точную копию текущего объекта, производного от DataControlField.Creates a duplicate copy of the current DataControlField-derived object.

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

Копирует свойства текущего объекта BoundField в указанный объект DataControlField.Copies the properties of the current BoundField object to the specified DataControlField object.

CreateField()

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

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Заполняет указанный объект IDictionary значениями из указанного объекта TableCell.Fills the specified IDictionary object with the values from the specified TableCell object.

FormatDataValue(Object, Boolean)

Форматирует указанное значение поля для ячейки в объекте BoundField.Formats the specified field value for a cell in the BoundField object.

GetDesignTimeValue()

Возвращает значение, используемое для значения поля при отрисовке объекта BoundField в конструкторе.Retrieves the value used for a field's value when rendering the BoundField object in a designer.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

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

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

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

Извлекает значения поля, привязанного к объекту BoundField.Retrieves the value of the field bound to the BoundField object.

Initialize(Boolean, Control)

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

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Инициализирует указанный объект TableCell заданным состоянием строки.Initializes the specified TableCell object to the specified row state.

InitializeDataCell(DataControlFieldCell, DataControlRowState)

Инициализирует указанный объект TableCell заданным состоянием строки.Initializes the specified TableCell object to the specified row state.

LoadViewState(Object)

Восстанавливает сохраненное раннее состояние просмотра для данного поля.Restores the previously stored view-state information for this field.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Привязывает значение поля к указанному объекту BoundField.Binds the value of a field to the BoundField object.

OnFieldChanged()

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

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

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

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

Возврат строки, представляющей объект DataControlField.Returns a string that represents this DataControlField object.

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

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

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

Определяет поддержку обратных вызовов элементами управления, содержащимися в объекте BoundField.Determines whether the controls contained in a BoundField object support callbacks.

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

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Возвращает или задает схему, связанную с этим объектом DataControlField.Gets or sets the schema associated with this DataControlField object.

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

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.Gets a value indicating whether the DataControlField object is saving changes to its view state.

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

Восстанавливает сохраненное раннее состояние представления поля источника данных.Restores the data control field's previously saved view state.

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

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

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

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

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

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

Дополнительно