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, когда значение поля, указанного свойством DataImageUrlField, равно null.
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)

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

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