SiteMapDataSource Classe

Definizione

Fornisce un controllo origine dati che può essere usato dai controlli server Web e da altri controlli per il binding a dati della mappa del sito gerarchica.Provides a data source control that Web server controls and other controls can use to bind to hierarchical site map data.

public ref class SiteMapDataSource : System::Web::UI::HierarchicalDataSourceControl, System::ComponentModel::IListSource, System::Web::UI::IDataSource
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SiteMapDataSource))]
public class SiteMapDataSource : System.Web.UI.HierarchicalDataSourceControl, System.ComponentModel.IListSource, System.Web.UI.IDataSource
type SiteMapDataSource = class
    inherit HierarchicalDataSourceControl
    interface IDataSource
    interface IListSource
Public Class SiteMapDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource
Ereditarietà
Attributi
Implementazioni

Esempi

Nell'esempio di codice seguente viene illustrato come associare in modo dichiarativo un controllo TreeView a una mappa del sito utilizzando un controllo SiteMapDataSource.The following code example demonstrates how to declaratively bind a TreeView control to a site map using a SiteMapDataSource control. I dati della mappa del sito vengono recuperati a partire dal livello del nodo radice.The site map data is retrieved beginning at the root node level.

<%@ Page Language="C#" %>
<!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>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:SiteMapDataSource
                id="SiteMapDataSource1"
                runat="server" />

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

        </form>
    </body>
</html>
<%@ Page Language="VB" %>
<!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>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">
            <asp:SiteMapDataSource
                id="SiteMapDataSource1"
                runat="server" />

            <asp:TreeView
                id="TreeView1"
                runat="server"
                DataSourceID="SiteMapDataSource1">
            </asp:TreeView>

        </form>
    </body>
</html>

Commenti

In questo argomentoIn this topic:

IntroduzioneIntroduction

Il controllo SiteMapDataSource è un'origine dati per i dati della mappa del sito archiviati dai provider della mappa del sito configurati per il sito.The SiteMapDataSource control is a data source to the site map data that is stored by the site map providers that are configured for your site. Il SiteMapDataSource consente ai controlli server Web che non sono specifici dei controlli di navigazione del sito, ad esempio i controlli TreeView, Menue DropDownList, di eseguire l'associazione ai dati della mappa del sito gerarchica.The SiteMapDataSource enables Web server controls that are not specifically site navigation controls, such as the TreeView, Menu, and DropDownList controls, to bind to hierarchical site map data. È possibile utilizzare questi controlli server Web per visualizzare una mappa del sito come sommario o per esplorare attivamente un sito.You can use these Web server controls to display a site map as a table of contents or to actively navigate a site. In alternativa, è possibile usare il controllo SiteMapPath, progettato specificamente come controllo di navigazione del sito e pertanto non necessita di un'istanza del controllo SiteMapDataSource.Alternatively, you can use the SiteMapPath control, which is designed specifically as a site navigation control and therefore does not need an instance of the SiteMapDataSource control.

Specifica del nodo inizialeSpecifying the Starting Node

Il SiteMapDataSource viene associato ai dati della mappa del sito e presenta la visualizzazione basata su un nodo iniziale specificato nella gerarchia della mappa del sito.The SiteMapDataSource binds to site map data and presents its view based on a specified starting node in the site map hierarchy. Per impostazione predefinita, si tratta del nodo radice della gerarchia, ma può anche essere qualsiasi nodo all'interno della gerarchia.By default, it is the root node of the hierarchy but it can also be any node within the hierarchy. Il nodo iniziale viene identificato in base ai valori di diverse SiteMapDataSource proprietà, come indicato di seguito:The starting node is identified by the values of several SiteMapDataSource properties as follows:

Nodo inizialeStarting Node Valori delle proprietàProperty Values
Nodo radice della gerarchia (impostazione predefinita).The root node of the hierarchy (the default setting). L'elemento StartFromCurrentNode è false.The StartFromCurrentNode is false.

La proprietà StartingNodeUrl non è impostata.The StartingNodeUrl is not set.
Nodo che rappresenta la pagina attualmente visualizzata.The node that represents the currently viewed page. L'elemento StartFromCurrentNode è true.The StartFromCurrentNode is true.

La proprietà StartingNodeUrl non è impostata.The StartingNodeUrl is not set.
Nodo specifico della gerarchia.A specific node of the hierarchy. L'elemento StartFromCurrentNode è false.The StartFromCurrentNode is false.

