AdRotator Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Visualizza un banner pubblicitario su una pagina 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

Ereditarietà: Object

Control

WebControl
AdRotator

Ereditarietà: Object

Control

WebControl

BaseDataBoundControl

DataBoundControl
AdRotator

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il AdRotator controllo per visualizzare un banner pubblicitario in una pagina 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>

Nell'esempio di codice seguente viene illustrato il formato di file per un file XML contenente informazioni sull'annuncio per l'esempio precedente. Per altre informazioni sul formato di file, vedere il 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>

Commenti

In questo argomento

Introduzione
Formato di file di annunci XML
Sintassi dichiarativa

Introduzione

Usare il AdRotator controllo per visualizzare un banner pubblicitario selezionato in modo casuale nella pagina Web. L'annuncio visualizzato cambia ogni volta che la pagina viene aggiornata.

Le informazioni sull'annuncio vengono archiviate in un file XML separato. Il file XML consente di mantenere un elenco di annunci pubblicitari e i relativi attributi associati. Gli attributi includono il percorso di un'immagine da visualizzare, l'URL a cui collegarsi quando si fa clic sul controllo, il testo alternativo da visualizzare quando l'immagine non è disponibile, una parola chiave e la frequenza dell'annuncio. Le informazioni contenute in questo file non vengono convalidate dal AdRotator controllo . Per impedire agli annunci di eseguire script dannosi, è consigliabile controllare sempre i dati prima di rilasciarlo o accettare informazioni pubblicitarie solo da origini attendibili.

Per proteggere il file pubblicitario dall'accesso a Internet non autorizzato, eseguire una o più delle operazioni seguenti:

Archiviarla nella directory App_Data, configurata per negare l'accesso a Internet per i file di qualsiasi tipo.
Rinominare il file con un'estensione che non è .xml ed eseguire il mapping dell'estensione a HttpForbiddenHandler in in Web.config. Per altre informazioni, vedere la httpHandlers sezione nel file di Machine.config.

In alternativa a un file XML come origine dei dati, è possibile fornire informazioni sull'annuncio tramite un evento di callback. Questo evento può essere utilizzato anche in combinazione con il file XML per estendere il comportamento del AdRotator controllo, ad esempio il reindirizzamento a un'altra pagina. Per altre informazioni sul formato di file, vedere la AdvertisementFile proprietà .

Nota

Quando la memorizzazione nella cache delle pagine è abilitata, un AdRotator controllo non viene memorizzato nella cache. Viene selezionato un nuovo annuncio ogni volta che la pagina Web viene aggiornata. Un nuovo annuncio non è tuttavia selezionato, se si specifica un gestore eventi per l'evento AdCreated .

Formato di file di annunci XML

Il AdRotator controllo usa un file di annunci XML separato per archiviare le informazioni sull'annuncio, ad esempio la posizione dell'immagine da visualizzare e l'URL della pagina a cui collegarsi. La AdvertisementFile proprietà del AdRotator controllo specifica il percorso del file.

Quando si crea il file di annuncio pubblicitario, i tag di apertura e chiusura <Advertisements> contrassegnano rispettivamente l'inizio e la fine del file. I tag di apertura e chiusura <Ad> delimitano ogni annuncio. Tutti gli annunci sono annidati tra i tag di apertura e chiusura <Advertisements> . Se il file contiene più <Advertisements> tag, solo il primo set di <Advertisements> tag nel file verrà analizzato dal AdRotator controllo . Tutti gli altri <Advertisements> tag verranno ignorati.

Gli elementi dati per ogni annuncio sono annidati tra i tag di apertura e chiusura <Ad> . Anche se alcuni elementi dati sono predefiniti (ad esempio ImageUrl e NavigateUrl), è possibile inserire elementi personalizzati tra i <Ad> tag. Questi elementi verranno letti dal controllo durante l'analisi AdRotator del file. Le informazioni vengono quindi passate all'evento AdCreated nella AdProperties proprietà del dizionario.

Nella tabella seguente sono elencati gli elementi di dati predefiniti per il file di annunci XML.

