Compartilhar via

AdRotator Classe

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Exibe uma faixa de anúncio em uma página da Web.

public ref class AdRotator : System::Web::UI::WebControls::WebControl
public ref class AdRotator : System::Web::UI::WebControls::DataBoundControl
public class AdRotator : System.Web.UI.WebControls.WebControl
public class AdRotator : System.Web.UI.WebControls.DataBoundControl
type AdRotator = class
    inherit WebControl
type AdRotator = class
    inherit DataBoundControl
Public Class AdRotator
Inherits WebControl
Public Class AdRotator
Inherits DataBoundControl
Herança
Object
Control
WebControl
AdRotator
Herança
Object
Control
WebControl
BaseDataBoundControl
DataBoundControl
AdRotator

Exemplos

O exemplo de código a seguir demonstra como usar o AdRotator controle para exibir uma faixa de anúncio em uma página da Web.

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

O exemplo de código a seguir demonstra o formato de arquivo de um arquivo XML que contém informações de anúncio para o exemplo anterior. Para obter mais informações sobre o formato de arquivo, consulte o AdvertisementFile membro.

<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>
  </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>
  </Ad>
</Advertisements>

Comentários

Neste tópico:

Introdução

Use o AdRotator controle para exibir uma faixa de anúncio selecionada aleatoriamente na página da Web. O anúncio exibido é alterado sempre que a página é atualizada.

As informações de anúncio são armazenadas em um arquivo XML separado. O arquivo XML permite que você mantenha uma lista de anúncios e seus atributos associados. Os atributos incluem o caminho para uma imagem a ser exibida, a URL a ser vinculada quando o controle é clicado, o texto alternativo a ser exibido quando a imagem não estiver disponível, uma palavra-chave e a frequência do anúncio. As informações neste arquivo não são validadas pelo AdRotator controle. Para impedir que anúncios executem scripts mal-intencionados, você sempre deve verificar os dados antes de liberá-los ou aceitar informações de anúncios somente de fontes confiáveis.

Para proteger seu arquivo de anúncio contra acesso não autorizado à Internet, faça um ou mais dos seguintes procedimentos:

  • Armazene-o no diretório App_Data, que está configurado para negar o acesso à Internet para arquivos de qualquer tipo.
  • Renomeie o arquivo com uma extensão que não é .xmle mapeie a extensão para o HttpForbiddenHandler Web.config. Para obter mais informações, consulte a httpHandlers seção em seu arquivo de Machine.config.

Como alternativa a um arquivo XML como fonte de dados, é possível fornecer informações de anúncio por meio de um evento de retorno de chamada. Esse evento também pode ser usado em combinação com o arquivo XML para estender o comportamento do AdRotator controle, como redirecionar para outra página. Consulte a AdvertisementFile propriedade para obter informações adicionais sobre o formato do arquivo.

Observação

Quando o cache de página está habilitado, um AdRotator controle não é armazenado em cache. Um novo anúncio é selecionado sempre que a página da Web é atualizada. Um novo anúncio não será selecionado, no entanto, se você fornecer um manipulador de eventos para o AdCreated evento.

Formato de arquivo de anúncio XML

O AdRotator controle usa um arquivo de anúncio XML separado para armazenar as informações de anúncio, como o local da imagem a ser exibida e a URL da página à qual vincular. A AdvertisementFile propriedade do AdRotator controle especifica o caminho para esse arquivo.

Ao criar o arquivo de anúncio, as marcas de abertura e fechamento <Advertisements> marcam o início e o final do arquivo, respectivamente. As marcas de abertura e fechamento <Ad> delimitam cada anúncio. Todos os anúncios são aninhados entre as marcas de abertura e fechamento <Advertisements> . Se o arquivo contiver várias <Advertisements> marcas, somente o primeiro conjunto de <Advertisements> marcas no arquivo será analisado pelo AdRotator controle. Todas as outras <Advertisements> marcas serão ignoradas.

Os elementos de dados de cada anúncio são aninhados entre as marcas de abertura e fechamento <Ad> . Embora determinados elementos de dados sejam predefinidos (como ImageUrl e NavigateUrl), você pode colocar elementos personalizados entre as <Ad> marcas. Esses elementos serão lidos pelo AdRotator controle quando ele analisar o arquivo. Em seguida, as informações são passadas para o AdCreated evento na propriedade de AdProperties dicionário.

