Aracılığıyla paylaş

AdRotator.AdvertisementFile Özellik

Tanım

Ad Alanı:
System.Web.UI.WebControls
Bütünleştirilmiş Kod:
System.Web.dll

Reklam bilgilerini içeren bir XML dosyasının yolunu alır veya ayarlar.

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

Özellik Değeri

String

Reklam bilgilerini içeren bir XML dosyasının konumu. Varsayılan değer boş bir dizedir ("").

Öznitelikler
BindableAttribute

Örnekler

Aşağıdaki kod örneği, tanıtım bilgilerini içeren XML dosyasının konumunu belirtmek için özelliğinin nasıl kullanılacağını AdvertisementFile gösterir.

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

Aşağıdaki kod örneği, XML tanıtım dosyasının dosya biçimini gösterir.

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

Açıklamalar

AdvertisementFile Reklam bilgilerini içeren bir XML dosyasının konumunu belirtmek için özelliğini kullanın. XML dosyası aynı Web sitesinde bulunmalıdır. Dağıtım ve güvenlik amacıyla, dosyayı aynı Web uygulamasına yerleştirmeniz kesinlikle önerilir. Yalnızca uygulama yeterli güvene sahipse aynı sitedeki farklı bir uygulamada bulunan bir XML dosyasına erişmek mümkündür.

Bu özelliği, XML dosyasına göre mutlak bir yol veya yol olarak ayarlayabilirsiniz. Dağıtımı basitleştirmek için göreli bir yol kullanın. Göreli yol kullanırsanız, bu yol denetimi içeren sayfanın veya kullanıcı denetiminin konumuna göredir AdRotator .

AdvertisementFile özelliği isteğe bağlıdır. Etkinlikte AdCreated program aracılığıyla bir reklam da ayarlanabilir.

XML dosyası aşağıdaki önceden tanımlanmış öznitelikleri içerir. ImageUrl Yalnızca özniteliği gereklidir.

Özellik Açıklama
ImageUrl Görüntülenecek görüntünün URL'si.
Height Görüntünün piksel cinsinden yüksekliği (isteğe bağlı).
Width Görüntünün piksel cinsinden genişliği (isteğe bağlı).
NavigateUrl Denetime tıklandığında gidilen sayfanın URL'si AdRotator .
AlternateText Görüntü kullanılamıyorsa görüntülenecek metin. Bazı tarayıcılarda bu metin Araç İpucu olarak görüntülenir.
Keyword Reklamın kategorisi. Bu, denetim tarafından AdRotator belirli bir kategoriye ait reklam listesini filtrelemek için kullanılır.
Impressions XML dosyasındaki diğer tanıtımlarla ilişkili olarak bir reklamın ne sıklıkta görüntülendiğini gösteren değer.

Uyarı

ImageUrl ve NavigateUrl öznitelikleri tam URL, kök göreli yol veya göreli yol olabilir. Kök göreli yol kullanıyorsanız, yol aynı Web sitesine göredir. Göreli yol kullanıyorsanız, yol tanıtım dosyasını içeren dizine göredir.

Xml dosyasındaki özel etiketleri kullanarak özel öznitelikler de ekleyebilirsiniz. Tüm öznitelik etiketleri reklam dosyasından ayrıştırılır ve değerler sözlüğe yerleştirilir AdProperties . Özel özniteliklerinize program aracılığıyla erişmek için sözlüğü kullanabilirsiniz AdProperties .

Bu dosyadaki bilgiler denetim tarafından AdRotator doğrulanmaz. Reklamların kötü amaçlı betikleri yürütmesini önlemek için, verileri yayınlamadan önce her zaman denetlemeli veya yalnızca güvenilir kaynaklardan gelen reklam bilgilerini kabul etmelisiniz.

Reklam dosyanızın yetkisiz İnternet erişimine karşı güvenliğini sağlamak için aşağıdakilerden birini veya daha fazlasını yapın:

  • Bunu, Machine.config'de herhangi bir türdeki dosyalar için İnternet erişimini reddedecek şekilde yapılandırılan Veri dizininde depolayın.
  • dosyasını .xmlolmayan bir uzantıyla yeniden adlandırın ve uzantıyı HttpForbiddenHandler Web.configile eşleyin. Daha fazla bilgi için Machine.config dosyanızdaki bölüme bakın httpHandlers .

Şunlara uygulanır

Ayrıca bkz.