AdRotator Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Exibe um banner publicitário numa página 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 seguinte demonstra como usar o AdRotator controlo para exibir um banner publicitário numa página 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 seguinte demonstra o formato de ficheiro para um ficheiro XML que contém informação de publicidade para o exemplo anterior. Para mais informações sobre o formato de ficheiro, 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>

Observações

Neste tópico:

Introdução
Formato de ficheiro de anúncio XML
Sintaxe declarativa

Introduction

Use o AdRotator controlo para exibir um banner publicitário selecionado aleatoriamente na página Web. O anúncio apresentado muda sempre que a página atualiza.

A informação da publicidade é armazenada num ficheiro XML separado. O ficheiro XML permite-lhe manter uma lista de anúncios e os seus atributos associados. Os atributos incluem o caminho para uma imagem a mostrar, o URL a que se liga quando o controlo é clicado, o texto alternativo a mostrar quando a imagem não está disponível, uma palavra-chave e a frequência do anúncio. A informação neste ficheiro não é validada pelo AdRotator controlo. Para evitar que anúncios executem scripts maliciosos, deve sempre verificar os dados antes de os divulgar, ou aceitar informações de anúncios apenas de fontes confiáveis.

Para proteger o seu ficheiro publicitário contra acesso não autorizado à Internet, faça uma ou mais das seguintes ações:

Armazene-o no diretório App_Data, que está configurado para negar o acesso à internet a ficheiros de qualquer tipo.
Renomeie o ficheiro com uma extensão que não seja .xml, e mapeie a extensão para o HttpForbiddenHandler em Web.config. Para mais informações, consulte a httpHandlers secção no seu ficheiro de Machine.config.

Como alternativa a um ficheiro XML como fonte de dados, é possível fornecer informação de publicidade através de um evento de callback. Este evento também pode ser usado em combinação com o ficheiro XML para prolongar o comportamento do AdRotator controlo, como redirecionar para outra página. Consulte a AdvertisementFile propriedade para mais informações sobre o formato de ficheiro.

Note

Quando a cache de página está ativada, um AdRotator controlo não está armazenado em cache. Um novo anúncio é selecionado sempre que a página web atualiza. No entanto, um novo anúncio não é selecionado se fornecer um gestor de eventos para o AdCreated evento.

Formato de ficheiro de anúncio XML

O AdRotator controlo utiliza um ficheiro de anúncios XML separado para armazenar a informação do anúncio, como a localização da imagem a mostrar e o URL da página a ligar. A AdvertisementFile propriedade do AdRotator controlo especifica o caminho para este ficheiro.

Ao criar o ficheiro de anúncio, as etiquetas de abertura e fecho <Advertisements> assinalam, respetivamente, o início e o fim do ficheiro. As etiquetas de abertura e fecho <Ad> delimitam cada anúncio. Todos os anúncios estão encaixados entre as etiquetas de abertura e fecho <Advertisements> . Se o ficheiro contiver múltiplas <Advertisements> etiquetas, apenas o primeiro conjunto de <Advertisements> etiquetas do ficheiro será analisado pelo AdRotator controlo. Todas as outras <Advertisements> etiquetas serão ignoradas.

Os elementos de dados de cada anúncio estão aninhados entre as etiquetas de abertura e fecho <Ad> . Embora certos elementos de dados sejam pré-definidos (como ImageUrl e NavigateUrl), pode colocar elementos personalizados entre as <Ad> etiquetas. Estes elementos serão lidos pelo AdRotator controlo quando este analisa o ficheiro. A informação é então passada para o AdCreated evento na AdProperties propriedade do dicionário.

A tabela seguinte lista os elementos de dados que estão pré-definidos para o ficheiro de anúncio XML.

