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、表示される各レコードの画像を表示するために、データバインドコントロール (や 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)

適用対象