AdCreatedEventArgs.AlternateText Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient ou définit le texte de remplacement affiché dans le contrôle AdRotator lorsque l'image de la publication n'est pas disponible. Les navigateurs qui prennent en charge la fonctionnalité Info-bulles affichent ce texte sous forme d'info-bulle pour la publication.

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

Valeur de propriété

String

Texte affiché à la place de l'image de la publication si l'image n'est pas disponible. La valeur par défaut est Empty.

Exemples

L’exemple de code suivant montre comment définir la AlternateText propriété par programmation.

<%@ 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>

L’exemple de code suivant montre comment mettre en forme le fichier XML qui contient les informations de publication. Pour plus d’informations sur le fichier XML, consultez la AdvertisementFile propriété de la AdRotator classe .

<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>

Remarques

Utilisez la AlternateText propriété pour spécifier le texte à afficher si l’image spécifiée dans la ImageUrl propriété n’est pas disponible. Dans les navigateurs qui prennent en charge la fonctionnalité Info-bulles, ce texte apparaît également sous la forme d’une info-bulle pour la publication.

Un fichier XML distinct contient les propriétés de la publication affichée. Le AdRotator contrôle définit automatiquement la AlternateText propriété avec l’entrée de texte de remplacement correspondante dans le fichier XML. Cette propriété peut également être utilisée pour définir par programmation le texte de remplacement.

S’applique à

Voir aussi