AdRotator Classe

Definizione

Visualizza l'intestazione di un annuncio pubblicitario su una pagina Web.Displays an advertisement banner on a Web page.

public ref class AdRotator : System::Web::UI::WebControls::DataBoundControl
public class AdRotator : System.Web.UI.WebControls.DataBoundControl
type AdRotator = class
    inherit DataBoundControl
Public Class AdRotator
Inherits DataBoundControl
Ereditarietà

Esempi

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il controllo AdRotator per visualizzare un banner pubblicitario in una pagina Web.The following code example demonstrates how to use the AdRotator control to display an advertisement banner on a Web page.

<%@ 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 riportato di seguito viene illustrato il formato di file per un file XML che contiene informazioni sull'annuncio per l'esempio precedente.The following code example demonstrates the file format for an XML file that contains advertisement information for the previous example. Per ulteriori informazioni sul formato di file, vedere il membro AdvertisementFile.For more information on the file format, see the AdvertisementFile member.

<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 argomentoIn this topic:

IntroduzioneIntroduction

Utilizzare il controllo AdRotator per visualizzare un banner pubblicitario selezionato in modo casuale nella pagina Web.Use the AdRotator control to display a randomly selected advertisement banner on the Web page. L'annuncio visualizzato viene modificato ogni volta che la pagina viene aggiornata.The displayed advertisement changes whenever the page refreshes.

Le informazioni sull'annuncio vengono archiviate in un file XML separato.Advertisement information is stored in a separate XML file. Il file XML consente di mantenere un elenco di annunci e i relativi attributi associati.The XML file allows you to maintain a list of advertisements and their associated attributes. 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.Attributes include the path to an image to display, the URL to link to when the control is clicked, the alternate text to display when the image is not available, a keyword, and the frequency of the advertisement. Le informazioni contenute in questo file non vengono convalidate dal controllo AdRotator.Information in this file is not validated by the AdRotator control. Per impedire che gli annunci eseguano script dannosi, è sempre necessario controllare i dati prima di rilasciarli oppure accettare le informazioni di Active Directory solo da origini attendibili.To prevent ads from executing malicious scripts, you should always check the data before releasing it, or accept ad information only from trusted sources.

Per proteggere il file dell'annuncio da accesso a Internet non autorizzato, effettuare una o più delle seguenti operazioni:To secure your advertisement file from unauthorized Internet access, do one or more of the following:

  • Archiviarlo nella directory App_Data, che è configurato per negare l'accesso a Internet per i file di qualsiasi tipo.Store it in the App_Data directory, which is configured to deny Internet access for files of any type.

  • Rinominare il file con un'estensione che non è XML ed eseguire il mapping dell'estensione al HttpForbiddenHandler in Web. config. Per ulteriori informazioni, vedere la sezione nel file Machine. config.Rename the file with an extension that is not .xml, and map the extension to the HttpForbiddenHandler in Web.config. For more information, see the section in your Machine.config file.

In alternativa a un file XML come origine dei dati, è possibile fornire informazioni sugli annunci tramite un evento di callback.As an alternative to an XML file as the source of data, it is possible to provide advertisement information through a callback event. Questo evento può essere utilizzato anche in combinazione con il file XML per estendere il comportamento del controllo AdRotator, ad esempio il reindirizzamento a un'altra pagina.This event can also be used in combination with the XML file to extend the behavior of the AdRotator control, such as redirecting to another page. Per ulteriori informazioni sul formato di file, vedere la proprietà AdvertisementFile.See the AdvertisementFile property for additional information on the file format.

Nota

Quando è abilitata la memorizzazione nella cache della pagina, un controllo AdRotator non viene memorizzato nella cache.When page caching is enabled, an AdRotator control is not cached. Ogni volta che si aggiorna la pagina Web, viene selezionato un nuovo annuncio.A new advertisement is selected whenever the Web page refreshes. Tuttavia, se si specifica un gestore eventi per l'evento AdCreated, non viene selezionato alcun nuovo annuncio.A new advertisement is not selected, however, if you provide an event handler for the AdCreated event.

Formato del file di annuncio XMLXML Advertisement File Format