Elemento	Descrizione
`ImageUrl`	URL assoluto o relativo di un file di immagine (facoltativo).
`NavigateUrl`	URL di una pagina a cui collegare se l'utente fa clic sull'annuncio (facoltativo). Nota: Se questo elemento non è impostato, il rendering della `HRef` proprietà non viene eseguito sul tag di ancoraggio.
`Height`	Altezza dell'immagine, in pixel (facoltativo).
`Width`	Larghezza dell'immagine, in pixel (facoltativo).
`AlternateText`	Il testo visualizzato al posto dell'immagine quando l'immagine specificata dalla ImageUrl proprietà non è disponibile (facoltativo). In alcuni browser, questo testo viene visualizzato anche come oggetto `ToolTip` per l'annuncio.
`Keyword`	Categoria per l'annuncio pubblicitario (ad esempio "computer") che è possibile filtrare in base a (facoltativo).
`Impressions`	Numero che indica l'importanza dell'annuncio nella pianificazione della rotazione rispetto agli altri annunci nel file (facoltativo). Maggiore è il numero, più spesso viene visualizzato l'annuncio. Il totale di tutti i `<Impressions>` valori nel file XML non può superare 2.047.999.999. In caso affermativo, il AdRotator controllo genera un'eccezione di runtime.

Nell'esempio seguente viene illustrato il formato per il file di annunci 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>

Sintassi dichiarativa

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

Costruttori

AdRotator()

Inizializza una nuova istanza della classe AdRotator.

Proprietà

