ImageField.AlternateText-Eigenschaft
Assembly: System.Web (in system.web.dll)
/** @property */ public String get_AlternateText () /** @property */ public void set_AlternateText (String value)
public function get AlternateText () : String public function set AlternateText (value : String)
Nicht zutreffend.
Eigenschaftenwert
Der alternative Text für ein im ImageField-Objekt angezeigtes Bild. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt wurde.Geben Sie mithilfe der AlternateText-Eigenschaft den alternativen Text für die in einem ImageField-Objekt angezeigten Bilder an. Der alternative Text wird angezeigt, wenn ein Bild nicht geladen werden kann oder nicht verfügbar ist. In Browsern, die das QuickInfo-Feature unterstützen, wird dieser Text auch als QuickInfo angezeigt.
 Hinweis: |
|---|
| Wenn diese Eigenschaft festgelegt ist, wird für alle in einem ImageField-Objekt angezeigten Bilder derselbe alternative Text verwendet. Sie können den alternativen Text auch an ein Feld in einer Datenquelle binden, indem Sie die DataAlternateTextField-Eigenschaft statt dieser Eigenschaft festlegen. Damit können Sie für jedes angezeigte Bild einen anderen alternativen Text angeben. Wenn sowohl die AlternateText-Eigenschaft als auch die DataAlternateTextField-Eigenschaft festgelegt ist, hat die DataAlternateTextField-Eigenschaft Vorrang. |
Der Wert dieser Eigenschaft kann, sofern festgelegt, mithilfe eines Designertools automatisch in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und ASP.NET-Globalisierung und -Lokalisierung.
Im folgenden Beispiel wird veranschaulicht, wie mithilfe der AlternateText-Eigenschaft der alternative Text für alle in einem ImageField-Objekt angezeigten Bilder angegeben wird.
<%@ 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>
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.