Il controllo AdRotator usa un file di annuncio XML separato per archiviare le informazioni sull'annuncio, ad esempio il percorso dell'immagine da visualizzare e l'URL della pagina a cui collegarsi.The AdRotator control uses a separate XML advertisement file to store the advertisement information, such as the location of the image to display and the URL of the page to link to. La proprietà AdvertisementFile del controllo AdRotator specifica il percorso del file.The AdvertisementFile property of the AdRotator control specifies the path to this file.

Quando si crea il file di annuncio, i tag di apertura e chiusura <Advertisements> contrassegnano rispettivamente l'inizio e la fine del file.When creating the advertisement file, opening and closing <Advertisements> tags mark the beginning and the end of the file, respectively. L'apertura e la chiusura di tag <Ad> delimitano ogni annuncio.Opening and closing <Ad> tags delimit each advertisement. Tutti gli annunci sono annidati tra i tag <Advertisements> di apertura e di chiusura.All advertisements are nested between the opening and closing <Advertisements> tags. Se il file contiene più tag di <Advertisements>, solo il primo set di tag <Advertisements> nel file verrà analizzato dal controllo AdRotator.If the file contains multiple <Advertisements> tags, only the first set of <Advertisements> tags in the file will be parsed by the AdRotator control. Tutti gli altri tag <Advertisements> verranno ignorati.All other <Advertisements> tags will be ignored.

Gli elementi dati per ogni annuncio sono nidificati tra i tag <Ad> di apertura e di chiusura.The data elements for each advertisement are nested between the opening and closing <Ad> tags. Sebbene alcuni elementi dati siano predefiniti (ad esempio ImageUrl e NavigateUrl), è possibile inserire elementi personalizzati tra i tag <Ad>.Although certain data elements are predefined (such as ImageUrl and NavigateUrl), you can place custom elements between the <Ad> tags. Questi elementi verranno letti dal controllo AdRotator durante l'analisi del file.These elements will be read by the AdRotator control when it parses the file. Le informazioni vengono quindi passate all'evento AdCreated nella proprietà AdProperties Dictionary.The information is then passed to the AdCreated event in the AdProperties dictionary property.

Nella tabella seguente sono elencati gli elementi dati predefiniti per il file di annuncio XML.The following table lists the data elements that are predefined for the XML advertisement file.

ElementoElement DescriptionDescription
ImageUrl URL assoluto o relativo di un file di immagine (facoltativo).The absolute or relative URL to an image file (optional).
NavigateUrl URL di una pagina a cui collegarsi se l'utente fa clic su Active Directory (facoltativo).The URL of a page to link to if the user clicks the ad (optional). Nota: Se questo elemento non è impostato, il rendering della proprietà HRef non viene eseguito nel tag di ancoraggio.Note: If this element is not set, the HRef property is not rendered on the anchor tag.
Height Altezza dell'immagine, in pixel (facoltativo).The height of the image, in pixels (optional).
Width Larghezza dell'immagine in pixel (facoltativo).The width of the image, in pixels (optional).
AlternateText Visualizzazione del testo al posto dell'immagine quando l'immagine specificata dalla proprietà ImageUrl non è disponibile (facoltativo).The text display in place of the image when the image specified by the ImageUrl property is not available (optional).

In alcuni browser questo testo viene visualizzato anche come ToolTip per l'annuncio.In some browsers, this text also appears as a ToolTip for the advertisement.
Keyword Categoria per l'annuncio pubblicitario, ad esempio "computer", che è possibile filtrare in base a (facoltativo).A category for the advertisement (for example, "computers") that you can filter by (optional).
Impressions Numero che indica l'importanza dell'annuncio nella pianificazione della rotazione rispetto agli altri annunci nel file (facoltativo).A number that indicates the importance of the ad in the schedule of rotation relative to the other ads in the file (optional).

Maggiore è il numero, più spesso viene visualizzato l'annuncio.The larger the number, the more often the ad is displayed. Il totale di tutti i valori <Impressions> nel file XML non può essere maggiore di 2.047.999.999.The total of all <Impressions> values in the XML file cannot exceed 2,047,999,999. In caso contrario, il controllo AdRotator genera un'eccezione in fase di esecuzione.If it does, the AdRotator control throws a run-time exception.