A tabela a seguir lista os elementos de dados predefinidos para o arquivo de anúncio XML.

Elemento Descrição
ImageUrl A URL absoluta ou relativa para um arquivo de imagem (opcional).
NavigateUrl A URL de uma página à qual vincular se o usuário clicar no anúncio (opcional). Nota: Se esse elemento não estiver definido, a HRef propriedade não será renderizada na marca de âncora.
Height A altura da imagem, em pixels (opcional).
Width A largura da imagem, em pixels (opcional).
AlternateText O texto é exibido no lugar da imagem quando a imagem especificada pela ImageUrl propriedade não está disponível (opcional).

Em alguns navegadores, esse texto também aparece como 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 anúncio no agendamento de rotação em relação aos outros anúncios no arquivo (opcional).

Quanto maior o número, mais frequentemente o anúncio é exibido. O total de todos os <Impressions> valores no arquivo XML não pode exceder 2.047.999.999. Se isso acontecer, o AdRotator controle gerará uma exceção em tempo de execução.

O exemplo a seguir mostra o formato do arquivo de anúncio XML.

<Advertisements>
  <Ad>
    <ImageUrl>
      URL of image to display for Advertisement #1
    </ImageUrl>
    <NavigateUrl>
      URL of page to link to for Advertisement #1
    </NavigateUrl>
    <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>

Sintaxe declarativa

<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"
    NavigateUrlField="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"
/>

Construtores

Nome Description
AdRotator()

Inicializa uma nova instância da classe AdRotator.

Propriedades

Nome Description
AccessKey

Obtém ou define a chave de acesso que permite navegar rapidamente até o controle do servidor Web.

(Herdado de WebControl)
Adapter

Obtém o adaptador específico do navegador para o controle.

(Herdado de Control)
AdvertisementFile

Obtém ou define o caminho para um arquivo XML que contém informações de anúncio.
AlternateTextField

Obtém ou define um campo de dados personalizado a ser usado no lugar do AlternateText atributo para um anúncio.
AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle.

(Herdado de Control)
Attributes

Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades no controle.

(Herdado de WebControl)
BackColor

Obtém ou define a cor da tela de fundo do controle do servidor Web.

(Herdado de WebControl)
BindingContainer

Obtém o controle que contém a associação de dados desse controle.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controle Web.

(Herdado de WebControl)
BorderStyle

Obtém ou define o estilo de borda do controle do servidor Web.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da borda do controle do servidor Web.

(Herdado de WebControl)
ChildControlsCreated

Obtém um valor que indica se os controles filho do controle do servidor foram criados.

(Herdado de Control)
ClientID

Obtém a ID de controle para marcação HTML gerada por ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade.

(Herdado de Control)
Context

Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual.

(Herdado de Control)
Controls

Obtém um ControlCollection objeto que representa os controles filho para um controle de servidor especificado na hierarquia da interface do usuário.

(Herdado de Control)
ControlStyle

Obtém o estilo do controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CssClass

Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente.

(Herdado de WebControl)
DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl.

(Herdado de Control)
DataMember

Obtém ou define o nome da lista de dados à qual o controle associado a dados se associa, nos casos em que a fonte de dados contém mais de uma lista distinta de itens de dados.

(Herdado de DataBoundControl)
DataSource

Obtém ou define o objeto do qual o controle associado a dados recupera sua lista de itens de dados.

(Herdado de BaseDataBoundControl)
DataSourceID

Obtém ou define a ID do controle do qual o controle associado a dados recupera sua lista de itens de dados.

(Herdado de DataBoundControl)
DataSourceObject

Obtém um objeto que implementa a IDataSource interface, que fornece acesso ao conteúdo de dados do objeto.

(Herdado de DataBoundControl)
DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.

(Herdado de Control)
Enabled

Obtém ou define um valor que indica se o controle do servidor Web está habilitado.

(Herdado de WebControl)
EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.

(Herdado de WebControl)
EnableViewState

Obtém ou define um valor que indica se o controle do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante.

(Herdado de Control)
Events

Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para leitura.

(Herdado de Control)
Font

Obtém as propriedades de fonte associadas ao controle de faixa de anúncio.
ForeColor

Obtém ou define a cor do primeiro plano (normalmente a cor do texto) do controle do servidor Web.

(Herdado de WebControl)
HasAttributes

Obtém um valor que indica se o controle tem atributos definidos.

(Herdado de WebControl)
HasChildViewState

Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas.

