AdRotator.AdvertisementFile 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls
어셈블리:
System.Web.dll

광고 정보를 포함하고 있는 XML 파일의 경로를 가져오거나 설정합니다.

public:
 property System::String ^ AdvertisementFile { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string AdvertisementFile { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.AdvertisementFile : string with get, set
Public Property AdvertisementFile As String

속성 값

String

광고 정보를 포함하고 있는 XML 파일의 위치입니다. 기본값은 빈 문자열("")입니다.

특성
BindableAttribute

예제

다음 코드 예제를 사용 AdvertisementFile 하는 방법에 설명 합니다 속성 광고 정보를 포함 하는 XML 파일의 위치를 지정 합니다.

<%@ 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 보급 파일의 파일 형식을 보여 냅니다.

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

설명

사용 된 AdvertisementFile 광고 정보를 포함 하는 XML 파일의 위치를 지정 하는 속성입니다. XML 파일은 동일한 웹 사이트에 있어야 합니다. 보안상의 이유로 배포에 대 한 동일한 웹 애플리케이션에 파일을 배치 하는 것이 좋습니다. 애플리케이션에 충분 한 신뢰 하는 경우 동일한 사이트에서 다른 애플리케이션에 있는 XML 파일에 액세스할 수만 됩니다.

이 속성을 절대 경로 또는 XML 파일에 상대적인 경로로 설정할 수 있습니다. 상대 경로를 사용하여 배포를 간소화합니다. 상대 경로를 사용하는 경우 해당 경로는 컨트롤이 포함된 페이지 또는 사용자 컨트롤의 위치를 기준으로 합니다 AdRotator .

AdvertisementFile 속성은 선택 사항입니다. 이벤트에서 프로그래밍 방식으로 광고를 설정할 AdCreated 수도 있습니다.

XML 파일에는 다음과 같은 미리 정의된 특성이 포함되어 있습니다. ImageUrl 특성만 필요합니다.

attribute 설명
ImageUrl 표시할 이미지의 URL입니다.
Height 이미지의 높이(픽셀)입니다(선택 사항).
Width 이미지의 너비(픽셀)입니다(선택 사항).
NavigateUrl 컨트롤을 클릭할 때 AdRotator 탐색할 페이지의 URL입니다.
AlternateText 이미지를 사용할 수 없는 경우 표시할 텍스트입니다. 일부 브라우저에서는 이 텍스트가 도구 설명으로 표시됩니다.
Keyword 광고의 범주입니다. 컨트롤에서 특정 범주에 AdRotator 대한 광고 목록을 필터링하는 데 사용됩니다.
Impressions XML 파일의 다른 광고와 관련하여 보급 알림이 표시되는 빈도를 나타내는 값입니다.

참고

및 NavigateUrl 특성은 ImageUrl 전체 URL, 루트 상대 경로 또는 상대 경로일 수 있습니다. 루트 상대 경로를 사용하는 경우 경로는 동일한 웹 사이트를 기준으로 합니다. 상대 경로를 사용하는 경우 경로는 보급 알림 파일이 포함된 디렉터리를 기준으로 합니다.

XML 파일에서 사용자 지정 태그를 사용하여 사용자 지정 특성을 포함할 수도 있습니다. 모든 특성 태그는 보급 알림 파일에서 구문 분석되고 값은 사전에 배치 AdProperties 됩니다. 사전을 AdProperties 사용하여 프로그래밍 방식으로 사용자 지정 특성에 액세스할 수 있습니다.

이 파일의 정보는 컨트롤에서 유효성을 AdRotator 검사하지 않습니다. 광고가 악의적인 스크립트를 실행하지 못하도록 하려면 데이터를 공개하기 전에 항상 검사 신뢰할 수 있는 출처의 광고 정보만 수락해야 합니다.

무단 인터넷 액세스로부터 광고 파일을 보호하려면 다음 중 하나 이상을 수행합니다.

  • 모든 형식의 파일에 대한 인터넷 액세스를 거부하도록 Machine.config 구성된 데이터 디렉터리에 저장합니다.
  • .xml 않은 확장명으로 파일 이름을 바꾸고 Web.config 확장 HttpForbiddenHandler 자를 에 매핑합니다. 자세한 내용은 Machine.config 파일의 httpHandlers 섹션을 참조하세요.

적용 대상

추가 정보