Nell'esempio seguente viene illustrato il formato del file di annuncio XML.The following example shows the format for the XML advertisement file.

<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 dichiarativaDeclarative Syntax

<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.Initializes a new instance of the AdRotator class.

Proprietà

AccessKey

Ottiene o imposta il tasto di scelta che consente di accedere rapidamente al controllo server Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Ereditato da WebControl)
Adapter

Ottiene l'adattatore specifico del browser per il controllo.Gets the browser-specific adapter for the control.

(Ereditato da Control)
AdvertisementFile

Ottiene o imposta il percorso del file XML che contiene le informazioni sull'annuncio pubblicitario.Gets or sets the path to an XML file that contains advertisement information.

AlternateTextField

Ottiene o imposta un campo dati personalizzato da utilizzare al posto dell'attributo AlternateText per un annuncio pubblicitario.Gets or sets a custom data field to use in place of the AlternateText attribute for an advertisement.

AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Ereditato da Control)
Attributes

Ottiene l'insieme di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Ereditato da WebControl)
BackColor

Ottiene o imposta il colore di sfondo del controllo server Web.Gets or sets the background color of the Web server control.

(Ereditato da WebControl)
BindingContainer

Ottiene il controllo contenente l'associazione dati del controllo corrente.Gets the control that contains this control's data binding.

(Ereditato da Control)
BorderColor

Ottiene o imposta il colore del bordo del controllo Web.Gets or sets the border color of the Web control.

(Ereditato da WebControl)
BorderStyle

Ottiene o imposta lo stile del bordo del controllo server Web.Gets or sets the border style of the Web server control.

(Ereditato da WebControl)
BorderWidth

Ottiene o imposta la larghezza del bordo del controllo server Web.Gets or sets the border width of the Web server control.

(Ereditato da WebControl)
ChildControlsCreated

Ottiene un valore che indica se i controlli figli del controllo server sono stati creati.Gets a value that indicates whether the server control's child controls have been created.

(Ereditato da Control)
ClientID

Ottiene l'ID di controllo per il markup HTML generato da ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Ereditato da Control)
ClientIDMode

Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Ereditato da Control)
ClientIDSeparator

Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID.Gets a character value representing the separator character used in the ClientID property.

(Ereditato da Control)
Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.Gets the HttpContext object associated with the server control for the current Web request.

(Ereditato da Control)
Controls

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Ereditato da Control)
ControlStyle

Ottiene lo stile del controllo server Web.Gets the style of the Web server control. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.This property is used primarily by control developers.

(Ereditato da WebControl)
ControlStyleCreated

Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.This property is primarily used by control developers.

(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.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Ereditato da WebControl)
DataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Ereditato da Control)
DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Ereditato da Control)
DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.Gets a value indicating whether a control is being used on a design surface.

(Ereditato da Control)
Enabled

Ottiene o imposta un valore che indica se il controllo server Web è abilitato.Gets or sets a value indicating whether the Web server control is enabled.

(Ereditato da WebControl)
EnableTheming

Ottiene o imposta un valore che indica se al controllo vengono applicati i temi.Gets or sets a value indicating whether themes apply to this control.

(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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Ereditato da Control)
Events

Ottiene un elenco dei delegati del gestore eventi per il controllo.Gets a list of event handler delegates for the control. Questa proprietà è di sola lettura.This property is read-only.

(Ereditato da Control)
Font

Ottiene le proprietà del tipo di carattere associate al controllo intestazione dell'annuncio pubblicitario.Gets the font properties associated with the advertisement banner control.

ForeColor

Ottiene o imposta il colore di primo piano, in genere il colore del testo, del controllo server Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Ereditato da WebControl)
HasAttributes

Ottiene un valore che indica se sono impostati attributi per il controllo.Gets a value indicating whether the control has attributes set.

(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.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Ereditato da Control)
Height

Ottiene o imposta l'altezza del controllo server Web.Gets or sets the height of the Web server control.

(Ereditato da WebControl)
ID

Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server.Gets or sets the programmatic identifier assigned to the server control.

(Ereditato da Control)
IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.Gets the character used to separate control identifiers.

(Ereditato da Control)
ImageUrlField

