Share via

AdRotator 웹 서버 컨트롤 선언 구문

  • 아티클

업데이트: 2007년 11월

Web Forms 페이지에 광고 배너를 표시하는 컨트롤입니다.

<asp:AdRotator
    AccessKey="string"
    AdvertisementFile="uri"
    AlternateTextField="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageUrlField="string"
    KeywordFilter="string"
    hrefField="string"
    OnAdCreated="AdCreated event handler"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    ToolTip="string"
    Visible="True|False"
    Width="size"
/>

설명

AdRotator 컨트롤은 Web Forms 페이지에 광고 배너를 표시합니다. 이 컨트롤은 앵커 컨트롤 내의 ImageUrl 요소에 지정된 이미지를 표시합니다. 런타임에 AdRotator 컨트롤은 <asp:HyperLink> 및 <asp:Image> 컨트롤을 사용하여 Web Forms 페이지에서 컨트롤을 렌더링합니다. 소스 이미지의 크기는 실제 크기에 관계없이 브라우저에서 AdRotator 컨트롤 크기에 따라 조정됩니다.

AdvertisementFile 속성을 설정하면 <Impressions> 요소의 값에 따라 파일에서 광고가 선택됩니다. 그런 다음 이벤트 인수가 설정되고 AdCreated 이벤트가 발생합니다. AdvertisementFile 속성을 설정하지 않으면 AdCreated 이벤트가 발생할 때 이벤트 인수가 비어 있습니다. 이벤트 인수는 AdRotator 컨트롤을 렌더링할 때 사용되므로 광고 파일에서 이벤트에 전달하는 값을 수정하거나 직접 생성한 값으로 설정할 수 있습니다. 일반적으로는 데이터베이스에서 검색한 값을 사용하여 이벤트 인수를 채웁니다.

다음은 광고 파일을 만들 때 고려할 사항입니다.

  • 광고 파일의 XML은 올바른 형식이어야 합니다.

  • AdRotator 컨트롤은 파일의 첫 번째 <Advertisements> 요소만 구문 분석합니다. 파일에서 다른 <Advertisements> 요소는 모두 무시됩니다.

  • 광고의 XML 설명에 사용자 지정 요소를 추가할 수 있습니다. 이러한 값은 AdProperties 사전 속성의 AdCreated 이벤트에 전달됩니다.

AdCreated 이벤트를 사용하여 코드에서 광고를 직접 선택하거나 광고 파일에서 선택한 광고의 렌더링을 수정할 수 있습니다. 광고 파일을 설정하는 경우 AdCreated 이벤트의 인수는 해당 이벤트를 호출할 때 선택된 광고로 이미 설정되어 있습니다. 값이 이미 설정되어 있는지 여부에 관계없이 ImageUrl, href 및 AlternateText 속성의 값을 수정하여 AdRotator 컨트롤의 렌더링을 수정할 수 있습니다. 광고의 XML 설명에 추가된 사용자 지정 요소는 AdCreatedEventArgs.AdProperties 사전 속성에서 사용할 수 있습니다.

AdRotator 컨트롤의 속성과 이벤트에 대한 자세한 내용은 AdRotator 설명서를 참조하십시오.

광고 파일 형식

AdRotator 컨트롤은 표시할 이미지의 위치와 연결할 페이지의 URL 같은 광고 정보를 별도의 XML 광고 파일에 저장합니다. AdRotator 컨트롤의 AdvertisementFile 속성은 이 파일의 경로를 지정합니다.

광고 파일을 만드는 경우에는 열기 및 닫기 <Advertisements> 태그를 사용하여 각각 파일의 시작과 끝을 나타냅니다. 열기 및 닫기 <Ad> 태그는 각 광고를 구분합니다. 모든 광고는 열기 및 닫기 <Advertisements> 태그 사이에 중첩됩니다. 파일에 <Advertisements> 태그가 여러 개 포함된 경우 AdRotator 컨트롤은 파일의 첫 번째 <Advertisements> 태그 집합만 구문 분석합니다. 다른 <Advertisements> 태그는 모두 무시됩니다.