AccessKey	Ottiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web. (Ereditato da WebControl)
Adapter	Ottiene l'adattatore specifico del browser per il controllo. (Ereditato da Control)
AdvertisementFile	Ottiene o imposta il percorso del file XML che contiene le informazioni sull'annuncio pubblicitario.
AlternateTextField	Ottiene o imposta un campo dati personalizzato da utilizzare al posto dell'attributo `AlternateText` per un annuncio pubblicitario.
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo. (Ereditato da Control)
Attributes	Ottiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl)
BackColor	Ottiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl)
BindingContainer	Ottiene il controllo contenente l'associazione dati del controllo corrente. (Ereditato da Control)
BorderColor	Ottiene o imposta il colore del bordo del controllo Web. (Ereditato da WebControl)
BorderStyle	Ottiene o imposta lo stile del bordo del controllo server Web. (Ereditato da WebControl)
BorderWidth	Ottiene o imposta la larghezza del bordo del controllo server Web. (Ereditato da WebControl)
ChildControlsCreated	Ottiene un valore che indica se i controlli figli del controllo server sono stati creati. (Ereditato da Control)
ClientID	Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID. (Ereditato da Control)
ClientIDSeparator	Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID. (Ereditato da Control)
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Controls	Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Control)
ControlStyle	Ottiene lo stile del controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ControlStyleCreated	Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CssClass	Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul client. (Ereditato da WebControl)
DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
DataMember	Ottiene o imposta il nome dell'elenco di dati a cui si associa il controllo con associazione a dati, nei casi in cui l'origine dati contenga più elenchi distinti di elementi di dati. (Ereditato da DataBoundControl)
DataSource	Ottiene o imposta l'oggetto da cui il controllo con associazione a dati recupera il relativo elenco degli elementi di dati. (Ereditato da BaseDataBoundControl)
DataSourceID	Ottiene o imposta l'ID del controllo da cui il controllo associato a dati recupera l'elenco di elementi di dati. (Ereditato da DataBoundControl)
DataSourceObject	Ottiene un oggetto che implementa l'interfaccia IDataSource che fornisce l'accesso al contenuto dati dell'oggetto. (Ereditato da DataBoundControl)
DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
Enabled	Ottiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl)
EnableTheming	Ottiene o imposta un valore che indica se al controllo vengono applicati i temi. (Ereditato da WebControl)
EnableViewState	Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente. (Ereditato da Control)
Events	Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura. (Ereditato da Control)
Font	Ottiene le proprietà del tipo di carattere associate al controllo intestazione dell'annuncio pubblicitario.
ForeColor	Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web. (Ereditato da WebControl)
HasAttributes	Ottiene un valore che indica se sono impostati attributi per il controllo. (Ereditato da WebControl)
HasChildViewState	Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
Height	Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
ID	Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server. (Ereditato da Control)
IdSeparator	Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
ImageUrlField	Ottiene o imposta un campo dati personalizzato da utilizzare al posto dell'attributo `ImageUrl` per un annuncio pubblicitario.
Initialized	Ottiene un valore che indica se il controllo con associazione a dati è stato inizializzato. (Ereditato da BaseDataBoundControl)
IsBoundUsingDataSourceID	Ottiene un valore che indica se la proprietà DataSourceID è impostata. (Ereditato da BaseDataBoundControl)
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo. (Ereditato da Control)
IsDataBindingAutomatic	Ottiene un valore che indica se l'associazione dati è automatica. (Ereditato da BaseDataBoundControl)
IsEnabled	Ottiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl)
IsTrackingViewState	Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione. (Ereditato da Control)
IsUsingModelBinders	Ottiene un valore che indica se l'associazione del modello è in uso. (Ereditato da DataBoundControl)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente. (Ereditato da Control)
ItemType	Ottiene o imposta il nome del tipo di elemento dati per l'associazione dati fortemente tipizzata. (Ereditato da DataBoundControl)
KeywordFilter	Ottiene o imposta una parola chiave della categoria utilizzata per filtrare tipi specifici di annunci pubblicitari nel file XML degli annunci.
LoadViewStateByID	Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice. (Ereditato da Control)
NamingContainer	Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID. (Ereditato da Control)
NavigateUrlField	Ottiene o imposta un campo dati personalizzato da utilizzare al posto dell'attributo `NavigateUrl` per un annuncio pubblicitario.
Page	Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina. (Ereditato da Control)
RenderingCompatibility	Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering. (Ereditato da Control)
RequiresDataBinding	Ottiene o imposta un valore che indica se deve essere chiamato il metodo DataBind(). (Ereditato da BaseDataBoundControl)
SelectArguments	Ottiene un oggetto DataSourceSelectArguments che il controllo con associazione a dati utilizza al momento del recupero dei dati da un controllo origine dati. (Ereditato da DataBoundControl)
SelectMethod	Nome del metodo da chiamare per leggere i dati. (Ereditato da DataBoundControl)
Site	Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene o imposta l'interfaccia personalizzata da applicare al controllo. (Ereditato da WebControl)
Style	Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web. (Ereditato da WebControl)
SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare l'attributo `disabled` dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è `false`. (Ereditato da WebControl)
SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare l'attributo `disabled` dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è `false`. (Ereditato da BaseDataBoundControl)
TabIndex	Ottiene o imposta l'indice di tabulazione del controllo server Web. (Ereditato da WebControl)
TagKey	Ottiene il tag HTML per il controllo AdRotator.
TagKey	Ottiene il valore HtmlTextWriterTag corrispondente al controllo server Web. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
TagName	Ottiene il nome del tag del controllo. Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
Target	Ottiene o imposta il nome della finestra o del frame del browser in cui è visualizzato il contenuto della pagina Web collegata quando si fa clic sul controllo AdRotator.
TemplateControl	Ottiene o imposta un riferimento al modello che contiene il controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente. (Ereditato da Control)
ToolTip	Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web. (Ereditato da WebControl)
UniqueID	Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo AdRotator.
UniqueID	Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server. (Ereditato da Control)
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser. (Ereditato da Control)
ViewState	Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole. (Ereditato da Control)
ViewStateMode	Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo. (Ereditato da Control)
Visible	Ottiene o imposta un valore che indica se viene eseguito il rendering di un controllo server come interfaccia utente nella pagina. (Ereditato da Control)
Width	Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)

Metodi

