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)

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

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