ImageField Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет поле, которое отображается как изображение в элементе управления с привязкой к данным.
public ref class ImageField : System::Web::UI::WebControls::DataControlFieldpublic class ImageField : System.Web.UI.WebControls.DataControlFieldtype ImageField = class
inherit DataControlFieldPublic Class ImageField
Inherits DataControlField- Наследование
Примеры
В следующем примере показано, как использовать ImageField объект в элементе 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>ImageField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageField Example</h3>
<asp:gridview id="EmployeesGrid"
autogeneratecolumns="false"
datasourceid="EmployeeSource"
runat="server">
<columns>
<asp:imagefield dataimageurlfield="PhotoPath"
alternatetext="Employee Photo"
nulldisplaytext="No image on file."
headertext="Photo"
readonly="true"/>
<asp:boundfield datafield="FirstName"
headertext="First Name"/>
<asp:boundfield datafield="LastName"
headertext="Last Name"/>
</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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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>ImageField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>ImageField Example</h3>
<asp:gridview id="EmployeesGrid"
autogeneratecolumns="false"
datasourceid="EmployeeSource"
runat="server">
<columns>
<asp:imagefield dataimageurlfield="PhotoPath"
alternatetext="Employee Photo"
nulldisplaytext="No image on file."
headertext="Photo"
readonly="true"/>
<asp:boundfield datafield="FirstName"
headertext="First Name"/>
<asp:boundfield datafield="LastName"
headertext="Last Name"/>
</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="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Комментарии
Класс ImageField используется элементами управления с привязкой к данным (такими как GridView и DetailsView) для отображения изображения для каждой отображаемой записи. Объект ImageField отображается по-разному в зависимости от элемента управления с привязкой к данным, в котором он используется. Например, GridView элемент управления отображает ImageField объект в виде столбца, а DetailsView элемент управления — в виде строки.
Для отображения изображений необходимо привязать ImageField объект к полю из источника данных, содержащего URL-адрес изображения. Для этого задается DataImageUrlField свойство . Значение URL-адреса можно отформатировать с помощью DataImageUrlFormatString свойства . С каждым изображением также может быть связан альтернативный текст. Этот текст отображается, когда не удается загрузить изображение или оно недоступно. Браузеры, поддерживающие функцию Подсказки, также отображают этот текст в виде подсказки. Альтернативный текст для отображаемого изображения можно указать одним из следующих способов:
Используйте свойство , AlternateText чтобы указать альтернативный текст, применимый ко всем изображениям.
Используйте свойство , DataAlternateTextField чтобы привязать поле из источника данных к свойству AlternateText каждого изображения. Это позволяет иметь разные альтернативные тексты для каждого отображаемого изображения. При привязке данных при необходимости можно отформатировать альтернативный текст с помощью DataAlternateTextFormatString свойства .
Если значение URL-адреса для изображения равно null, изображение не может быть отображено. Вы можете отобразить альтернативное изображение для null значений полей, задав NullImageUrl свойство . Вместо альтернативного изображения можно отобразить альтернативный текст, задав NullDisplayText свойство .
По умолчанию все объявленные поля отображаются в элементе управления с привязкой к данным. Вы можете скрыть ImageField объект в элементе управления с привязкой к данным, задав свойству Visible значение false.
Вы можете настроить разделы ImageField колонтитулов объекта . Чтобы отобразить заголовок в разделе колонтитулов, задайте HeaderText свойства или FooterText соответственно. Чтобы отобразить изображение в разделе заголовка вместо текста, задайте HeaderImageUrl свойство . Раздел заголовка можно скрыть в объекте , ImageField задав свойству ShowHeader значение false.
Примечание
Некоторые элементы управления с привязкой к данным (например, GridView элемент управления) могут отображать или скрывать только весь раздел заголовка элемента управления. Эти элементы управления с привязкой к данным не поддерживают ShowHeader свойство для отдельного поля с привязкой к данным. Чтобы отобразить или скрыть весь раздел заголовка элемента управления с привязкой к данным, используйте свойство элемента управления ShowHeader (если доступно).
Вы также можете настроить внешний вид объекта (цвет шрифта ImageField , цвет фона и т. д.), задав свойства стиля для различных частей поля. В следующей таблице перечислены различные свойства стиля.
| Свойство Style | Описание |
|---|---|
| ControlStyle | Параметры стиля для дочерних элементов управления ImageField веб-сервера объекта . |
| FooterStyle | Параметры стиля для нижнего колонтитула ImageField объекта. |
| HeaderStyle | Параметры стиля для раздела заголовка ImageField объекта. |
| ItemStyle | Параметры стиля для элементов данных в объекте ImageField . |
Конструкторы
| ImageField() |
Инициализирует новый экземпляр класса ImageField. |
Поля
| ThisExpression |
Представляет выражение "this". |
Свойства
| AccessibleHeaderText |
Возвращает или задает текст, отображающийся как значение свойство |
| AlternateText |
Получает или задает текст, отображаемый для изображения в объекте ImageField. |
| Control |
Возвращает ссылку на элемент управления данными, с которым связан объект DataControlField. (Унаследовано от DataControlField) |
| ControlStyle |
Получает стиль любых серверных веб-элементов управления, содержащихся в объекте DataControlField. (Унаследовано от DataControlField) |
| ConvertEmptyStringToNull |
Получает или задает значение, определяющее, следует ли преобразовывать пустые строки ("") в |
| DataAlternateTextField |
Получает или задает имя поля из источника данных, содержащего значения для привязки к свойству AlternateText каждого изображения объекта ImageField. |
| DataAlternateTextFormatString |
Получает или задает строку, указывающую формат, в котором передается альтернативный текст для каждого изображения в объекте ImageField. |
| DataImageUrlField |
Получает или задает имя поля из источника данных, содержащего значения для привязки к свойству ImageUrl каждого изображения объекта ImageField. |
| DataImageUrlFormatString |
Получает или задает строку, указывающую формат, в котором передается URL-адрес для каждого изображения в объекте ImageField. |
| DesignMode |
Возвращает значение, указывающее, просматривается ли в данный момент поле элемента управления данными в среде режима разработки. (Унаследовано от DataControlField) |
| FooterStyle |
Возвращает или задает стиль нижнего колонтитула поля элемента управления данными. (Унаследовано от DataControlField) |
| FooterText |
Возвращает или задает текст для отображения в нижнем колонтитуле поля элемента управления данными. (Унаследовано от DataControlField) |
| HeaderImageUrl |
Возвращает или задает URL -адрес изображения для отображения в верхнем колонтитуле поля элемента управления данными. (Унаследовано от DataControlField) |
| HeaderStyle |
Возвращает или задает стиль верхнего колонтитула поля элемента управления данными. (Унаследовано от DataControlField) |
| HeaderText |
Возвращает или задает текст для отображения в верхнем колонтитуле поля элемента управления данными. (Унаследовано от DataControlField) |
| InsertVisible |
Возвращает значение, указывающее состояние отображения объекта DataControlField во время пребывания его родительского элемента управления, привязанного к данным, в режиме вставки. (Унаследовано от DataControlField) |
| IsTrackingViewState |
Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления. (Унаследовано от DataControlField) |
| ItemStyle |
Возвращает стиль любого текстового содержимого, отображаемого полем элемента управления содержанием. (Унаследовано от DataControlField) |
| NullDisplayText |
Получает или задает текст для отображения в объекте ImageField, когда значение поля, указанного свойством DataImageUrlField равно |
| NullImageUrl |
Получает или задает URL-адрес альтернативного изображения в объекте ImageField, когда значение поля, указанного свойством DataImageUrlField, равно |
| ReadOnly |
Получает или задает значение, определяющее возможность изменения значений, указанных в свойстве DataImageUrlField. |
| ShowHeader |
Возвращает или задает значение, указывающее на необходимость отображения верхнего колонтитула для поля элемента управления данными. (Унаследовано от DataControlField) |
| SortExpression |
Возвращает или задает выражение сортировки, используемое элементом управления источником данных для сортировки данных. (Унаследовано от DataControlField) |
| ValidateRequestMode |
Получает или задает значение, указывающее, проверяет ли элемент управления клиентский ввод. (Унаследовано от DataControlField) |
| ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта DataControlField при нескольких запросах одной и той же страницы. (Унаследовано от DataControlField) |
| Visible |
Возвращает или задает значение, определяющее, отображается ли поле элемента управления данными. (Унаследовано от DataControlField) |
Методы
| CloneField() |
Создает точную копию текущего объекта, производного от DataControlField. (Унаследовано от DataControlField) |
| CopyProperties(DataControlField) |
Копирует свойства текущего объекта ImageField в указанный объект. |
| CreateField() |
Возвращает новый экземпляр класса ImageField. |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Заполняет указанный объект IOrderedDictionary значениями из указанного объекта DataControlFieldCell. |
| FormatImageUrlValue(Object) |
Применяет формат, определенный свойством DataImageUrlFormatString к значению поля. |
| GetDesignTimeValue() |
Возвращает значение, используемое для значения поля при отрисовке объекта ImageField в конструкторе. |
| GetFormattedAlternateText(Control) |
Применяет формат, определенный свойством DataAlternateTextFormatString к значению альтернативного текста, содержащемуся в указанном объекте Control. |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| GetValue(Control, String, PropertyDescriptor) |
Получает значение указанного поля из указанного элемента управления. |
| Initialize(Boolean, Control) |
Выполняет инициализацию объекта ImageField. |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Инициализирует указанный объект DataControlFieldCell с указанным типом ячейки, состоянием строки и ее индексом. |
| InitializeDataCell(DataControlFieldCell, DataControlRowState) |
Инициализирует указанный объект DataControlFieldCell с указанным состоянием строки. |
| LoadViewState(Object) |
Восстанавливает сохраненное раннее состояние представления источника данных. (Унаследовано от DataControlField) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| OnDataBindField(Object, EventArgs) |
Привязывает значение поля к указанному объекту ImageField. |
| OnFieldChanged() |
Вызывает событие |
| SaveViewState() |
Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер. (Унаследовано от DataControlField) |
| ToString() |
Возврат строки, представляющей объект DataControlField. (Унаследовано от DataControlField) |
| TrackViewState() |
Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы. (Унаследовано от DataControlField) |
| ValidateSupportsCallback() |
Определяет поддержку ответов элементами управления, содержащимися в объекте ImageField. |
Явные реализации интерфейса
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Возвращает или задает схему, связанную с этим объектом DataControlField. (Унаследовано от DataControlField) |
| IStateManager.IsTrackingViewState |
Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления. (Унаследовано от DataControlField) |
| IStateManager.LoadViewState(Object) |
Восстанавливает сохраненное раннее состояние представления поля источника данных. (Унаследовано от DataControlField) |
| IStateManager.SaveViewState() |
Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер. (Унаследовано от DataControlField) |
| IStateManager.TrackViewState() |
Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы. (Унаследовано от DataControlField) |
