Bagikan melalui

AdRotator.AdvertisementFile Properti

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls
Rakitan:
System.Web.dll

Mendapatkan atau mengatur jalur ke file XML yang berisi informasi iklan.

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

Nilai Properti

String

Lokasi file XML yang berisi informasi iklan. Nilai default adalah string kosong ("").

Atribut
BindableAttribute

Contoh

Contoh kode berikut menunjukkan cara menggunakan AdvertisementFile properti untuk menentukan lokasi file XML yang berisi informasi iklan.

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

Contoh kode berikut menunjukkan format file file iklan 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>

Keterangan

AdvertisementFile Gunakan properti untuk menentukan lokasi file XML yang berisi informasi iklan. File XML harus berada dalam situs Web yang sama. Untuk tujuan penyebaran dan keamanan, sangat disarankan agar Anda menempatkan file di aplikasi Web yang sama. Hanya dimungkinkan untuk mengakses file XML yang terletak di aplikasi yang berbeda di situs yang sama jika aplikasi memiliki kepercayaan yang memadai.

Anda dapat mengatur properti ini ke jalur absolut atau jalur yang relatif terhadap file XML. Gunakan jalur relatif untuk menyederhanakan penyebaran. Jika Anda menggunakan jalur relatif, jalur tersebut relatif terhadap lokasi halaman atau kontrol pengguna yang berisi AdRotator kontrol.

Properti AdvertisementFile bersifat opsional. Iklan juga dapat diatur secara terprogram dalam peristiwa tersebut AdCreated .

File XML berisi atribut yang telah ditentukan sebelumnya berikut ini. Hanya atribut yang ImageUrl diperlukan.

Atribut Deskripsi
ImageUrl URL gambar yang akan ditampilkan.
Height Tinggi gambar, dalam piksel (opsional).
Width Lebar gambar, dalam piksel (opsional).
NavigateUrl URL halaman yang akan dinavigasi saat AdRotator kontrol diklik.
AlternateText Teks yang akan ditampilkan jika gambar tidak tersedia. Pada beberapa browser, teks ini ditampilkan sebagai TipsAlat.
Keyword Kategori untuk iklan. Ini digunakan oleh AdRotator kontrol untuk memfilter daftar iklan untuk kategori tertentu.
Impressions Nilai yang menunjukkan seberapa sering iklan ditampilkan sehubungan dengan iklan lain dalam file XML.

Catatan

Atribut ImageUrl dan NavigateUrl dapat berupa URL lengkap, jalur root-relative, atau jalur relatif. Jika Anda menggunakan jalur root-relative, jalur relatif terhadap situs Web yang sama. Jika Anda menggunakan jalur relatif, jalur tersebut relatif terhadap direktori yang berisi file iklan.

Anda juga dapat menyertakan atribut kustom dengan menggunakan tag kustom dalam file XML. Semua tag atribut diurai dari file iklan, dan nilai ditempatkan dalam AdProperties kamus. Anda dapat menggunakan AdProperties kamus untuk mengakses atribut kustom Anda secara terprogram.

Informasi dalam file ini tidak divalidasi oleh AdRotator kontrol. Untuk mencegah iklan menjalankan skrip berbahaya, Anda harus selalu memeriksa data sebelum merilisnya, atau menerima informasi iklan hanya dari sumber tepercaya.

Untuk mengamankan file iklan Anda dari akses Internet yang tidak sah, lakukan satu atau beberapa hal berikut:

  • Simpan di direktori Data, yang dikonfigurasi di Machine.config untuk menolak akses Internet untuk file dengan jenis apa pun.
  • Ganti nama file dengan ekstensi yang tidak .xml, dan petakan ekstensi ke HttpForbiddenHandler di Web.config. Untuk informasi selengkapnya, lihat bagian httpHandlers di file Machine.config Anda.

Berlaku untuk

Lihat juga