ImageField.AlternateText Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de alternatieve tekst opgehaald of ingesteld die wordt weergegeven voor een afbeelding in het ImageField object.
public:
virtual property System::String ^ AlternateText { System::String ^ get(); void set(System::String ^ value); };public virtual string AlternateText { get; set; }member this.AlternateText : string with get, setPublic Overridable Property AlternateText As StringWaarde van eigenschap
De alternatieve tekst voor een afbeelding die in het ImageField object wordt weergegeven. De standaardwaarde is een lege tekenreeks (""), die aangeeft dat deze eigenschap niet is ingesteld.
Voorbeelden
In het volgende voorbeeld ziet u hoe u de AlternateText eigenschap gebruikt om de alternatieve tekst op te geven voor alle afbeeldingen die in een ImageField object worden weergegeven.
<%@ 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>
Opmerkingen
Gebruik de AlternateText eigenschap om de alternatieve tekst op te geven voor de afbeeldingen die in een ImageField object worden weergegeven. De alternatieve tekst wordt weergegeven wanneer een afbeelding niet kan worden geladen of niet beschikbaar is. Browsers die de functie ToolTips ondersteunen, geven deze tekst ook weer als knopinfo.
Note
Wanneer deze eigenschap is ingesteld, delen alle afbeeldingen die worden weergegeven in een ImageField object dezelfde alternatieve tekst. Als alternatief kunt u de alternatieve tekst koppelen aan een veld in een gegevensbron door de DataAlternateTextField eigenschap in te stellen in plaats van deze eigenschap. Hiermee kunt u verschillende alternatieve tekst hebben voor elke afbeelding die wordt weergegeven. Als zowel de eigenschappen AlternateText als de DataAlternateTextField eigenschappen zijn ingesteld, heeft de DataAlternateTextField eigenschap voorrang.
De waarde van deze eigenschap, wanneer deze is ingesteld, kan automatisch worden opgeslagen in een resourcebestand met behulp van een ontwerpprogramma. Zie en LocalizableAttribute voor meer informatie.