Ottiene o imposta un campo dati personalizzato da utilizzare al posto dell'attributo ImageUrl per un annuncio pubblicitario.Gets or sets a custom data field to use in place of the ImageUrl attribute for an advertisement.

IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo.Gets a value indicating whether controls contained within this control have control state.

(Ereditato da Control)
IsEnabled

Ottiene un valore che indica se il controllo è abilitato.Gets a value indicating whether the control is enabled.

(Ereditato da WebControl)
IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione.Gets a value that indicates whether the server control is saving changes to its view state.

(Ereditato da Control)
IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente.Gets a value indicating whether view state is enabled for this control.

(Ereditato da Control)
KeywordFilter

Ottiene o imposta una parola chiave della categoria utilizzata per filtrare tipi specifici di annunci pubblicitari nel file XML degli annunci.Gets or sets a category keyword to filter for specific types of advertisements in the XML advertisement file.

LoadViewStateByID

Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Ereditato da Control)
NavigateUrlField

Ottiene o imposta un campo dati personalizzato da utilizzare al posto dell'attributo NavigateUrl per un annuncio pubblicitario.Gets or sets a custom data field to use in place of the NavigateUrl attribute for an advertisement.

Page

Ottiene un riferimento all'istanza Page che contiene il controllo server.Gets a reference to the Page instance that contains the server control.

(Ereditato da Control)
Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.Gets a reference to the server control's parent control in the page control hierarchy.

(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.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Ereditato da Control)
Site

Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione.Gets information about the container that hosts the current control when rendered on a design surface.

(Ereditato da Control)
SkinID

Ottiene o imposta l'interfaccia personalizzata da applicare al controllo.Gets or sets the skin to apply to the control.

(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.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(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.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Ereditato da WebControl)
TabIndex

Ottiene o imposta l'indice di tabulazione del controllo server Web.Gets or sets the tab index of the Web server control.

(Ereditato da WebControl)
TagKey

Ottiene il tag HTML per il controllo AdRotator.Gets the HTML tag for the AdRotator control.

TagName

Ottiene il nome del tag del controllo.Gets the name of the control tag. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.This property is used primarily by control developers.

(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.Gets or sets the name of the browser window or frame that displays the contents of the Web page linked to when the AdRotator control is clicked.

TemplateControl

Ottiene o imposta un riferimento al modello che contiene il controllo.Gets or sets a reference to the template that contains this control.

(Ereditato da Control)
TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Ereditato da Control)
ToolTip

Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Ereditato da WebControl)
UniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo AdRotator.Gets the unique, hierarchically qualified identifier for the AdRotator control.

ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Ereditato da Control)
ViewStateIgnoresCase

Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole.Gets a value that indicates whether the StateBag object is case-insensitive.

(Ereditato da Control)
ViewStateMode

Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo.Gets or sets the view-state mode of this control.

(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.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Ereditato da Control)
Width

Ottiene o imposta la larghezza del controllo server Web.Gets or sets the width of the Web server control.

(Ereditato da WebControl)

Metodi

AddAttributesToRender(HtmlTextWriter)

Aggiunge attributi e stili HTML dei quali è necessario eseguire il rendering nell'oggetto HtmlTextWriterTag specificato.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
AddedControl(Control, Int32)

Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control.Called after a child control is added to the Controls collection of the Control object.

(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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Ereditato da Control)
ApplyStyle(Style)

Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is primarily used by control developers.

(Ereditato da WebControl)
ApplyStyleSheetSkin(Page)

Applica al controllo le proprietà di stile definite nel foglio di stile della pagina.Applies the style properties defined in the page style sheet to the control.

(Ereditato da Control)
BeginRenderTracing(TextWriter, Object)

Inizia la traccia in fase di progettazione dei dati di rendering.Begins design-time tracing of rendering data.

(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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Ereditato da Control)
ClearCachedClientID()

Imposta il valore memorizzato nella cache ClientID su null.Sets the cached ClientID value to null.

(Ereditato da Control)
ClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.Deletes the control-state information for the server control's child controls.

(Ereditato da Control)
ClearChildState()

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.Deletes the view-state and control-state information for all the server control's child controls.