AddAttributesToRender(HtmlTextWriter)	Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
AddedControl(Control, Int32)	Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control. (Ereditato da Control)
AddParsedSubObject(Object)	Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server. (Ereditato da Control)
ApplyStyle(Style)	Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ApplyStyleSheetSkin(Page)	Applica al controllo le proprietà di stile definite nel foglio di stile della pagina. (Ereditato da Control)
BeginRenderTracing(TextWriter, Object)	Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
BuildProfileTree(String, Boolean)	Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina. (Ereditato da Control)
ClearCachedClientID()	Imposta il valore memorizzato nella cache ClientID su `null`. (Ereditato da Control)
ClearChildControlState()	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
ClearChildState()	Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearChildViewState()	Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearEffectiveClientIDMode()	Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
ConfirmInitState()	Imposta lo stato inizializzato del controllo con associazione a dati. (Ereditato da BaseDataBoundControl)
CopyBaseAttributes(WebControl)	Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web dal quale è stato chiamato il metodo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CreateChildControls()	Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering. (Ereditato da Control)
CreateControlCollection()	Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server.
CreateControlCollection()	Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server. (Ereditato da Control)
CreateControlStyle()	Crea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CreateDataSourceSelectArguments()	Crea un oggetto DataSourceSelectArguments predefinito utilizzato dal controllo con associazione a dati se non viene specificato alcun argomento. (Ereditato da DataBoundControl)
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio. (Ereditato da Control)
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio. (Ereditato da BaseDataBoundControl)
DataBind(Boolean)	Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding. (Ereditato da Control)
DataBindChildren()	Associa un'origine dati al controllo server e ai relativi controlli figlio. (Ereditato da Control)
Dispose()	Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria. (Ereditato da Control)
EndRenderTracing(TextWriter, Object)	Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
EnsureChildControls()	Determina se il controllo server contiene controlli figlio. In caso contrario, li crea. (Ereditato da Control)
EnsureDataBound()	Chiama il metodo DataBind() se la proprietà DataSourceID è impostata e il controllo con associazione a dati è contrassegnato per la richiesta dell'associazione. (Ereditato da BaseDataBoundControl)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato alcun identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindControl(String)	Cerca un controllo server nel contenitore dei nomi corrente con il parametro `id` specificato. (Ereditato da Control)
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro `id` indicato e un intero, specificato nel parametro `pathOffset`, che agevola la ricerca. Non eseguire l'override di questa versione del metodo FindControl. (Ereditato da Control)
Focus()	Imposta lo stato attivo per l'input su un controllo. (Ereditato da Control)
GetData()	Recupera un oggetto DataSourceView utilizzato dal controllo associato a dati per eseguire le operazioni sui dati. (Ereditato da DataBoundControl)
GetDataSource()	Recupera l'interfaccia IDataSource a cui è associato il controllo con associazione a dati, se presente. (Ereditato da DataBoundControl)
GetDesignModeState()	Ottiene i dati della fase di progettazione per un controllo. (Ereditato da Control)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteUrl(Object)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL corrispondente a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route. (Ereditato da Control)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato. (Ereditato da Control)
HasControls()	Determina se il controllo server contiene controlli figlio. (Ereditato da Control)
HasEvents()	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio. (Ereditato da Control)
IsLiteralContent()	Determina se il controllo server conserva solo il contenuto literal. (Ereditato da Control)
LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState(). (Ereditato da Control)
LoadViewState(Object)	Ripristina informazioni sullo stato della visualizzazione da una richiesta precedente salvata con il metodo SaveViewState(). (Ereditato da WebControl)
LoadViewState(Object)	Ripristina le informazioni sullo stato di visualizzazione da una richiesta di pagina precedente salvata dal metodo SaveViewState(). (Ereditato da DataBoundControl)
MapPathSecure(String)	Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MarkAsDataBound()	Imposta lo stato del controllo nello stato di visualizzazione come associato correttamente ai dati. (Ereditato da DataBoundControl)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
MergeStyle(Style)	Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
OnAdCreated(AdCreatedEventArgs)	Genera l'evento AdCreated per il controllo AdRotator.
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina. (Ereditato da Control)
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)	Genera l'evento CreatingModelDataSource. (Ereditato da DataBoundControl)
OnDataBinding(EventArgs)	Genera l'evento DataBinding. (Ereditato da Control)
OnDataBound(EventArgs)	Genera l'evento DataBound. (Ereditato da BaseDataBoundControl)
OnDataPropertyChanged()	Riassocia il controllo con associazione a dati ai relativi dati dopo la modifica di una delle proprietà di identificazione dell'origine dati di base. (Ereditato da DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)	Genera l'evento DataSourceViewChanged. (Ereditato da DataBoundControl)
OnInit(EventArgs)	Genera l'evento Init.
OnInit(EventArgs)	Genera l'evento Init. (Ereditato da Control)
OnLoad(EventArgs)	Genera l'evento Load. (Ereditato da Control)
OnLoad(EventArgs)	Consente di gestire l'evento Load. (Ereditato da DataBoundControl)
OnPagePreLoad(Object, EventArgs)	Imposta lo stato inizializzato del controllo con associazione a dati prima del caricamento del controllo. (Ereditato da DataBoundControl)
OnPreRender(EventArgs)	Ottiene le informazioni sull'annuncio pubblicitario di cui eseguire il rendering ricercando il file di dati o chiamando l'evento utente.
OnUnload(EventArgs)	Genera l'evento Unload. (Ereditato da Control)
OpenFile(String)	Ottiene un oggetto Stream utilizzato per leggere un file. (Ereditato da Control)
PerformDataBinding(IEnumerable)	Associa l'origine dati specificata al controllo AdRotator.
PerformSelect()	Recupera i dati dell'annuncio pubblicitario dall'origine dati associata.
RaiseBubbleEvent(Object, EventArgs)	Assegna eventuali origini dell'evento e relative informazioni al controllo padre. (Ereditato da Control)
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control. (Ereditato da Control)
Render(HtmlTextWriter)	Visualizza il controllo AdRotator nel client.
RenderBeginTag(HtmlTextWriter)	Esegue il rendering del tag HTML di apertura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderContents(HtmlTextWriter)	Esegue il rendering del contenuto del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata. (Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato. (Ereditato da Control)
RenderEndTag(HtmlTextWriter)	Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ResolveAdapter()	Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
ResolveUrl(String)	Converte un URL in un formato utilizzabile dal client richiedente. (Ereditato da Control)
SaveControlState()	Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server. (Ereditato da Control)
SaveViewState()	Salva qualsiasi stato modificato dopo la chiamata del metodo TrackViewState(). (Ereditato da WebControl)
SaveViewState()	Salva le modifiche allo stato di visualizzazione apportate da quando è stato eseguito il postback della pagina al server. (Ereditato da DataBoundControl)
SetDesignModeState(IDictionary)	Imposta i dati della fase di progettazione per un controllo. (Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)	Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object, Object)	Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Indica al controllo di tenere traccia delle modifiche apportate allo proprio stato di visualizzazione in modo che tali modifiche possano essere archiviate nella proprietà ViewState dell'oggetto. (Ereditato da WebControl)
TrackViewState()	Attiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo per consentirne la memorizzazione nell'oggetto StateBag del controllo. (Ereditato da DataBoundControl)
ValidateDataSource(Object)	Verifica la possibilità di utilizzare l'oggetto a cui è associato un controllo con associazione a dati. (Ereditato da DataBoundControl)