(Herdado de Control)
Height

Obtém ou define a altura do controle do servidor Web.

(Herdado de WebControl)
ID

Obtém ou define o identificador programático atribuído ao controle do servidor.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.

(Herdado de Control)
ImageUrlField

Obtém ou define um campo de dados personalizado a ser usado no lugar do ImageUrl atributo para um anúncio.
Initialized

Obtém um valor que indica se o controle associado a dados foi inicializado.

(Herdado de BaseDataBoundControl)
IsBoundUsingDataSourceID

Obtém um valor que indica se a DataSourceID propriedade está definida.

(Herdado de BaseDataBoundControl)
IsChildControlStateCleared

Obtém um valor que indica se os controles contidos nesse controle têm estado de controle.

(Herdado de Control)
IsDataBindingAutomatic

Obtém um valor que indica se a associação de dados é automática.

(Herdado de BaseDataBoundControl)
IsEnabled

Obtém um valor que indica se o controle está habilitado.

(Herdado de WebControl)
IsTrackingViewState

Obtém um valor que indica se o controle do servidor está salvando alterações em seu estado de exibição.

(Herdado de Control)
IsUsingModelBinders

Obtém um valor que indica se a associação de modelo está em uso.

(Herdado de DataBoundControl)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.

(Herdado de Control)
ItemType

Obtém ou define o nome do tipo de item de dados para associação de dados fortemente tipada.

(Herdado de DataBoundControl)
KeywordFilter

Obtém ou define uma palavra-chave de categoria a ser filtrada para tipos específicos de anúncios no arquivo de anúncio XML.
LoadViewStateByID

Obtém um valor que indica se o controle participa no carregamento de seu estado de exibição ID em vez de índice.

(Herdado de Control)
NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade.

(Herdado de Control)
NavigateUrlField

Obtém ou define um campo de dados personalizado a ser usado no lugar do NavigateUrl atributo para um anúncio.
Page

Obtém uma referência à Page instância que contém o controle do servidor.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página.

(Herdado de Control)
RenderingCompatibility

Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível.

(Herdado de Control)
RequiresDataBinding

Obtém ou define um valor que indica se o DataBind() método deve ser chamado.

(Herdado de BaseDataBoundControl)
SelectArguments

Obtém um DataSourceSelectArguments objeto que o controle associado a dados usa ao recuperar dados de um controle de fonte de dados.

(Herdado de DataBoundControl)
SelectMethod

O nome do método a ser chamado para ler dados.

(Herdado de DataBoundControl)
Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design.

(Herdado de Control)
SkinID

Obtém ou define a pele a ser aplicada ao controle.

(Herdado de WebControl)
Style

Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle do servidor Web.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o disabled atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controle é false.

(Herdado de BaseDataBoundControl)
TabIndex

Obtém ou define o índice de tabulação do controle do servidor Web.

(Herdado de WebControl)
TagKey

Obtém a marca HTML para o AdRotator controle.
TagKey

Obtém o HtmlTextWriterTag valor que corresponde a esse controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
TagName

Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
Target

Obtém ou define o nome da janela ou quadro do navegador que exibe o conteúdo da página da Web vinculada quando o AdRotator controle é clicado.
TemplateControl

Obtém ou define uma referência ao modelo que contém esse controle.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual.

(Herdado de Control)
ToolTip

Obtém ou define o texto exibido quando o ponteiro do mouse passa o mouse sobre o controle do servidor Web.

(Herdado de WebControl)
UniqueID

Obtém o identificador exclusivo e hierarquicamente qualificado para o AdRotator controle.
UniqueID

Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor.

(Herdado de Control)
ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos.

(Herdado de Control)
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o StateBag objeto não diferencia maiúsculas de minúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição desse controle.

(Herdado de Control)
Visible

Obtém ou define um valor que indica se um controle de servidor é renderizado como interface do usuário na página.

(Herdado de Control)
Width

Obtém ou define a largura do controle do servidor Web.

(Herdado de WebControl)

Métodos

Nome Description
AddAttributesToRender(HtmlTextWriter)

Adiciona atributos HTML e estilos que precisam ser renderizados ao especificado HtmlTextWriterTag. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
AddedControl(Control, Int32)

Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor.

(Herdado de Control)
ApplyStyle(Style)

Copia todos os elementos nãoblank do estilo especificado para o controle da Web, substituindo quaisquer elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos de página ao controle.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento em tempo de design dos dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor armazenado em ClientID cache como null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle do servidor.