Il StartingNodeUrl è impostato.The StartingNodeUrl is set.

Se la proprietà StartingNodeOffset è impostata su un valore diverso da 0, influiscono sul nodo iniziale e sulla gerarchia dei dati della mappa del sito esposta dal controllo SiteMapDataSource.If the StartingNodeOffset property is set to a value other than 0, it affects the starting node and with it the site map data hierarchy that is exposed by the SiteMapDataSource control. Il valore integer negativo o positivo della StartingNodeOffset identifica il numero di livelli verso l'alto o verso il basso della gerarchia della mappa del sito dal nodo iniziale identificato dalle proprietà StartFromCurrentNode e StartingNodeUrl per eseguire l'offset del nodo iniziale del sottoalbero esposto da controllo origine dati.The negative or positive integer value of the StartingNodeOffset identifies the number of levels up or down the site map hierarchy from the starting node that is identified by the StartFromCurrentNode and StartingNodeUrl properties to offset the starting node of the subtree that is exposed by data source control.

Se la proprietà StartingNodeOffset è impostata su un numero negativo -n, il nodo iniziale del sottoalbero esposto dal controllo origine dati è il nodo predecessore n livelli gerarchici al di sopra del nodo iniziale identificato.If the StartingNodeOffset property is set to a negative number -n, the starting node of the subtree that is exposed by the data source control is the ancestor node n hierarchical levels above the identified starting node. Se il valore n è maggiore del numero di livelli predecessore nell'albero gerarchico, il nodo iniziale del sottoalbero è il nodo radice della gerarchia della mappa del sito.If the value n is greater than the number of ancestor levels in the hierarchical tree, the starting node of the subtree is the root node of the site map hierarchy.

Se la proprietà StartingNodeOffset è impostata su un numero positivo +n, il nodo iniziale del sottoalbero esposto è un nodo figlio n livelli al di sotto del nodo iniziale identificato.If the StartingNodeOffset property is set to a positive number +n, the starting node of the subtree that is exposed is a child node n levels below the identified starting node. Poiché potrebbero esistere più rami dei nodi figlio nella gerarchia, il SiteMapDataSource tenta di risolvere un nodo figlio direttamente sul percorso tra il nodo iniziale identificato e il nodo che rappresenta la pagina attualmente richiesta, se possibile.Because more than one branch of child nodes might exist in the hierarchy, the SiteMapDataSource attempts to resolve a child node directly on the path between the identified starting node and the node that represents the currently requested page, if possible. Se il nodo che rappresenta la pagina attualmente richiesta non si trova nel sottoalbero del nodo iniziale identificato, il valore della proprietà StartingNodeOffset viene ignorato.If the node that represents the currently requested page is not in the subtree of the identified starting node, the value of the StartingNodeOffset property is ignored. Se il nodo che rappresenta la pagina attualmente richiesta è inferiore a n livelli al di sotto del nodo iniziale identificato, il nodo della pagina attualmente richiesto viene usato come nodo iniziale.If the node that represents the currently requested page is less than n levels below the identified starting node, the currently requested page node is used as the starting node.

Recupero dei dati della mappa del sitoRetrieving Site Map Data

I dati della mappa del sito vengono recuperati da un oggetto SiteMapProvider, ad esempio XmlSiteMapProvider, che è il provider della mappa del sito predefinito per ASP.NET.Site map data is retrieved from a SiteMapProvider object, such as XmlSiteMapProvider, which is the default site map provider for ASP.NET. È possibile specificare qualsiasi provider configurato per il sito per fornire i dati della mappa del sito al SiteMapDataSource e ottenere l'elenco dei provider disponibili accedendo alla raccolta di SiteMap.Providers.You can specify any provider that is configured for your site to provide the site map data to the SiteMapDataSource and can obtain the list of available providers by accessing the SiteMap.Providers collection.

Come tutti i controlli origine dati, ogni istanza di un SiteMapDataSource è associata a un singolo oggetto helper, noto come vista origine dati.Like all data source controls, every instance of a SiteMapDataSource is associated with a single helper object, known as a data source view. Il SiteMapDataSourceView è una vista sui dati della mappa del sito, in base alle proprietà dell'origine dati, e viene recuperato chiamando il metodo GetHierarchicalView.The SiteMapDataSourceView is a view on the site map data, according to the properties of the data source, and is retrieved by calling the GetHierarchicalView method. Il SiteMapDataSourceView gestisce l'oggetto SiteMapNodeCollection a cui sono associati i controlli.The SiteMapDataSourceView maintains the SiteMapNodeCollection object that the controls bind to.

