ImageField.DataImageUrlField プロパティ

.NET Framework クラス ライブラリ リファレンス

ImageField.DataImageUrlField プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ImageField オブジェクトの各イメージの ImageUrl プロパティにバインドする、データ ソース内のフィールド名を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 DataImageUrlField As String

Visual Basic (使用法)

Dim instance As ImageField
Dim value As String

value = instance.DataImageUrlField

instance.DataImageUrlField = value

C#

public virtual string DataImageUrlField { get;
 set; }

C++

public:
virtual property String^ DataImageUrlField {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_DataImageUrlField ()

/** @property */
public void set_DataImageUrlField (String value)

JScript

public function get DataImageUrlField
 () : String

public function set DataImageUrlField
 (value : String)

プロパティ値
ImageField オブジェクトの各イメージの ImageUrl プロパティにバインドするフィールドの名前。

解説

ImageField オブジェクトの各イメージの ImageUrl プロパティにバインドするフィールド名を指定するには、DataImageUrlField プロパティを使用します。指定するフィールドには、ImageField オブジェクトに表示するイメージの URL が格納されている必要があります。DataImageUrlFormatString プロパティを設定することにより、URL 値に書式を適用することもできます (省略可能)。

メモ
フィールド値が null 参照 (Visual Basic では Nothing) の場合、イメージは表示されません。null 参照 (Visual Basic では Nothing) のフィールド値に対して代替イメージを表示するには、NullImageUrl プロパティを設定します。代替イメージではなく、代替テキストが表示されるようにするには、NullDisplayText プロパティを設定します。

使用例

DataImageUrlField プロパティを使用して、ImageField オブジェクトの各イメージの ImageUrl プロパティにバインドするフィールド名を指定する方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" %>

<html>
  <body>
    <form runat="server">
        
      <h3>ImageField Example</h3>
                       
      <asp:gridview id="EmployeesGrid"
        autogeneratecolumns="false"
        datasourceid="EmployeeSource"  
        runat="server">
      
        <columns>

          <asp:imagefield dataimageurlfield="LastName"
            dataimageurlformatstring="~\Images\{0}.jpg"
            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]
 From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

C#

<%@ Page language="C#" %>

<html>
  <body>
    <form runat="server">
        
      <h3>ImageField Example</h3>
                       
      <asp:gridview id="EmployeesGrid"
        autogeneratecolumns="false"
        datasourceid="EmployeeSource"  
        runat="server">
      
        <columns>

          <asp:imagefield dataimageurlfield="LastName"
            dataimageurlformatstring="~\Images\{0}.jpg"
            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] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
            
    </form>
  </body>
</html>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ImageField クラス
ImageField メンバ
System.Web.UI.WebControls 名前空間
DataImageUrlFormatString
ImageField.AlternateText プロパティ
ImageField.DataAlternateTextField プロパティ
NullImageUrl
NullDisplayText