AdRotator.Target プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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
プロパティ値
AdRotator コントロールがクリックされたときにリンクされている Web ページの内容を表示するブラウザー ウィンドウまたはフレーム。 既定値は空の文字列 ("") で、ウィンドウまたはフレームをフォーカスで更新します。
- 属性
例
次のコード例は、 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 プロパティを使用して、AdRotator コントロールがクリックされたときにリンクされた Web ページの内容を表示するターゲット ウィンドウまたはフレームを指定します。
注
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 ターゲット値がサポートされています。