Eventi

AdCreated	Viene generato una sola volta per ogni round trip al server dopo la creazione del controllo, ma prima del rendering della pagina.
CallingDataMethods	Si verifica quando vengono chiamati metodi di dati. (Ereditato da DataBoundControl)
CreatingModelDataSource	Si verifica alla creazione dell'oggetto ModelDataSource. (Ereditato da DataBoundControl)
DataBinding	Viene generato quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
DataBound	Viene dopo che un controllo server viene associato a un'origine dati. (Ereditato da BaseDataBoundControl)
Disposed	Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Init	Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata. (Ereditato da Control)
Load	Viene generato quando il controllo server è caricato nell'oggetto Page. (Ereditato da Control)
PreRender	Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering. (Ereditato da Control)
Unload	Viene generato quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)

Implementazioni dell'interfaccia esplicita

IAttributeAccessor.GetAttribute(String)	Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)	Imposta un attributo del controllo Web sul nome e il valore specificati. (Ereditato da WebControl)
IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control)
IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere UserData. (Ereditato da Control)
IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control)
IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control)
IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control)
IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control)

Metodi di estensione

EnablePersistedSelection(BaseDataBoundControl)	Obsoleti. Consente di rendere persistente la selezione nei controlli dati che supportano la selezione e il paging.
FindDataSourceControl(Control)	Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)	Restituisce l'oggetto metatabella per il controllo contenitore dei dati.

Si applica a

Condividi tramite