(Herdado de Control)
ClearChildState()

Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle do servidor.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle do servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit.

(Herdado de Control)
ConfirmInitState()

Define o estado inicializado do controle associado a dados.

(Herdado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia as propriedades não encapsuladas pelo Style objeto do controle de servidor Web especificado para o controle do servidor Web do qual esse método é chamado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CreateChildControls()

Chamado pela estrutura de página ASP.NET para notificar os controles de servidor que usam a implementação baseada em composição para criar quaisquer controles filho que eles contenham em preparação para postar de volta ou renderização.

(Herdado de Control)
CreateControlCollection()

Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor.
CreateControlCollection()

Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor.

(Herdado de Control)
CreateControlStyle()

Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas ao estilo. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CreateDataSourceSelectArguments()

Cria um objeto padrão DataSourceSelectArguments usado pelo controle associado a dados se nenhum argumento for especificado.

(Herdado de DataBoundControl)
DataBind()

Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho.

(Herdado de Control)
DataBind()

Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho.

(Herdado de BaseDataBoundControl)
DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.

(Herdado de Control)
Dispose()

Permite que um controle de servidor execute a limpeza final antes de ser liberado da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento em tempo de design dos dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determina se o controle do servidor contém controles filho. Se isso não acontecer, ele criará controles filho.

(Herdado de Control)
EnsureDataBound()

Chama o DataBind() método se a DataSourceID propriedade estiver definida e o controle associado a dados for marcado para exigir associação.

(Herdado de BaseDataBoundControl)
EnsureID()

Cria um identificador para controles que não têm um identificador atribuído.

(Herdado de Control)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FindControl(String, Int32)

Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado id e um inteiro, especificado no parâmetro, que pathOffset ajuda na pesquisa. Você não deve substituir essa versão do FindControl método.

(Herdado de Control)
FindControl(String)

Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado id .

(Herdado de Control)
Focus()

Define o foco de entrada como um controle.

(Herdado de Control)
GetData()

Recupera um DataSourceView objeto que o controle associado a dados usa para executar operações de dados.

(Herdado de DataBoundControl)
GetDataSource()

Recupera a IDataSource interface à qual o controle associado a dados está associado, se houver.

(Herdado de DataBoundControl)
GetDesignModeState()

Obtém dados de tempo de design para um controle.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.

(Herdado de Control)
GetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.

(Herdado de Control)
GetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da UniqueID propriedade do controle especificado.

(Herdado de Control)
HasControls()

Determina se o controle do servidor contém controles filho.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho.

(Herdado de Control)
IsLiteralContent()

Determina se o controle do servidor contém apenas conteúdo literal.

(Herdado de Control)
LoadControlState(Object)

Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo SaveControlState() método.

(Herdado de Control)
LoadViewState(Object)

Restaura informações de estado de exibição de uma solicitação anterior que foi salva com o SaveViewState() método.

(Herdado de WebControl)
LoadViewState(Object)

Restaura informações de estado de exibição de uma solicitação de página anterior que foi salva pelo SaveViewState() método.

(Herdado de DataBoundControl)
MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado.

(Herdado de Control)
MarkAsDataBound()

Define o estado do controle no estado de exibição como associado com êxito aos dados.

(Herdado de DataBoundControl)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MergeStyle(Style)

Copia todos os elementos nãoblank do estilo especificado para o controle da Web, mas não substituirá nenhum elemento de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
OnAdCreated(AdCreatedEventArgs)

Gera o AdCreated evento para o AdRotator controle.
OnBubbleEvent(Object, EventArgs)

Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de interface do usuário da página.

(Herdado de Control)
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Aciona o evento CreatingModelDataSource.

(Herdado de DataBoundControl)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.

(Herdado de Control)
OnDataBound(EventArgs)

Aciona o evento DataBound.

(Herdado de BaseDataBoundControl)
OnDataPropertyChanged()

Vincula novamente o controle associado a dados a seus dados depois que uma das propriedades de identificação da fonte de dados base é alterada.

(Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Aciona o evento DataSourceViewChanged.

(Herdado de DataBoundControl)
OnInit(EventArgs)

Aciona o evento Init.
OnInit(EventArgs)

Aciona o evento Init.

(Herdado de Control)
OnLoad(EventArgs)

Aciona o evento Load.

(Herdado de Control)
OnLoad(EventArgs)

Manipula o Load evento.

(Herdado de DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Define o estado inicializado do controle associado a dados antes que o controle seja carregado.

(Herdado de DataBoundControl)
OnPreRender(EventArgs)

Obtém as informações de anúncio para renderização pesquisando os dados do arquivo ou chamando o evento de usuário.
OnUnload(EventArgs)

Aciona o evento Unload.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.

(Herdado de Control)
PerformDataBinding(IEnumerable)

Associa a fonte de dados especificada ao AdRotator controle.
PerformSelect()

Recupera os dados de anúncio da fonte de dados associada.
RaiseBubbleEvent(Object, EventArgs)

Atribui todas as fontes do evento e suas informações ao pai do controle.

(Herdado de Control)
RemovedControl(Control)

Chamado depois que um controle filho é removido da Controls coleção do Control objeto.

(Herdado de Control)
Render(HtmlTextWriter)

Exibe o AdRotator controle no cliente.
RenderBeginTag(HtmlTextWriter)

Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
RenderChildren(HtmlTextWriter)

Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza o conteúdo do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter .

(Herdado de Control)
RenderControl(HtmlTextWriter)

O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que é utilizável no cliente solicitante.

(Herdado de Control)
SaveControlState()

Salva as alterações de estado do controle do servidor que ocorreram desde o momento em que a página foi postada de volta no servidor.

(Herdado de Control)
SaveViewState()

Salva qualquer estado modificado após a invocação do TrackViewState() método.

(Herdado de WebControl)
SaveViewState()

Salva as alterações de estado de exibição que ocorreram desde o momento em que a página foi postada de volta no servidor.

(Herdado de DataBoundControl)
SetDesignModeState(IDictionary)

Define dados de tempo de design para um controle.

(Herdado de Control)
SetRenderMethodDelegate(RenderMethod)

Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento.

(Herdado de Control)
SetTraceData(Object, Object)

Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TrackViewState()

Faz com que o controle rastreie as alterações no estado de exibição para que elas possam ser armazenadas na propriedade do ViewState objeto.

(Herdado de WebControl)
TrackViewState()

Faz com que as alterações de estado de exibição no controle sejam controladas para que possam ser armazenadas no objeto do StateBag controle.

(Herdado de DataBoundControl)
ValidateDataSource(Object)

Verifica se o objeto ao qual um controle associado a dados se associa é aquele com o qual ele pode trabalhar.

(Herdado de DataBoundControl)

Eventos

Nome Description
AdCreated

Ocorre uma vez por viagem de ida e volta para o servidor após a criação do controle, mas antes que a página seja renderizada.
CallingDataMethods

Ocorre quando os métodos de dados estão sendo chamados.

(Herdado de DataBoundControl)
CreatingModelDataSource

Ocorre quando o ModelDataSource objeto está sendo criado.

(Herdado de DataBoundControl)
DataBinding

Ocorre quando o controle do servidor é associado a uma fonte de dados.

(Herdado de Control)
DataBound

Ocorre depois que o controle do servidor é associado a uma fonte de dados.

(Herdado de BaseDataBoundControl)
Disposed

Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida do controle do servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Init

Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida.

(Herdado de Control)
Load

Ocorre quando o controle do servidor é carregado no Page objeto.

(Herdado de Control)
PreRender

Ocorre depois que o Control objeto é carregado, mas antes da renderização.

(Herdado de Control)
Unload

Ocorre quando o controle do servidor é descarregado da memória.

(Herdado de Control)

Implantações explícitas de interface

Nome Description
IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle Web com o nome especificado.

(Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Define um atributo do controle Web como o nome e o valor especificados.

(Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder

Para obter uma descrição deste membro, consulte ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição deste membro, consulte GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição deste membro, consulte SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição deste membro, consulte UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição deste membro, consulte DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição deste membro, consulte HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para obter uma descrição deste membro, consulte Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição deste membro, consulte HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição deste membro, consulte AddParsedSubObject(Object).

(Herdado de Control)

Métodos de Extensão

Nome Description
EnablePersistedSelection(BaseDataBoundControl)
Obsoleto.

Permite que a seleção seja mantida em controles de dados que dão suporte à seleção e à paginação.
FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados para o controle especificado.
FindFieldTemplate(Control, String)

Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)

Retorna o objeto metatável para o controle de dados que contém.

Aplica-se a

Confira também