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 。 每个图像还可以有与之关联的备用文本。 当无法加载图像或不可用时，将显示此文本。 支持工具提示功能的浏览器还会将此文本显示为工具提示。 可以使用下列方法之一为显示的图像指定备用文本：

当图像的 URL 值为 null时，无法显示图像。 可以通过设置NullImageUrl属性来显示null字段值的备用图像。 可以通过设置 NullDisplayText 属性来显示备用文本，而不是备用图像。

默认情况下，所有声明的字段都显示在数据绑定控件中。 You can hide an ImageField object in a data-bound control by setting the Visible property to false.

可以自定义对象的页眉和页脚部分 ImageField 。 若要在页眉或页脚部分中显示标题，请分别设置 HeaderText 或 FooterText 属性。 若要在标题部分而不是文本中显示图像，请设置 HeaderImageUrl 属性。 通过将属性设置为 ShowHeader false，可以在对象中ImageField隐藏标头节。

备注

某些数据绑定控件 (（如 GridView 控件) ）只能显示或隐藏控件的整个标头部分。 这些数据绑定控件不支持 ShowHeader 单个数据绑定字段的属性。 若要显示或隐藏数据绑定控件的整个标头部分，请使用控件 ShowHeader 的属性 (（如果可用) ）。

还可以通过设置字段的不同部分的样式属性来自定义对象的外观 ImageField (字体颜色、背景色等) 。 下表列出了不同的样式属性。

Style 属性 说明
ControlStyle 对象的子 Web 服务器控件的 ImageField 样式设置。
FooterStyle 对象的页脚部分的 ImageField 样式设置。
HeaderStyle 对象的标头部分的 ImageField 样式设置。
ItemStyle 对象中数据项的 ImageField 样式设置。

构造函数

ImageField()

初始化 ImageField 类的新实例。

字段

ThisExpression

表示“this”表达式。

属性

AccessibleHeaderText

获取或设置某些控件中呈现为 AbbreviatedText 属性值的文本。

(继承自 DataControlField)
AlternateText

获取或设置为 ImageField 对象中的图像显示的备用文本。
Control

获取对数据控件的引用，该控件与 DataControlField 对象关联。

(继承自 DataControlField)
ControlStyle

获取 DataControlField 对象所包含的任何 Web 服务器控件的样式。

(继承自 DataControlField)
ConvertEmptyStringToNull

获取或设置一个值，用于指示在从数据源返回字段值时，空字符串 ("") 值是否转换为 null。
DataAlternateTextField

获取或设置数据源中某个字段的名称，该字段包含的值要绑定到 AlternateText 对象中每个图像的 ImageField 属性。
DataAlternateTextFormatString

获取或设置一个字符串，该字符串指定 ImageField 对象中每个图像的备用文本所呈现的格式。
DataImageUrlField

获取或设置数据源中某个字段的名称，该字段包含的值要绑定到 ImageUrl 对象中每个图像的 ImageField 属性。
DataImageUrlFormatString

获取或设置一个字符串，用于指定 ImageField 对象中每个图像的 URL 所呈现的格式。
DesignMode

获取一个值，该值指示数据控件字段当前是否在设计时环境中进行查看。

(继承自 DataControlField)
FooterStyle

获取或设置数据控件字段脚注的样式。

(继承自 DataControlField)
FooterText

获取或设置数据控件字段的脚注项中显示的文本。

(继承自 DataControlField)
HeaderImageUrl

获取或设置数据控件字段的标题项中显示的图像的 URL。

(继承自 DataControlField)
HeaderStyle

获取或设置数据控件字段标头的样式。

(继承自 DataControlField)
HeaderText

获取或设置数据控件字段的标题项中显示的文本。

(继承自 DataControlField)
InsertVisible

获取一个值，该值指示 DataControlField 对象在其父级数据绑定控件处于插入模式时是否可见。

(继承自 DataControlField)
IsTrackingViewState

获取一个值，该值指示 DataControlField 对象是否保存对其视图状态的更改。

(继承自 DataControlField)
ItemStyle

获取由数据控件字段显示的任何基于文本的内容的样式。

(继承自 DataControlField)
NullDisplayText

获取或设置当 ImageField 属性所指定的字段值为 null 时，将要显示在 DataImageUrlField 对象中的文本。
NullImageUrl

获取或设置在由 ImageField 属性所指定的字段值为 null 时，DataImageUrlField 对象中所显示的备用图像的 URL。
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)

适用于

另请参阅