ImageField.DataAlternateTextFormatString プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As ImageField Dim value As String value = instance.DataAlternateTextFormatString instance.DataAlternateTextFormatString = value
public: virtual property String^ DataAlternateTextFormatString { String^ get (); void set (String^ value); }
/** @property */ public String get_DataAlternateTextFormatString () /** @property */ public void set_DataAlternateTextFormatString (String value)
public function get DataAlternateTextFormatString () : String public function set DataAlternateTextFormatString (value : String)
ImageField オブジェクトの各イメージの代替テキストの表示書式を指定する文字列。既定値は空の文字列です ("")。この値は、代替テキストに適用される特定の書式が設定されていないことを示します。
解説ImageField オブジェクトに表示されるイメージの代替テキスト値にカスタム書式を指定するには、DataAlternateTextFormatString プロパティを使用します。
.gif) メモ |
|---|
| DataAlternateTextField プロパティを設定した場合に限り、書式指定文字列は適用されます。AlternateText プロパティが設定されている場合は適用されません。 |
これにより、フィールドに格納されていた元の値に修正を加えることができます。DataAlternateTextFormatString プロパティが設定されていない場合、代替テキスト値には特別な書式は一切適用されません。
書式指定文字列には、任意のリテラル文字列を使用でき、通常は、フィールド値のプレースホルダが含まれます。たとえば、"Item Value: {0}" という書式指定文字列があった場合、"{0}" のプレースホルダは、DataAlternateTextField プロパティによって指定されたフィールドの値と置き換えられます。書式指定文字列の残りの部分は、リテラル テキストとして表示されます。
プレースホルダは、{A:Bxx} の形式で、中かっこ ("{}") で囲まれた、コロン (":") 区切りの 2 つの部分から構成されます。コロンの前の値 (一般的な例での A) は 0 から始まるパラメータのリストのフィールド値インデックスを指定します。
コロンおよびコロンの後の値は省略可能です。コロンの後の文字 (一般的な例での B) には、値を表示する際に使用する書式を指定します。共通の書式を次の表に示します。
| C | |
| D | |
| E | |
| F | |
| G | |
| N | |
| X |
書式指定文字の後の値 (一般的な例での xx) は、表示する有効桁数または小数点を指定します。たとえば、書式指定文字列 "{0:F2}" を使用すると、2 桁の固定小数点数で表示されます。
使用例DataAlternateTextFormatString プロパティを使用して、ImageField オブジェクトのイメージに対する代替テキスト値に、カスタム書式を適用する方法を次のコード例に示します。
<%@ 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="PhotoPath" dataalternatetextfield="LastName" dataalternatetextformatstring="Photo: {0}" 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="C#" %> <html> <body> <form runat="server"> <h3>ImageField Example</h3> <asp:gridview id="EmployeesGrid" autogeneratecolumns="false" datasourceid="EmployeeSource" runat="server"> <columns> <asp:imagefield dataimageurlfield="PhotoPath" dataalternatetextfield="LastName" dataalternatetextformatstring="Photo: {0}" 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>
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- ImageField.DataAlternateTextFormatString プロパティのページへのリンク