Elemento	Description
`ImageUrl`	A URL absoluta ou relativa de um ficheiro de imagem (opcional).
`NavigateUrl`	O URL de uma página para fazer o link se o utilizador clicar no anúncio (opcional). Nota: Se este elemento não estiver definido, a `HRef` propriedade não é renderizada na etiqueta âncora.
`Height`	A altura da imagem, em píxeis (opcional).
`Width`	A largura da imagem, em píxeis (opcional).
`AlternateText`	O texto é exibido em vez da imagem quando a imagem especificada pela ImageUrl propriedade não está disponível (opcional). Em alguns navegadores, este texto também aparece como um `ToolTip` para o anúncio.
`Keyword`	Uma categoria para o anúncio (por exemplo, "computadores") que pode filtrar (opcional).
`Impressions`	Um número que indica a importância do anúncio no calendário de rotação em relação aos outros anúncios no ficheiro (opcional). Quanto maior o número, mais frequentemente o anúncio é exibido. O total de todos `<Impressions>` os valores no ficheiro XML não pode exceder 2.047.999.999. Se acontecer, o controlo AdRotator lança uma exceção em tempo de execução.

O exemplo seguinte mostra o formato do ficheiro de anúncios 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

Name	Description
AdRotator()	Inicializa uma nova instância da AdRotator classe.

Propriedades

Name	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web. (Herdado de WebControl)
Adapter	Recebe o adaptador específico do navegador para o controlo. (Herdado de Control)
AdvertisementFile	Obtém ou define o caminho para um ficheiro XML que contém informação de publicidade.
AlternateTextField	Recebe ou define um campo de dados personalizado para usar em vez do `AlternateText` atributo de um anúncio.
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control)
Attributes	Obtém a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo. (Herdado de WebControl)
BackColor	Obtém ou define a cor de fundo do controlo do servidor Web. (Herdado de WebControl)
BindingContainer	Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controlo Web. (Herdado de WebControl)
BorderStyle	Obtém ou define o estilo de borda do controlo do servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da fronteira do controlo do servidor Web. (Herdado de WebControl)
ChildControlsCreated	Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control)
ClientID	Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control)
Context	Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controlos filhos de um servidor especificado na hierarquia da interface. (Herdado de Control)
ControlStyle	Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
ControlStyleCreated	Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
CssClass	Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente. (Herdado de WebControl)
DataItemContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control)
DataMember	Obtém ou define o nome da lista de dados à qual o controlo de dados se liga, nos casos em que a fonte de dados contém mais do que uma lista distinta de itens de dados. (Herdado de DataBoundControl)
DataSource	Obtém ou define o objeto a partir do qual o controlo ligado a dados recupera a sua lista de itens de dados. (Herdado de BaseDataBoundControl)
DataSourceID	Obtém ou define o ID do controlo do qual o controlo limitado por dados recupera a sua lista de itens de dados. (Herdado de DataBoundControl)
DataSourceObject	Recebe um objeto que implementa a IDataSource interface, que dá acesso ao conteúdo de dados do objeto. (Herdado de DataBoundControl)
DesignMode	Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control)
Enabled	Recebe ou define um valor que indica se o controlo do servidor Web está ativado. (Herdado de WebControl)
EnableTheming	Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de WebControl)
EnableViewState	Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control)
Font	Obtém as propriedades da fonte associadas ao controlo do banner publicitário.
ForeColor	Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web. (Herdado de WebControl)
HasAttributes	Recebe um valor que indica se o controlo tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control)
Height	Obtém ou define a altura do controlo do servidor Web. (Herdado de WebControl)
ID	Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control)
IdSeparator	Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control)
ImageUrlField	Recebe ou define um campo de dados personalizado para usar em vez do `ImageUrl` atributo de um anúncio.
Initialized	Obtém um valor que indica se o controlo ligado a dados foi inicializado. (Herdado de BaseDataBoundControl)
IsBoundUsingDataSourceID	Recebe um valor que indica se a DataSourceID propriedade está definida. (Herdado de BaseDataBoundControl)
IsChildControlStateCleared	Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control)
IsDataBindingAutomatic	Obtém um valor que indica se a ligação de dados é automática. (Herdado de BaseDataBoundControl)
IsEnabled	Recebe um valor que indica se o controlo está ativado. (Herdado de WebControl)
IsTrackingViewState	Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control)
IsUsingModelBinders	Obtém um valor que indica se a binding do modelo está em uso. (Herdado de DataBoundControl)
IsViewStateEnabled	Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control)
ItemType	Obtém ou define o nome do tipo de elemento de dados para ligação de dados fortemente tipada. (Herdado de DataBoundControl)
KeywordFilter	Obtém ou define uma palavra-chave de categoria para filtrar tipos específicos de anúncios no ficheiro de anúncios XML.
LoadViewStateByID	Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control)
NamingContainer	Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
NavigateUrlField	Recebe ou define um campo de dados personalizado para usar em vez do `NavigateUrl` atributo de um anúncio.
Page	Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control)
RenderingCompatibility	Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
RequiresDataBinding	Recebe 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 controlo data-bound usa ao recuperar dados de um controlo de fonte de dados. (Herdado de DataBoundControl)
SelectMethod	O nome do método a chamar para ler dados. (Herdado de DataBoundControl)
Site	Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control)
SkinID	Obtém ou fixa a pele para aplicar no controlo. (Herdado de WebControl)
Style	Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web. (Herdado de WebControl)
SupportsDisabledAttribute	Obtém um valor que indica se o controlo deve definir o `disabled` atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controlo é `false`. (Herdado de BaseDataBoundControl)
TabIndex	Obtém ou define o índice de tabulação do controlo do servidor Web. (Herdado de WebControl)
TagKey	Recebe a tag HTML para o AdRotator controlo.
TagKey	Obtém o HtmlTextWriterTag valor correspondente a este controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
TagName	Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl)
Target	Obtém ou define o nome da janela ou frame do navegador que mostra o conteúdo da página Web ligada quando o AdRotator controlo é clicado.
TemplateControl	Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control)
ToolTip	Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o AdRotator controlo.
UniqueID	Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control)
ValidateRequestMode	Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo view-state deste controlo. (Herdado de Control)
Visible	Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página. (Herdado de Control)
Width	Obtém ou define a largura do controlo do servidor Web. (Herdado de WebControl)

