ImageField Класс

Определение

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

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

Важно!

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

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

public ref class ImageField : System::Web::UI::WebControls::DataControlField

public class ImageField : System.Web.UI.WebControls.DataControlField

type ImageField = class
    inherit DataControlField

Public Class ImageField
Inherits DataControlField

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

DataControlField
ImageField

Примеры

В следующем примере показано, как использовать 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	Возвращает или задает текст, отображаемый `AbbreviatedText` в качестве значения свойства в некоторых элементах управления. (Унаследовано от DataControlField)
AlternateText	Возвращает или задает альтернативный текст, отображаемый для изображения в объекте ImageField .
Control	Возвращает ссылку на элемент управления данными, DataControlField с которым связан объект. (Унаследовано от DataControlField)
ControlStyle	Возвращает стиль всех элементов управления веб-сервера, содержащихся в объекте DataControlField . (Унаследовано от DataControlField)
ConvertEmptyStringToNull	Возвращает или задает значение, указывающее, преобразуются `null` ли пустые строковые значения ("") в то время, когда значения полей возвращаются из источника данных.
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`null`.
NullImageUrl	Возвращает или задает URL-адрес альтернативного изображения, отображаемого в ImageField объекте, если значение поля, указанного свойством`null`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()	Вызывает событие `FieldChanged`. (Унаследовано от DataControlField)
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)

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

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

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

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

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