ImageField 類別

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

表示在資料繫結控制項中顯示為影像的欄位。

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 將其顯示為數據列。

若要顯示影像，您必須從包含影像 URL 的資料來源將物件系結 ImageField 至欄位。這是藉由設定 DataImageUrlField 屬性來完成。 URL 值可以使用屬性來 DataImageUrlFormatString 格式化。每個影像也可以有與其相關聯的替代文字。無法載入影像或無法使用時，會顯示此文字。支援工具提示功能的瀏覽器也會將此文字顯示為工具提示。您可以使用下列其中一種方法來指定所顯示影像的替代文字：

AlternateText使用屬性來指定適用于所有影像的替代文字。
DataAlternateTextField使用屬性將欄位從資料來源系結至 AlternateText 每個影像的屬性。這可讓您針對每個顯示的影像使用不同的替代文字。系結資料時，您可以使用屬性選擇性地格式化替代文字 DataAlternateTextFormatString 。

當影像 null 的 URL 值為時，無法顯示影像。您可以藉由設定 NullImageUrl 屬性來顯示域值的替代影像 null 。您可以藉由設定 NullDisplayText 屬性來顯示替代文字，而不是替代影像。

根據預設，所有宣告的欄位都會顯示在資料繫結控制項中。您可以將屬性設定 Visible 為 false ，以隱藏 ImageField 資料繫結控制項中的物件。

您可以自訂物件的頁首和頁尾區段 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	取得或設定替代影像的 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)

適用於

ImageField 類別

定義

範例

備註

建構函式

欄位

屬性

方法

明確介面實作

適用於

另請參閱

意見反應

其他資源