AdCreatedEventArgs.AlternateText-Eigenschaft

Artikel
08/20/2007

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.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Property AlternateText As String
'Usage
Dim instance As AdCreatedEventArgs
Dim value As String

value = instance.AlternateText

instance.AlternateText = value

public string AlternateText { get; set; }

public:
property String^ AlternateText {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_AlternateText ()

/** @property */
public void set_AlternateText (String value)

public function get AlternateText () : String

public function set AlternateText (value : String)

Eigenschaftenwert

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

Hinweise

Geben Sie mit der AlternateText-Eigenschaft den Text an, der angezeigt werden soll, wenn das in der ImageUrl-Eigenschaft angegebene Bild nicht verfügbar ist. In Browsern, die das QuickInfo-Feature unterstützen, wird dieser Text auch als QuickInfo für die Werbung angezeigt.

Eine separate XML-Datei enthält die Eigenschaften für die angezeigte Werbung. Das AdRotator-Steuerelement legt die AlternateText-Eigenschaft automatisch mit dem entsprechenden Eintrag für den alternativen Text in der XML-Datei fest. Diese Eigenschaft kann auch zum programmgesteuerten Festlegen des alternativen Texts verwendet werden.

Beispiel

Im folgenden Codebeispiel wird das programmgesteuerte Festlegen der AlternateText-Eigenschaft veranschaulicht.

<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
       Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 
       
          e.AlternateText = "New Alternate Text Value"   
       
       End Sub      

   </script>
 
</head>
 
<body>
 
   <form 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="C#" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
       void AdCreated_Event(Object sender, AdCreatedEventArgs e) 
       {

          e.AlternateText = "New Alternate Text Value";   
       
       }      

   </script>
 
</head>
 
<body>
 
   <form 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="JScript" AutoEventWireup="True" %>

<html>
<head>

   <script runat="server">
   
       function AdCreated_Event(sender, e : AdCreatedEventArgs) 
       {

          e.AlternateText = "New Alternate Text Value";   
       
       }      

   </script>
 
</head>
 
<body>
 
   <form 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 das Formatieren der XML-Datei veranschaulicht, die die Informationen zur Werbung enthält. Weitere Informationen zur XML-Datei finden Sie unter der AdvertisementFile-Eigenschaft der AdRotator-Schnittstelle.

 <Advertisements>
  <Ad>
  <ImageUrl>image1.jpg</ImageUrl>
  <href>https://www.microsoft.com</href>
  <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>
  <href>http://www.wingtiptoys.com</href>
  <AlternateText>Wingtip Toys</AlternateText>
  <Impressions>80</Impressions>
  <Keyword>Topic2</Keyword>
  <Caption>This is the caption for Ad#2</Caption> 
  </Ad>
 </Advertisements>

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

AdCreatedEventArgs-Klasse
AdCreatedEventArgs-Member
System.Web.UI.WebControls-Namespace
AdRotator
ImageUrl
AdvertisementFile
String.Empty

Freigeben über