Métodos

Name	Description
AddAttributesToRender(HtmlTextWriter)	Adiciona atributos e estilos HTML que precisam de ser renderizados para o especificado HtmlTextWriterTag. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
AddedControl(Control, Int32)	Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control)
ApplyStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor em ClientID cache para `null`. (Herdado de Control)
ClearChildControlState()	Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control)
ClearChildState()	Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control)
ClearChildViewState()	Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control)
ConfirmInitState()	Define o estado inicializado do controlo ligado a dados. (Herdado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
CreateChildControls()	Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização. (Herdado de Control)
CreateControlCollection()	Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor.
CreateControlCollection()	Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control)
CreateControlStyle()	Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas com o estilo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
CreateDataSourceSelectArguments()	Cria um objeto padrão DataSourceSelectArguments usado pelo controlo data-bound se não forem especificados argumentos. (Herdado de DataBoundControl)
DataBind()	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos. (Herdado de Control)
DataBind()	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos. (Herdado de BaseDataBoundControl)
DataBind(Boolean)	Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control)
Dispose()	Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control)
EnsureDataBound()	Chama o DataBind() método se a DataSourceID propriedade estiver definida e o controlo data-bound estiver marcado para exigir ligação. (Herdado de BaseDataBoundControl)
EnsureID()	Cria um identificador para controlos 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 no contentor de nomenclatura atual um controlo de servidor com o especificado `id` e um inteiro, especificados no `pathOffset` parâmetro, o que auxilia na pesquisa. Não deve sobrepor-se a esta versão do FindControl método. (Herdado de Control)
FindControl(String)	Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada num controlo. (Herdado de Control)
GetData()	Recupera um DataSourceView objeto que o controlo data-bound utiliza para realizar operações de dados. (Herdado de DataBoundControl)
GetDataSource()	Recupera a IDataSource interface à qual o controlo de dados está associado, se existir. (Herdado de DataBoundControl)
GetDesignModeState()	Obtém dados de tempo de projeto para um controlo. (Herdado de Control)
GetHashCode()	Serve como função de hash predefinida. (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 o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control)
HasControls()	Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control)
HasEvents()	Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control)
IsLiteralContent()	Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control)
LoadViewState(Object)	Restaura a informação de estado de visualização de um pedido anterior que foi guardado com o SaveViewState() método. (Herdado de WebControl)
LoadViewState(Object)	Restaura a informação de estado de visualização de um pedido anterior de página que foi guardado pelo SaveViewState() método. (Herdado de DataBoundControl)
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control)
MarkAsDataBound()	Define o estado do controlo no estado de visualização como vinculado com sucesso aos dados. (Herdado de DataBoundControl)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
MergeStyle(Style)	Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
OnAdCreated(AdCreatedEventArgs)	Aumenta o AdCreated evento para o AdRotator controlo.
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página. (Herdado de Control)
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)	Eleva o CreatingModelDataSource evento. (Herdado de DataBoundControl)
OnDataBinding(EventArgs)	Eleva o DataBinding evento. (Herdado de Control)
OnDataBound(EventArgs)	Eleva o DataBound evento. (Herdado de BaseDataBoundControl)
OnDataPropertyChanged()	Volta a vincular o controlo ligado aos dados aos seus dados após uma das propriedades de identificação da fonte base de dados alterar. (Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)	Eleva o DataSourceViewChanged evento. (Herdado de DataBoundControl)
OnInit(EventArgs)	Eleva o Init evento.
OnInit(EventArgs)	Eleva o Init evento. (Herdado de Control)
OnLoad(EventArgs)	Eleva o Load evento. (Herdado de Control)
OnLoad(EventArgs)	Trata do Load evento. (Herdado de DataBoundControl)
OnPagePreLoad(Object, EventArgs)	Define o estado inicializado do controlo ligado a dados antes de este ser carregado. (Herdado de DataBoundControl)
OnPreRender(EventArgs)	Obtém a informação do anúncio para renderização consultando os dados do ficheiro ou chamando o evento do utilizador.
OnUnload(EventArgs)	Eleva o Unload evento. (Herdado de Control)
OpenFile(String)	Recebe um Stream usado para ler um ficheiro. (Herdado de Control)
PerformDataBinding(IEnumerable)	Vincula a fonte de dados especificada ao AdRotator controlo.
PerformSelect()	Recupera os dados da publicidade da fonte de dados associada.
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control)
RemovedControl(Control)	Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Mostra o AdRotator controlo no cliente.
RenderBeginTag(HtmlTextWriter)	Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
RenderChildren(HtmlTextWriter)	Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Apresenta o conteúdo do controlo ao autor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a etiqueta HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl)
ResolveAdapter()	Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control)
ResolveClientUrl(String)	Recebe um URL que pode ser usado pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control)
SaveViewState()	Guarda qualquer estado que tenha sido modificado após o TrackViewState() método ter sido invocado. (Herdado de WebControl)
SaveViewState()	Guarda quaisquer alterações no estado de visualização que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de DataBoundControl)
SetDesignModeState(IDictionary)	Define dados em tempo de projeto para um controlo. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TrackViewState()	Faz com que o controlo acompanhe alterações ao estado de visualização para que possam ser armazenadas na propriedade do ViewState objeto. (Herdado de WebControl)
TrackViewState()	Faz com que as alterações de estado de vista do controlo sejam rastreadas para que possam ser armazenadas no objeto do StateBag controlo. (Herdado de DataBoundControl)
ValidateDataSource(Object)	Verifica se o objeto ao qual um controlo databound se liga é um com o qual pode trabalhar. (Herdado de DataBoundControl)

