ImageField クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ バインド コントロール内に画像として表示されるフィールドを表します。
public ref class ImageField : System::Web::UI::WebControls::DataControlFieldpublic class ImageField : System.Web.UI.WebControls.DataControlFieldtype ImageField = class
inherit DataControlFieldPublic 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 |
一部のコントロールの |
| AlternateText |
ImageField オブジェクトに、イメージの代わりに表示される代替テキストを取得または設定します。 |
| Control |
DataControlField オブジェクトが関連付けられているデータ コントロールの参照を取得します。 (継承元 DataControlField) |
| ControlStyle |
DataControlField オブジェクトに格納されているすべての Web サーバー コントロールのスタイルを取得します。 (継承元 DataControlField) |
| ConvertEmptyStringToNull |
データ ソースから返されたフィールド値が空の文字列 ("") であった場合、 |
| 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 プロパティで指定されたフィールドの値が |
| NullImageUrl |
ImageField プロパティで指定されたフィールドの値が |
| ReadOnly |
DataImageUrlField プロパティで指定されたフィールドの値を編集モードで変更できるかどうかを示す値を取得または設定します。 |
| ShowHeader |
データ コントロール フィールドのヘッダー項目を表示するかどうかを示す値を取得または設定します。 (継承元 DataControlField) |
| SortExpression |
データ ソース コントロールでデータを並べ替えるために使用される並べ替え式を、取得または設定します。 (継承元 DataControlField) |
| ValidateRequestMode |
コントロールでクライアントの入力を検証するかどうかを指定する値を取得または設定します。 (継承元 DataControlField) |
| ViewState |
同一のページに対する複数の要求にわたって、DataControlField オブジェクトのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。 (継承元 DataControlField) |
| Visible |
データ コントロール フィールドを表示するかどうかを示す値を取得または設定します。 (継承元 DataControlField) |
メソッド
明示的なインターフェイスの実装
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
DataControlField オブジェクトに関連付けられているスキーマを取得または設定します。 (継承元 DataControlField) |
| IStateManager.IsTrackingViewState |
DataControlField オブジェクトがビューステートへの変更を保存しているかどうかを示す値を取得します。 (継承元 DataControlField) |
| IStateManager.LoadViewState(Object) |
データ コントロール フィールドの、以前保存したビューステートを復元します。 (継承元 DataControlField) |
| IStateManager.SaveViewState() |
ページがサーバーにポストバックされた時間以降に発生した、DataControlField ビューステートへの変更を保存します。 (継承元 DataControlField) |
| IStateManager.TrackViewState() |
DataControlField オブジェクトがそのビューステートの変更を追跡するようにします。それにより、変更をコントロールの ViewState プロパティに格納して、同じページに対する複数の要求にわたって永続化できます。 (継承元 DataControlField) |
適用対象
こちらもご覧ください
.NET