AdCreatedEventArgs.AlternateText Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví alternativní text zobrazený v ovládacím AdRotator prvku, když inzerovaný obrázek není k dispozici. Prohlížeče, které podporují funkci Popisy tlačítek, zobrazují tento text jako popis pro inzerování.
public:
property System::String ^ AlternateText { System::String ^ get(); void set(System::String ^ value); };
public string AlternateText { get; set; }
member this.AlternateText : string with get, set
Public Property AlternateText As String
Hodnota vlastnosti
Text zobrazený místo inzerovaného obrázku, pokud obrázek není k dispozici. Výchozí hodnota je Empty.
Příklady
Následující příklad kódu ukazuje, jak programově nastavit AlternateText vlastnost.
<%@ 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>
Následující příklad kódu ukazuje, jak formátovat soubor XML, který obsahuje informace o inzerovaném programu. Další informace o souboru XML naleznete AdvertisementFileAdRotator vlastnost třídy.
<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>
Poznámky
AlternateText Pomocí vlastnosti zadejte text, který se má zobrazit, pokud obrázek zadaný ve ImageUrl vlastnosti není k dispozici. V prohlížečích, které podporují funkci Popisy tlačítek, se tento text zobrazí také jako popis pro inzerování.
Samostatný soubor XML obsahuje vlastnosti pro zobrazenou inzerci. Ovládací AdRotator prvek automaticky nastaví AlternateText vlastnost s odpovídající alternativní textové položky v souboru XML. Tuto vlastnost lze také použít k programovému nastavení alternativního textu.