AdRotator.AdvertisementFile Özellik

  • Başvuru

Tanım

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

Tanıtım 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

Tanıtım bilgilerini içeren 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 Tanıtım 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 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 AdRotator göredir.

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

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

Öznitelik 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.

Not

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

XML dosyasında özel etiketler kullanarak özel öznitelikler de ekleyebilirsiniz. Tüm öznitelik etiketleri tanıtım 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ğrulanmıyor. Reklamların kötü amaçlı betikler yürütmesini önlemek için, verileri yayınlamadan önce her zaman denetlemeniz 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.
  • Dosyayı .xml olmayan bir uzantıyla yeniden adlandırın ve uzantıyı HttpForbiddenHandler Web.config'da ile eşleyin. Daha fazla bilgi için Machine.config dosyanızdaki bölüme bakın httpHandlers .

Şunlara uygulanır

Ayrıca bkz.