Per impostazione predefinita, il nodo iniziale è il nodo radice della gerarchia, ma è possibile impostare il nodo iniziale su qualsiasi nodo.By default, the starting node is the root node of the hierarchy, but you can set the starting node to any node. Il punto di partenza può essere un nodo relativo alla posizione corrente nella mappa del sito o in una posizione assoluta.The starting point can be a node that is relative to the current position in the site map or to an absolute position. È possibile specificare il nodo iniziale impostando la proprietà StartingNodeUrl.You can specify the starting node by setting the StartingNodeUrl property.

Il SiteMapDataSource è specializzato per i dati di navigazione e non supporta operazioni comuni relative all'origine dati, ad esempio l'ordinamento, il filtraggio, il paging, la memorizzazione nella cache o operazioni di record di dati come aggiornamenti, inserimenti o eliminazioni.The SiteMapDataSource is specialized for navigation data, and does not support common data source operations such as sorting, filtering, paging, caching, or data record operations such as updates, insertions or deletions.

Sintassi dichiarativaDeclarative Syntax

<asp:SiteMapDataSource  
    EnableTheming="True|False"  
    EnableViewState="True|False"  
    ID="string"  
    OnDataBinding="DataBinding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnUnload="Unload event handler"  
    runat="server"  
    ShowStartingNode="True|False"  
    SiteMapProvider="string"  
    SkinID="string"  
    StartFromCurrentNode="True|False"  
    StartingNodeOffset="integer"  
    StartingNodeUrl="uri"  
    Visible="True|False"  
/>  

Costruttori

SiteMapDataSource()

Inizializza una nuova istanza della classe SiteMapDataSource.Initializes a new instance of the SiteMapDataSource class.

Proprietà

Adapter

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

(Ereditato da Control)
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)
BindingContainer

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

(Ereditato da Control)
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'identificatore del controllo server generato da ASP.NET.Gets the server control identifier generated by ASP.NET.

(Ereditato da HierarchicalDataSourceControl)
ClientIDMode

Questa proprietà non viene utilizzata per i controlli origine dati.This property is not used for data source controls.

(Ereditato da HierarchicalDataSourceControl)
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)
ContainsListCollection

Ottiene un valore che indica se il controllo origine dati contiene un insieme di oggetti visualizzazione origine dati.Gets a value indicating whether the data source control contains a collection of data source view objects.

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 HierarchicalDataSourceControl)
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)
EnableTheming

Ottiene un valore che indica se il controllo supporta i temi.Gets a value indicating whether this control supports themes.

(Ereditato da HierarchicalDataSourceControl)
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)
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)
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)
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)
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)
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)
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)
Provider

Ottiene o imposta un oggetto SiteMapProvider associato al controllo origine dati.Gets or sets a SiteMapProvider object that is associated with the data source 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)
ShowStartingNode

Ottiene o imposta un valore che indica se il nodo di inizio viene recuperato e visualizzato.Gets or sets a value indicating whether the starting node is retrieved and displayed.

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)
SiteMapProvider

Ottiene o imposta il nome del provider della mappa del sito a cui viene associata l'origine dati.Gets or sets the name of the site map provider that the data source binds to.

SkinID

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

(Ereditato da HierarchicalDataSourceControl)
StartFromCurrentNode

Ottiene o imposta un valore che indica se la struttura ad albero di nodi della mappa del sito viene recuperata utilizzando il nodo che rappresenta la pagina corrente.Gets or sets a value indicating whether the site map node tree is retrieved using the node that represents the current page.

StartingNodeOffset

Ottiene o imposta un offset di Integer positivo o negativo dal nodo di inizio che determina la gerarchia radice che viene esposta dal controllo origine dati.Gets or sets a positive or negative integer offset from the starting node that determines the root hierarchy that is exposed by the data source control.

StartingNodeUrl

Ottiene o imposta un nodo della mappa del sito che viene utilizzato dall'origine dati come punto di riferimento per recuperare i nodi da una mappa del sito gerarchica.Gets or sets a node in the site map that the data source then uses as a reference point to retrieve nodes from a hierarchical site map.

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)
UniqueID

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

