AdRotator.Target プロパティ

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

AdRotator コントロールがクリックされたときのリンク先 Web ページの内容を表示するブラウザーのウィンドウまたはフレームの名前を取得または設定します。

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; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Property Target As String

プロパティ値

String

AdRotator コントロールがクリックされたときのリンク先 Web ページの内容を表示するブラウザーのウィンドウまたはフレーム。 既定値は空の文字列 ("") です。フォーカスのあるウィンドウまたはフレームが更新されます。

属性
BindableAttribute TypeConverterAttribute

例

次のコード例では、 プロパティの使用方法 Target を示します。 フレームなしの新しいウィンドウでコントロールを AdRotator クリックすると、リンク先の Web ページの内容が表示されます。

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

次のコード例は、アドバタイズ情報を含む XML ファイルのファイル形式を示しています。 ファイル形式の詳細については、 メンバーを AdvertisementFile 参照してください。

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

注釈

コントロールが Target クリックされたときにリンクされている Web ページの内容を表示するターゲット ウィンドウまたはフレームを指定するには、 プロパティを AdRotator 使用します。

注意

プロパティは Target 属性として target レンダリングされます。 アンカー (a) 要素の属性はtarget、XHTML 1.1 では使用できません。 したがって、レンダリングされたマークアップが XHTML 標準に準拠している必要がある場合、またはアクセシビリティ標準に準拠している必要がある場合は、 プロパティを Target 設定しないでください。 詳細については、「 Visual Studio の XHTML 標準」および「Visual Studio と ASP.NET の ASP.NET とアクセシビリティ」を参照してください。

値は Target 、アンダースコアで始まる次の特殊な値を除き、A ~ Z の範囲の文字で始まる必要があります (大文字と小文字は区別されません)。

対象の値 説明
_blank フレームなしの新しいウィンドウに内容を表示します。
_parent 直前のフレームセットの親に内容を表示します。
_search 検索ペインに内容を表示します。
_self フォーカスのあるフレームに内容を表示します。
_top 最大化されたフレームなしのウィンドウに内容を表示します。

注意

ブラウザーのドキュメントを参照して、_search 値がサポートされているかどうか確認してください。 たとえば、Internet Explorer 5.0 以降ではターゲット値が _search サポートされています。

適用対象

こちらもご覧ください