次の方法で共有


ImageField クラス

定義

データ バインド コントロール内に画像として表示されるフィールドを表します。

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
継承

次の例では、コントロール内の オブジェクトを 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、表示される各レコードの画像を表示するために、データ バインド コントロール (や DetailsViewなどGridView) によって使用されます。 オブジェクトは ImageField 、使用されているデータ バインド コントロールによって異なる方法で表示されます。 たとえば、コントロールは GridView オブジェクトを ImageField 列として表示し、コントロールは DetailsView オブジェクトを行として表示します。

イメージを表示するには、イメージの URL を ImageField 含むデータ ソースのフィールドにオブジェクトをバインドする必要があります。 これを行うには、 プロパティを設定します DataImageUrlField 。 URL 値は、 プロパティを使用 DataImageUrlFormatString して書式設定できます。 各画像には、代替テキストを関連付けることもできます。 このテキストは、イメージを読み込めない場合、または使用できない場合に表示されます。 ツールヒント機能をサポートするブラウザーでも、このテキストがツールヒントとして表示されます。 次のいずれかの方法を使用して、表示される画像の代替テキストを指定できます。

  • プロパティを AlternateText 使用して、すべての画像に適用される代替テキストを指定します。

  • データ ソースの DataAlternateTextField フィールドを各イメージの プロパティにバインドするには、 プロパティを AlternateText 使用します。 これにより、表示される画像ごとに異なる代替テキストを使用できます。 データをバインドする場合は、 プロパティを使用して代替テキストの書式を DataAlternateTextFormatString 設定することもできます。

イメージの URL 値が の場合、 nullイメージを表示できません。 プロパティを設定することで、フィールド値の null 代替イメージを NullImageUrl 表示できます。 代替イメージの代わりに、 プロパティを設定することで代替テキストを NullDisplayText 表示できます。

既定では、宣言されたすべてのフィールドがデータ バインド コントロールに表示されます。 プロパティを にImageField設定することで、データ バインド コントロール内のオブジェクトをVisiblefalse非表示にすることができます。

オブジェクトのヘッダーセクションとフッターセクションを ImageField カスタマイズできます。 ヘッダーセクションまたはフッターセクションにキャプションを表示するには、 または FooterText プロパティをそれぞれ設定HeaderTextします。 テキストの代わりにヘッダー セクションに画像を表示するには、 プロパティを HeaderImageUrl 設定します。 ヘッダー セクションは、 プロパティを に ImageField 設定することで、オブジェクトで ShowHeader 非表示にすることができます false

Note

一部のデータ バインド コントロール (コントロールなど) では、コントロールの 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)

適用対象

こちらもご覧ください