AdCreatedEventArgs.AlternateText Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den alternativen Text ab, der im AdRotator-Steuerelement angezeigt wird, wenn das Bild für die Werbung nicht verfügbar ist, oder legt diesen fest. In Browsern, die das QuickInfo-Feature unterstützen, wird dieser Text als QuickInfo für die Werbung angezeigt.

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

Eigenschaftswert

String

Der Text, der anstelle des Bilds für die Werbung angezeigt wird, wenn das Bild nicht verfügbar ist. Der Standardwert ist Empty.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die AlternateText -Eigenschaft programmgesteuert festgelegt wird.

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

Im folgenden Codebeispiel wird veranschaulicht, wie die XML-Datei formatiert wird, die die Ankündigungsinformationen enthält. Weitere Informationen zur XML-Datei finden Sie in der AdvertisementFile -Eigenschaft der AdRotator -Klasse.

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

Hinweise

Verwenden Sie die AlternateText -Eigenschaft, um den Text anzugeben, der angezeigt werden soll, wenn das in der ImageUrl -Eigenschaft angegebene Bild nicht verfügbar ist. In Browsern, die das Feature QuickInfos unterstützen, wird dieser Text auch als QuickInfo für die Ankündigung angezeigt.

Eine separate XML-Datei enthält die Eigenschaften für die angezeigte Ankündigung. Das AdRotator -Steuerelement legt die AlternateText -Eigenschaft automatisch mit dem entsprechenden alternativen Texteintrag in der XML-Datei fest. Diese Eigenschaft kann auch verwendet werden, um den alternativen Text programmgesteuert festzulegen.

Gilt für:

Freigeben über