(Ereditato da Control)
ClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.Deletes the view-state information for all the server control's child controls.

(Ereditato da Control)
ClearEffectiveClientIDMode()

Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Ereditato da Control)
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.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Ereditato da Control)
CreateControlCollection()

Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

CreateControlStyle()

Crea l'oggetto di stile utilizzato internamente dalla classe WebControl per implementare tutte le proprietà correlate allo stile.Creates the style object that is used internally by the WebControl class to implement all style related properties. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
DataBind()

Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio.Binds a data source to the invoked server control and all its child controls.

(Ereditato da Control)
DataBind(Boolean)

Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Ereditato da Control)
DataBindChildren()

Associa un'origine dati al controllo server e ai relativi controlli figlio.Binds a data source to the server control's child controls.

(Ereditato da Control)
Dispose()

Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria.Enables a server control to perform final clean up before it is released from memory.

(Ereditato da Control)
EndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione dei dati di rendering.Ends design-time tracing of rendering data.

(Ereditato da Control)
EnsureChildControls()

Determina se il controllo server contiene controlli figlio.Determines whether the server control contains child controls. In caso contrario, li crea.If it does not, it creates child controls.

(Ereditato da Control)
EnsureID()

Crea un identificatore per i controlli a cui non è assegnato alcun identificatore.Creates an identifier for controls that do not have an identifier assigned.

(Ereditato da Control)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
FindControl(String)

Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.Searches the current naming container for a server control with the specified id parameter.

(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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Non eseguire l'override di questa versione del metodo FindControl.You should not override this version of the FindControl method.

(Ereditato da Control)
Focus()

Imposta lo stato attivo per l'input su un controllo.Sets input focus to a control.

(Ereditato da Control)
GetDesignModeState()

Ottiene i dati della fase di progettazione per un controllo.Gets design-time data for a control.

(Ereditato da Control)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetRouteUrl(Object)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Ereditato da Control)
GetRouteUrl(RouteValueDictionary)

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

(Ereditato da Control)
GetRouteUrl(String, Object)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

(Ereditato da Control)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetUniqueIDRelativeTo(Control)

Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato.Returns the prefixed portion of the UniqueID property of the specified control.

(Ereditato da Control)
HasControls()

Determina se il controllo server contiene controlli figlio.Determines if the server control contains any child controls.

(Ereditato da Control)
HasEvents()

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio.Returns a value indicating whether events are registered for the control or any child controls.

(Ereditato da Control)
IsLiteralContent()

Determina se il controllo server conserva solo il contenuto literal.Determines if the server control holds only literal content.

(Ereditato da Control)
LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Ereditato da Control)
LoadViewState(Object)

Ripristina le informazioni sullo stato di visualizzazione da una richiesta precedente salvata con il metodo SaveViewState().Restores view-state information from a previous request that was saved with the SaveViewState() method.

(Ereditato da WebControl)
MapPathSecure(String)

Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Ereditato da Control)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(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.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
OnAdCreated(AdCreatedEventArgs)

Genera l'evento AdCreated per il controllo AdRotator.Raises the AdCreated event for the AdRotator control.

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.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Ereditato da Control)
OnDataBinding(EventArgs)

Genera l'evento DataBinding.Raises the DataBinding event.

(Ereditato da Control)
OnInit(EventArgs)

Genera l'evento Init.Raises the Init event.

OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Ereditato da Control)
OnPreRender(EventArgs)

Ottiene le informazioni sull'annuncio pubblicitario di cui eseguire il rendering ricercando il file di dati o chiamando l'evento utente.Gets the advertisement information for rendering by looking up the file data or calling the user event.

OnUnload(EventArgs)

Genera l'evento Unload.Raises the Unload event.

(Ereditato da Control)
OpenFile(String)

Ottiene un oggetto Stream utilizzato per leggere un file.Gets a Stream used to read a file.

(Ereditato da Control)
PerformDataBinding(IEnumerable)

Associa l'origine dati specificata al controllo AdRotator.Binds the specified data source to the AdRotator control.

PerformSelect()

Recupera i dati dell'annuncio pubblicitario dall'origine dati associata.Retrieves the advertisement data from the associated data source.

RaiseBubbleEvent(Object, EventArgs)

