AdRotator Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Herança
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 para um arquivo XML que contém informações de anúncio para o exemplo anterior. Para obter mais informações sobre o formato do 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 está disponível, um 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ê deve sempre marcar os dados antes de liberá-los ou aceitar informações de anúncio 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 é .xml e mapeie a extensão para o
HttpForbiddenHandler
no Web.config. Para obter mais informações, consulte ahttpHandlers
seção no arquivo 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. No entanto, um novo anúncio não será selecionado 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 fim 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 para 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 dictionary AdProperties .
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
AdRotator() |
Inicializa uma nova instância da classe AdRotator. |
Propriedades
AccessKey |
Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web. (Herdado de WebControl) |
Adapter |
Obtém o adaptador específico de 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 usar em vez do atributo |
AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control) |
Attributes |
Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do 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 vinculaçã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 de servidor Web. (Herdado de WebControl) |
BorderWidth |
Obtém ou define a largura da borda do controle de servidor Web. (Herdado de WebControl) |
ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control) |
ClientID |
Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. (Herdado de Control) |
ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control) |
ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control) |
Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control) |
Controls |
Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário. (Herdado de Control) |
ControlStyle |
Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl) |
ControlStyleCreated |
Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. 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 implementa o IDataItemContainer. (Herdado de Control) |
DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control) |
DataMember |
Obtém ou define o nome da lista de dados ao qual o controle com limite de dados está associado, 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 com limite de 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 interface IDataSource, 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 de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
Events |
Obtém uma lista de delegados de 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 de primeiro plano (normalmente a cor do texto) do controle de 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 de servidor atual têm alguma configuração de estado de exibição salva. (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 de 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 usar em vez do atributo |
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 propriedade DataSourceID foi definida. (Herdado de BaseDataBoundControl) |
IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste 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 de servidor está salvando alterações no estado de exibição. (Herdado de Control) |
IsUsingModelBinders |
Obtém um valor que indica se o model binding 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 vinculação de dados com rigidez de tipos. (Herdado de DataBoundControl) |
KeywordFilter |
Obtém ou define uma palavra-chave de categoria para filtrar tipos específicos de anúncios no arquivo XML de anúncio. |
LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control) |
NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control) |
NavigateUrlField |
Obtém ou define um campo de dados personalizado a usar em vez do atributo |
Page |
Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control) |
Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control) |
RenderingCompatibility |
Obtém um valor que especifica a versão do 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 método DataBind() deve ser cancelado. (Herdado de BaseDataBoundControl) |
SelectArguments |
Obtém um objeto DataSourceSelectArguments 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 os dados. (Herdado de DataBoundControl) |
Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control) |
SkinID |
Obtém ou define a capa 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 de servidor Web. (Herdado de WebControl) |
SupportsDisabledAttribute |
Obtém um valor que indica se o controle deve definir o atributo |
SupportsDisabledAttribute |
Obtém um valor que indica se o controle deve definir o atributo |
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 controle AdRotator. |
TagKey |
Obtém o valor HtmlTextWriterTag que corresponde ao controle do 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 controle AdRotator é clicado. |
TemplateControl |
Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control) |
TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control) |
ToolTip |
Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web. (Herdado de WebControl) |
UniqueID |
Obtém o identificador exclusivo qualificado de maneira hierárquica para o controle AdRotator. |
UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control) |
ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para 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 objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control) |
ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control) |
Visible |
Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página. (Herdado de Control) |
Width |
Obtém ou define a largura do controle de servidor Web. (Herdado de WebControl) |
Métodos
AddAttributesToRender(HtmlTextWriter) |
Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control) |
AddParsedSubObject(Object) |
Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control) |
ApplyStyle(Style) |
Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles. (Herdado de WebControl) |
ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de Control) |
BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
BuildProfileTree(String, Boolean) |
Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control) |
ClearCachedClientID() |
Define o valor ClientID armazenado em cache como |
ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle de 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 de servidor. (Herdado de Control) |
ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control) |
ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control) |
ConfirmInitState() |
Define o estado inicializado do controle associado a dados. (Herdado de BaseDataBoundControl) |
CopyBaseAttributes(WebControl) |
Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
CreateChildControls() |
Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control) |
CreateControlCollection() |
Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. |
CreateControlCollection() |
Cria um novo objeto ControlCollection 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 classe WebControl para implementar todas as propriedades relacionadas a estilo. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
CreateDataSourceSelectArguments() |
Cria um objeto DataSourceSelectArguments padrão usado pelo controle associado a dados se nenhum argumento é especificado. (Herdado de DataBoundControl) |
DataBind() |
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de Control) |
DataBind() |
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de BaseDataBoundControl) |
DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (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 do lançamento da memória. (Herdado de Control) |
EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control) |
EnsureDataBound() |
Chamará o método DataBind() se a propriedade DataSourceID estiver definida e o controle associado a dados estiver marcado para exigir a 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) |
Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro |
FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
Focus() |
Define o foco de entrada para um controle. (Herdado de Control) |
GetData() |
Recupera um objeto DataSourceView que o controle com associação de dados usa para executar operações de dados. (Herdado de DataBoundControl) |
GetDataSource() |
Recupera a interface IDataSource à qual o controle associado a dados está associado, se houver. (Herdado de DataBoundControl) |
GetDesignModeState() |
Obtém os 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 propriedade UniqueID do controle especificado. (Herdado de Control) |
HasControls() |
Determina se o controle de servidor contém algum controle filho. (Herdado de Control) |
HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control) |
IsLiteralContent() |
Determina se o controle de servidor contém apenas o 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 método SaveControlState(). (Herdado de Control) |
LoadViewState(Object) |
Restaura informações de estado de exibição de uma solicitação anterior que foi salva com o método SaveViewState(). (Herdado de WebControl) |
LoadViewState(Object) |
Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState(). (Herdado de DataBoundControl) |
MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control) |
MarkAsDataBound() |
Define o estado do controle em estado de exibição como associado com êxito aos dados. (Herdado de DataBoundControl) |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
MergeStyle(Style) |
Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
OnAdCreated(AdCreatedEventArgs) | |
OnBubbleEvent(Object, EventArgs) |
Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da 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() |
Associa novamente o controle associado a dados a seus dados após a alteração de uma das propriedades de identificação da fonte de dados base. (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 evento Load. (Herdado de DataBoundControl) |
OnPagePreLoad(Object, EventArgs) |
Define o estado inicializado do controle associado a dados antes do carregamento do controle. (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 do 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 controle AdRotator. |
PerformSelect() |
Recupera os dados de anúncio da fonte de dados associada. |
RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control) |
RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control) |
Render(HtmlTextWriter) |
Exibe o controle AdRotator 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 HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
RenderContents(HtmlTextWriter) |
Renderiza o conteúdo do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl) |
RenderControl(HtmlTextWriter) |
Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control) |
RenderEndTag(HtmlTextWriter) |
Renderiza a marca de fechamento HTML do controle para o 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 possa ser usada no cliente solicitante. (Herdado de Control) |
SaveControlState() |
Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control) |
SaveViewState() |
Salva qualquer estado que foi modificado depois que o método TrackViewState() foi invocado. (Herdado de WebControl) |
SaveViewState() |
Salva as alterações de estado de exibição que ocorreram desde o postback da página no servidor. (Herdado de DataBoundControl) |
SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle. (Herdado de Control) |
SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
SetTraceData(Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control) |
SetTraceData(Object, Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de 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 acompanhe as alterações a seu estado de exibição para que eles possam ser armazenados na propriedade ViewState do objeto. (Herdado de WebControl) |
TrackViewState() |
Faz com que as alterações de estado de exibição no controle sejam controladas, de modo que possam ser armazenadas no objeto StateBag do controle. (Herdado de DataBoundControl) |
ValidateDataSource(Object) |
Verifica se o objeto ao qual um controle associado a dados está associado é um objeto com o qual ele pode trabalhar. (Herdado de DataBoundControl) |
Eventos
AdCreated |
Ocorre uma vez por viagem de ida e volta ao servidor após a criação do controle, mas antes de a página ser renderizada. |
CallingDataMethods |
Ocorre quando os métodos de dados estão sendo chamados. (Herdado de DataBoundControl) |
CreatingModelDataSource |
Ocorre quando o objeto ModelDataSource está sendo criado. (Herdado de DataBoundControl) |
DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control) |
DataBound |
Ocorre após o controle de servidor ser 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 de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control) |
Load |
Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control) |
PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control) |
Unload |
Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control) |
Implantações explícitas de interface
IAttributeAccessor.GetAttribute(String) |
Obtém um atributo do controle da Web com o nome especificado. (Herdado de WebControl) |
IAttributeAccessor.SetAttribute(String, String) |
Define um atributo do controle da Web para o nome e o valor especificados. (Herdado de WebControl) |
IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control) |
IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control) |
IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control) |
IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control) |
IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, confira UserData. (Herdado de Control) |
IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control) |
IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control) |
IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, confira Expressions. (Herdado de Control) |
IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control) |
IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control) |
Métodos de Extensão
EnablePersistedSelection(BaseDataBoundControl) |
Obsoleto.
Permite que a seleção seja persistida nos controles de dados que dão suporte à seleção e à paginação. |
FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados do controle especificado. |
FindFieldTemplate(Control, String) |
Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
FindMetaTable(Control) |
Retorna o objeto metatable para o controle que contém dados. |
Aplica-se a
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários