AdCreatedEventArgs.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 in het AdRotator besturingselement wanneer de advertentieafbeelding niet beschikbaar is. Browsers die de functie ToolTips ondersteunen, geven deze tekst weer als knopinfo voor de advertentie.
public:
property System::String ^ AlternateText { System::String ^ get(); void set(System::String ^ value); };public string AlternateText { get; set; }member this.AlternateText : string with get, setPublic Property AlternateText As StringWaarde van eigenschap
De tekst die wordt weergegeven in plaats van de advertentieafbeelding als de afbeelding niet beschikbaar is. De standaardwaarde is Empty.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de AlternateText eigenschap programmatisch instelt.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!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>AdCreatedEventArgs AlternateText Example</title>
<script runat="server">
void AdCreated_Event(Object sender, AdCreatedEventArgs e)
{
e.AlternateText = "New Alternate Text Value";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>AdCreatedEventArgs AlternateText Example</h3>
<asp:AdRotator id="AdRotator1" runat="server"
AdvertisementFile = "Ads.xml"
Target="_newwwindow"
OnAdCreated="AdCreated_Event"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!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>AdCreatedEventArgs AlternateText Example</title>
<script runat="server">
Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs)
e.AlternateText = "New Alternate Text Value"
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>AdCreatedEventArgs AlternateText Example</h3>
<asp:AdRotator id="AdRotator1" runat="server"
AdvertisementFile = "Ads.xml"
Target="_newwwindow"
OnAdCreated="AdCreated_Event"/>
</form>
</body>
</html>
In het volgende codevoorbeeld ziet u hoe u het XML-bestand opmaken dat de advertentiegegevens bevat. Zie de AdvertisementFile eigenschap van de AdRotator klasse voor meer informatie over het XML-bestand.
<Advertisements>
<Ad>
<ImageUrl>image1.jpg</ImageUrl>
<NavigateUrl>http://www.microsoft.com</NavigateUrl>
<AlternateText>Microsoft Main Site</AlternateText>
<Impressions>80</Impressions>
<Keyword>Topic1</Keyword>
<Caption>This is the caption for Ad#1</Caption>
</Ad>
<Ad>
<ImageUrl>image2.jpg</ImageUrl>
<NavigateUrl>http://www.wingtiptoys.com</NavigateUrl>
<AlternateText>Wingtip Toys</AlternateText>
<Impressions>80</Impressions>
<Keyword>Topic2</Keyword>
<Caption>This is the caption for Ad#2</Caption>
</Ad>
</Advertisements>
Opmerkingen
Gebruik de AlternateText eigenschap om de tekst op te geven die moet worden weergegeven als de afbeelding die is opgegeven in de ImageUrl eigenschap niet beschikbaar is. In browsers die de functie ToolTips ondersteunen, wordt deze tekst ook weergegeven als knopinfo voor de advertentie.
Een afzonderlijk XML-bestand bevat de eigenschappen voor de weergegeven advertentie. Met AdRotator het besturingselement wordt de AlternateText eigenschap automatisch ingesteld met de bijbehorende alternatieve tekstvermelding in het XML-bestand. Deze eigenschap kan ook worden gebruikt om de alternatieve tekst programmatisch in te stellen.