Assegna eventuali origini dell'evento e relative informazioni al controllo padre.Assigns any sources of the event and its information to the control's parent.

(Ereditato da Control)
RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control.Called after a child control is removed from the Controls collection of the Control object.

(Ereditato da Control)
Render(HtmlTextWriter)

Visualizza il controllo AdRotator nel client.Displays the AdRotator control on the client.

RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag HTML di apertura del controllo nel writer specificato.Renders the HTML opening tag of the control to the specified writer. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
RenderChildren(HtmlTextWriter)

Invia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul client.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Ereditato da Control)
RenderContents(HtmlTextWriter)

Esegue il rendering del contenuto del controllo nel writer specificato.Renders the contents of the control to the specified writer. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Ereditato da Control)
RenderEndTag(HtmlTextWriter)

Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato.Renders the HTML closing tag of the control into the specified writer. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.This method is used primarily by control developers.

(Ereditato da WebControl)
ResolveAdapter()

Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato.Gets the control adapter responsible for rendering the specified control.

(Ereditato da Control)
ResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.Gets a URL that can be used by the browser.

(Ereditato da Control)
ResolveUrl(String)

Converte un URL in un formato utilizzabile dal client richiedente.Converts a URL into one that is usable on the requesting client.

(Ereditato da Control)
SaveControlState()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Ereditato da Control)
SaveViewState()

Salva qualsiasi stato modificato dopo la chiamata del metodo TrackViewState().Saves any state that was modified after the TrackViewState() method was invoked.

(Ereditato da WebControl)
SetDesignModeState(IDictionary)

Imposta i dati della fase di progettazione per un controllo.Sets design-time data for a control.

(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.Assigns an event handler delegate to render the server control and its content into its parent control.

(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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Ereditato da Control)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TrackViewState()

Forza il controllo a tenere traccia dello modifiche apportate allo stato di visualizzazione in modo che vengano archiviate nella proprietà ViewState dell'oggetto.Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(Ereditato da WebControl)

Eventi

AdCreated

Viene generato una sola volta per ogni round trip al server dopo la creazione del controllo, ma prima del rendering della pagina.Occurs once per round trip to the server after the creation of the control, but before the page is rendered.

DataBinding

Viene generato quando il controllo server viene associato a un'origine dati.Occurs when the server control binds to a data source.

(Ereditato da Control)
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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Ereditato da Control)
Init

Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Ereditato da Control)
Load

Viene generato quando il controllo server è caricato nell'oggetto Page.Occurs when the server control is loaded into the Page object.

(Ereditato da Control)
PreRender

Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering.Occurs after the Control object is loaded but prior to rendering.

(Ereditato da Control)
Unload

Viene generato quando il controllo server viene scaricato dalla memoria.Occurs when the server control is unloaded from memory.

(Ereditato da Control)

Implementazioni dell'interfaccia esplicita

IAttributeAccessor.GetAttribute(String)

Ottiene un attributo del controllo Web con il nome specificato.Gets an attribute of the Web control with the specified name.

(Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)

Imposta un attributo del controllo Web sul nome e il valore specificati.Sets an attribute of the Web control to the specified name and value.

(Ereditato da WebControl)
IControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere ControlBuilder.For a description of this member, see ControlBuilder.

(Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere GetDesignModeState().For a description of this member, see GetDesignModeState().

(Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Per una descrizione di questo membro, vedere SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Ereditato da Control)
IControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere UserData.For a description of this member, see UserData.

(Ereditato da Control)
IDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere DataBindings.For a description of this member, see DataBindings.

(Ereditato da Control)
IDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere HasDataBindings.For a description of this member, see HasDataBindings.

(Ereditato da Control)
IExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere Expressions.For a description of this member, see Expressions.

(Ereditato da Control)
IExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere HasExpressions.For a description of this member, see HasExpressions.

(Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Ereditato da Control)

Metodi di estensione

FindDataSourceControl(Control)

Restituisce l'origine dati associata al controllo dati per il controllo specificato.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Restituisce l'oggetto metatabella per il controllo contenitore dei dati.Returns the metatable object for the containing data control.

Si applica a

Vedi anche