ImageField.DataAlternateTextField Property
Gets or sets the name of the field from the data source that contains the values to bind to the AlternateText property of each image in an ImageField object.
Assembly: System.Web (in System.Web.dll)
<TypeConverterAttribute("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")> Public Overridable Property DataAlternateTextField As String
Property Value
Type: System.StringThe name of the field to bind the AlternateText property of each image in an ImageField object.
Use the DataAlternateTextField property to specify the name of the filed from the data source that contains the values to bind to the AlternateText property of each image in an ImageField object. The enables you to have different alternate text for each image displayed. The alternate text is displayed when an image cannot be loaded or is unavailable. Browsers that support the ToolTips feature also display this text as a ToolTip.
Note |
|---|
You can specify alternate text that applies to all images by setting the AlternateText property instead of this property. If both the AlternateText and DataAlternateTextField properties are set, the DataAlternateTextField field takes precedence. |
The following example code demonstrates how to use the DataAlternateTextField property to specify the name of the field from the data source that contains the values to bind to the AlternateText property of each image in an ImageField object.
<%@ 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" 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>
Available since 2.0
