AdRotator.Target Proprietà

Definizione

Ottiene o imposta il nome della finestra o del frame del browser in cui è visualizzato il contenuto della pagina Web collegata quando si fa clic sul controllo AdRotator.Gets or sets the name of the browser window or frame that displays the contents of the Web page linked to when the AdRotator control is clicked.

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
member this.Target : string with get, set
Public Property Target As String

Valore della proprietà

Finestra o frame del browser in cui è visualizzato il contenuto della pagina Web collegata quando si fa clic sul controllo AdRotator.The browser window or frame that displays the contents of the Web page linked to when the AdRotator control is clicked. Il valore predefinito è una stringa vuota (""), a indicare che verrà eseguito l'aggiornamento della finestra o del frame attivo.The default value is an empty string (""), which refreshes the window or frame with focus.

Attributi

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la proprietà Target.The following code example demonstrates how to use the Target property. Visualizza il contenuto della pagina Web collegata quando si fa clic sul controllo AdRotator in una nuova finestra non incorniciata.It displays the contents of the Web page linked to when the AdRotator control is clicked in a new, unframed window.

<%@ 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>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </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>AdRotator Example</title>
</head>
 
 <body>
    <form id="form1" runat="server">
 
       <h3>AdRotator Example</h3>
 
       <asp:AdRotator id="AdRotator1" runat="server"
            Target="_self"
            AdvertisementFile="~/App_Data/Ads.xml"/>
 
    </form>
 </body>
 
 </html>

Nell'esempio di codice riportato di seguito viene illustrato il formato di file di un file XML che contiene informazioni sull'annuncio.The following code example demonstrates the file format for an XML file that contains advertisement information. Per ulteriori informazioni sul formato di file, vedere il membro AdvertisementFile.For more information on the file format, see the AdvertisementFile member.

<Advertisements>  
  <Ad>  
    <ImageUrl>~/Images/image1.jpg</ImageUrl>  
    <Height>60</Height>  
    <Width>190</Width>  
    <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>~/Images/image2.jpg</ImageUrl>  
    <Height>90</Height>  
    <Width>90</Width>  
    <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>  

Commenti

Utilizzare la proprietà Target per specificare la finestra o il frame di destinazione in cui viene visualizzato il contenuto della pagina Web collegata quando si fa clic sul controllo AdRotator.Use the Target property to specify the target window or frame that displays the contents of the Web page linked to when the AdRotator control is clicked.

Nota

Il rendering della proprietà Target viene eseguito come attributo target.The Target property renders as a target attribute . L'attributo target negli elementi Anchor (a) non è consentito in XHTML 1,1.The target attribute on anchor (a) elements is not allowed in XHTML 1.1. Se pertanto il markup di cui è stato eseguito il rendering deve essere conforme agli standard XHTML o deve essere conforme agli standard di accessibilità, non impostare la proprietà Target.Therefore, if rendered markup must conform to XHTML standards or must conform to accessibility standards, do not set the Target property. Per altre informazioni, vedere standard XHTML in Visual Studio e ASP.NET e accessibilità in visual studio e ASP.NET.For more information, see XHTML Standards in Visual Studio and ASP.NET and Accessibility in Visual Studio and ASP.NET.

Il valore Target deve iniziare con una lettera compresa tra a e Z (senza distinzione tra maiuscole e minuscole), ad eccezione dei seguenti valori speciali, che iniziano con un carattere di sottolineatura.The Target value must begin with a letter in the range of A to Z (case-insensitive), except for the following special values, which begin with an underscore.

Valore di destinazioneTarget value DescriptionDescription
_blank Visualizza il contenuto in una nuova finestra senza frame.Renders the content in a new window without frames.
_parent Visualizza il contenuto nell'elemento padre immediato del set di frame.Renders the content in the immediate frameset parent.
_search Visualizza il contenuto nel riquadro di ricerca.Renders the content in the search pane.
_self Consente di visualizzare il contenuto nel frame attivo.Renders the content in the frame with focus.
_top Visualizza il contenuto in tutta la finestra senza frame.Renders the content in the full window without frames.

Nota

Controllare nella documentazione relativa al browser se è supportato il valore _search.Check your browser documentation to determine whether the _search value is supported. Internet Explorer 5,0 o versione successiva, ad esempio, supporta il _search valore di destinazione.For example, Internet Explorer 5.0 or later supports the _search target value.

Si applica a

Vedi anche