(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.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 il controllo è visualizzato.Gets or sets a value indicating whether the control is visually displayed.

(Ereditato da HierarchicalDataSourceControl)

Metodi

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)
ApplyStyleSheetSkin(Page)

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

(Ereditato da HierarchicalDataSourceControl)
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)
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.

(Ereditato da HierarchicalDataSourceControl)
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 HierarchicalDataSourceControl)
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 del controllo.Sets input focus to the control.

(Ereditato da HierarchicalDataSourceControl)
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)
GetHierarchicalView(String)

Recupera una singola visualizzazione dei dati della mappa del sito per l'oggetto SiteMapProvider in base al nodo di inizio e ad altre proprietà dell'origine dati.Retrieves a single view on the site map data for the SiteMapProvider object according to the starting node and other properties of the data source.

GetList()

Recupera un elenco di controlli origine dati che possono essere utilizzati come origini degli elenchi di dati.Retrieves a list of data source controls that can be used as sources of lists of data.

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)
GetView(String)

Recupera una visualizzazione denominata nei dati della mappa del sito del provider della mappa del sito in base al nodo di inizio e ad altre proprietà dell'origine dati.Retrieves a named view on the site map data of the site map provider according to the starting node and other properties of the data source.

GetViewNames()

Recupera un insieme di visualizzazioni denominate per il controllo origine dati.Retrieves a collection of named views for the data source control.

HasControls()

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

(Ereditato da HierarchicalDataSourceControl)
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 di pagina precedente salvata dal metodo SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

(Ereditato da Control)
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)
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)
OnDataSourceChanged(EventArgs)

Genera l'evento DataSourceChanged.Raises the DataSourceChanged event.

(Ereditato da HierarchicalDataSourceControl)
OnInit(EventArgs)

Genera l'evento Init.Raises the Init event.

(Ereditato da Control)
OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento PreRender.Raises the PreRender event.

(Ereditato da Control)
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)
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)

Invia il contenuto del controllo server a un oggetto HtmlTextWriter specificato che scrive il contenuto di cui eseguire il rendering nel client.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Ereditato da Control)
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)
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 HierarchicalDataSourceControl)
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)
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 eventuali modifiche dello stato di visualizzazione di un controllo server apportate dopo il postback della pagina nel server.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

(Ereditato da Control)
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()

Attiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo server per consentirne la memorizzazione nell'oggetto StateBag del controllo server.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. È possibile accedere a questo oggetto tramite la proprietà ViewState.This object is accessible through the ViewState property.

(Ereditato da Control)

Eventi

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

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)
IDataSource.DataSourceChanged

Si verifica quando un controllo origine dati ha subito una qualsiasi modifica che influisce su controlli con associazione a dati.Occurs when a data source control has changed in some way that affects data-bound controls.

IDataSource.GetView(String)

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

IDataSource.GetViewNames()

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

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)
IHierarchicalDataSource.DataSourceChanged

Si verifica quando l'oggetto HierarchicalDataSourceControl ha subito una qualsiasi modifica che influisce su controlli con associazione a dati.Occurs when the HierarchicalDataSourceControl has changed in some way that affects data-bound controls.

(Ereditato da HierarchicalDataSourceControl)
IHierarchicalDataSource.GetHierarchicalView(String)

Ottiene l'oggetto di supporto della visualizzazione per l'interfaccia IHierarchicalDataSource per il percorso specificato.Gets the view helper object for the IHierarchicalDataSource interface for the specified path.

(Ereditato da HierarchicalDataSourceControl)
IListSource.ContainsListCollection

Ottiene un valore che indica se l'insieme è costituito da oggetti IList.Gets a value that indicates whether the collection is a collection of IList objects.

IListSource.GetList()

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

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.

GetDefaultValues(IDataSource)

Ottiene l'insieme di valori predefiniti per l'origine dati specificata.Gets the collection of the default values for the specified data source.

GetMetaTable(IDataSource)

Ottiene i metadati per una tabella nell'oggetto origine dati specificato.Gets the metadata for a table in the specified data source object.

TryGetMetaTable(IDataSource, MetaTable)

Determina se sono disponibili i metadati della tabella.Determines whether table metadata is available.

Si applica a

Vedi anche