evento

Name	Description
AdCreated	Ocorre uma vez por ida e volta ao servidor após a criação do controlo, mas antes da página ser renderizada.
CallingDataMethods	Ocorre quando métodos de dados estão a ser chamados. (Herdado de DataBoundControl)
CreatingModelDataSource	Ocorre quando o ModelDataSource objeto está a ser criado. (Herdado de DataBoundControl)
DataBinding	Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control)
DataBound	Ocorre depois de o controlo do servidor se ligar a uma fonte de dados. (Herdado de BaseDataBoundControl)
Disposed	Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control)

Implementações de Interface Explícita

Name	Description
IAttributeAccessor.GetAttribute(String)	Recebe um atributo do controlo Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controlo Web ao nome e valor especificados. (Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder	Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para uma descrição deste elemento, veja UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para uma descrição deste elemento, veja DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para uma descrição deste elemento, veja Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control)

Métodos da Extensão

Name	Description
EnablePersistedSelection(BaseDataBoundControl)	Obsoleto. Permite que a seleção seja mantida em controlos de dados que suportam a seleção e a paginação.
FindDataSourceControl(Control)	Devolve a fonte de dados associada ao controlo de dados para o controlo especificado.
FindFieldTemplate(Control, String)	Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado.
FindMetaTable(Control)	Devolve o objeto metatable para o controlo de dados que contém.

Aplica-se a

Ver também

Comentários

Esta página foi útil?