각 광고에 대한 데이터 요소는 열기 및 닫기 <Ad> 태그 사이에 중첩됩니다. ImageUrl 및 href과 같은 특정 데이터 요소는 미리 정의되어 있지만 <Ad> 태그 사이에 사용자 지정 요소를 추가할 수도 있습니다. AdRotator 컨트롤에서는 파일을 구문 분석할 때 이러한 요소를 읽습니다. 그런 다음 AdProperties 사전 속성의 AdCreated 이벤트에 정보가 전달됩니다.

다음 표에는 XML 광고 파일을 위해 미리 정의된 데이터 요소의 목록이 나와 있습니다.

요소

설명

<ImageUrl>

이미지 파일의 절대 또는 상대 URL(옵션)

<href>

사용자가 광고를 클릭하면 연결되는 페이지의 URL(옵션)

참고

이 요소를 설정하지 않으면 앵커 태그에서 HRef 속성이 렌더링되지 않습니다.

<AlternateText>

ImageUrl 속성에 지정한 이미지를 사용할 수 없는 경우 이미지 대신 표시할 텍스트(옵션)

일부 브라우저에서는 이 텍스트가 광고의 ToolTip으로도 표시됩니다.

<Keyword>

예를 들면 "컴퓨터"처럼 필터링 기준으로 사용할 수 있는 광고 범주(옵션)

<Impressions>

광고 회전 주기에서 파일의 다른 광고와 비교하여 중요도를 나타내는 값(옵션)

숫자가 클수록 광고는 좀 더 자주 표시됩니다. XML 파일에서 모든 <Impressions> 값의 합계는 2,047,999,999를 초과할 수 없습니다. 이 값을 초과할 경우에는 AdRotator 컨트롤에서 런타임 예외를 throw합니다.

XML 광고 파일의 형식은 다음과 같습니다.

<Advertisements>
   <Ad>
      <ImageUrl>
         URL of image to display for Advertisement #1
      </ImageUrl>
      <href>
         URL of page to link to for Advertisement #1
      </href>
      <AlternateText>
         Text to show as a ToolTip for Advertisement #1
      </AlternateText>
      <Keyword>
         Keyword used to filter for Advertisement #1
      </Keyword>
      <Impressions>
         Relative importance of Advertisement #1
      </Impressions>
      <CustomInformation>
         Custom Data about Advertisement #1
      </CustomInformation>
   </Ad>
</Advertisements>

예제

다음 예제에서는 .aspx 파일에 AdRotator 컨트롤을 선언하는 방법을 보여 줍니다.

<html>
 
   <head>
   </head>
 
<body>
   <form runat="server">
 
      <h3>AdRotator Example</h3>
 
      <asp:AdRotator id="AdRotator1"
           Target="_self"
           AdvertisementFile="Ads.xml"
           runat="server"/>
 
   </form>
</body>
 
</html>

다음 예제에서는 AdCreated 이벤트에 대한 이벤트 처리기를 만들어 href 속성의 값을 프로그래밍 방식으로 재정의하는 방법을 보여 줍니다.

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

<html>
<head>

   <script runat="server">
   
      Sub AdCreated_Event(sender As Object, e As AdCreatedEventArgs) 

         e.href = "https://www.microsoft.com"   
       
      End Sub      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdRotator 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.href = "https://www.microsoft.com";   
       
      }      

   </script>
 
</head>
 
<body>
 
   <form runat="server">
 
      <h3>AdRotator Example</h3>
 
      <asp:AdRotator id="AdRotator1" runat="server"
           AdvertisementFile = "Ads.xml"
           Target="_newwwindow"
           OnAdCreated="AdCreated_Event"/>
 
   </form>
 
</body>
</html>

아래 예제에서는 XML 광고 파일의 서식 지정 방법을 보여 줍니다.

<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>Wing Tip Toys</AlternateText>
      <Impressions>80</Impressions>
      <Keyword>Topic2</Keyword>
      <Caption>This is the caption for Ad#2</Caption> 
   </Ad>
 
</Advertisements>

참고 항목

참조

AdRotator

기타 리소스

웹 서버 컨트롤 구문