AdRotator controle de servidor Web Declarative sintaxe
Exibe uma faixa de anúncio em uma página de 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"
/>
Comentários
The AdRotator controle exibe uma faixa de anúncio em uma página de Web Forms. Ele exibe a imagem especificada pelo ImageUrl elemento dentro de um controle de ancorar. Em time de execução, a AdRotator usos do controle <asp:HyperLink> e <asp:Image> controles para processar o controle na página de Web Forms. A imagem de fonte é dimensionada pelo navegador para as dimensões do AdRotator controle, independentemente de seu dimensionar real.
Se o AdvertisementFile propriedade é conjunto, um anúncio será selecionado com base no valor da <Impressions> elemento do arquivo. Os argumentos do evento são então conjunto e o AdCreated evento é gerado. Se o AdvertisementFile propriedade não está conjunto, os argumentos do evento estão vazias quando o AdCreated evento é gerado. Os argumentos do evento são usados para processar o AdRotator controlar, para que você possa modificar os valores passados para o evento do arquivo de anúncio, ou conjunto-las com valores gerar você mesmo. Um cenário comum é popular os argumentos do evento com valores recuperados de um banco de dados.
Quando você cria um arquivo de anúncio, considere os seguintes pontos:
O XML no arquivo anúncio deve ser bem formado.
Somente o primeiro <Advertisements> elemento do arquivo é analisado pela AdRotator controle. Todos os outros <Advertisements> elementos no arquivo são ignorados.
Você pode adicionar elementos personalizados para a descrição de XML de um anúncio. Esses valores são passados para o AdCreated evento na AdProperties propriedade de dicionário.
Você pode usar o AdCreated evento para selecionar o s AD diretamente em seu código ou para modificar o renderização de um AD selecionado a partir do AD arquivo. Se um arquivo de AD for conjunto, os argumentos para o AdCreated evento já estão conjunto para o AD selecionado quando o evento é chamado. Se deseja ou não os valores já estão definidos, você pode modificar os valores no ImageUrl, href, e AlternateText propriedades para modificar o renderização das AdRotator controle. Elementos personalizados adicionados à descrição XML do anúncio estão disponível no AdCreatedEventArgs.AdProperties propriedade de dicionário.
Para obter informações detalhadas sobre o AdRotator Propriedades do controle e eventos, consulte o AdRotator documentação.
Formato de arquivo de anúncio
The AdRotator controle usa um arquivo de anúncio de XML separado para armazenar sistema autônomo informações de anúncio, sistema autônomo o local da imagem para exibir e a URL da página para vincular a. The AdvertisementFile propriedade das AdRotator controle Especifica o caminho para este arquivo.
Ao criar o arquivo de anúncio, abrindo e fechando <Advertisements> Rótulos marcam o início e participante do arquivo, respectivamente. Abrindo e fechando <Ad> Rótulos delimitam cada anúncio. Todos os anúncios estão aninhados entre abertura e fechamento <Advertisements> Rótulos de formatação. Se o arquivo contiver vários <Advertisements> o primeiro conjunto de Rótulos <Advertisements> Rótulos no arquivo serão analisadas pela AdRotator controle. Todos os outros <Advertisements> Rótulos serão ignoradas.
Os elementos de dados para cada anúncio estão aninhados entre abertura e fechamento <Ad> Rótulos de formatação. Embora determinados elementos de dados sejam predefinidos (por exemplo, ImageUrl e href), você pode colocar elementos personalizados entre o <Ad> Rótulos de formatação. Esses elementos serão lidos pelo AdRotator controle quando ele analisa o arquivo. As informações é então passadas para o AdCreated evento na AdProperties propriedade de dicionário.
A tabela a seguir lista os elementos de dados predefinidas para o arquivo XML de anúncio.
Elemento |
Descrição |
|---|---|
<ImageUrl> |
URL absoluto ou relativo para um arquivo de imagem (opcional). |
<href> |
A URL de uma página para vincular a se o usuário clica no AD (opcional). .gif "Observação") Observação:
Se este elemento não estiver definido, o HRef propriedade não é processada na marca de ancorar.
|
<AlternateText> |
A exibição do texto no lugar da imagem quando a imagem especificada pelo ImageUrl propriedade não está disponível (opcional). Em alguns navegadores, esse texto também aparece sistema autônomo um ToolTip para o anúncio. |
<Keyword> |
Uma categoria para o anúncio (por exemplo, "computadores") que você pode filtrar por (opcional). |
<Impressions> |
Um número que indica a importância do AD na agenda de rotação em relação a outros anúncios no arquivo (opcional). Quanto maior o número, mais freqüentemente AD é exibido. O total de todos os <Impressions> valores no arquivo XML não podem exceder 2,047,999,999. Em caso afirmativo, o AdRotator controle lança uma exceção em time de execução. |
A seguir mostra o formato para o arquivo de anúncio de 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>
Exemplo
O exemplo a seguir demonstra como declarar um AdRotator controle em um arquivo.aspx.
<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>
O exemplo a seguir demonstra como criar um manipulador de eventos para o AdCreated evento substituir programaticamente o valor da href propriedade.
<%@ 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>
O exemplo a seguir demonstra como formatar um arquivo de anúncio de 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>