XmlDataSource Classe

Definizione

Rappresenta un'origine dati XML per i controlli associati a dati.

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

Esempio

In questa sezione sono riportati due esempi di codice. Il primo esempio di codice illustra come usare un controllo con un XmlDataSourceTreeView controllo per visualizzare i dati XML dal file XML di esempio. Il secondo esempio illustra come usare un controllo con un XmlDataSource controllo modello Repeater per visualizzare i dati XML.

Nell'esempio di codice seguente viene illustrato come usare un controllo con un XmlDataSourceTreeView controllo per visualizzare i dati XML. Carica XmlDataSource i dati XML dal file XML identificato dalla DataFile proprietà .

<%@ 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:xmldatasource
        id="XmlDataSource1"
        runat="server"
        datafile="books.xml" />

      <!- TreeView uses hierachical data, so the
          XmlDataSource uses an XmlHierarchicalDataSourceView
          when a TreeView is bound to it. -->

      <asp:TreeView
        id="TreeView1"
        runat="server"
        datasourceid="XmlDataSource1">
        <databindings>
          <asp:treenodebinding datamember="book" textfield="title"/>
        </databindings>
      </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:xmldatasource
        id="XmlDataSource1"
        runat="server"
        datafile="books.xml" />

      <!- TreeView uses hierachical data, so the
          XmlDataSource uses an XmlHierarchicalDataSourceView
          when a TreeView is bound to it. -->

      <asp:TreeView
        id="TreeView1"
        runat="server"
        datasourceid="XmlDataSource1">
        <databindings>
          <asp:treenodebinding datamember="book" textfield="title"/>
        </databindings>
      </asp:TreeView>

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

Il file XML nell'esempio di codice contiene i dati seguenti:

<books>  
   <computerbooks>  
     <book title="Secrets of Silicon Valley" author="Sheryl Hunter"/>  
     <book title="Straight Talk About Computers" author="Dean Straight"/>  
     <book title="You Can Combat Computer Stress!" author="Marjorie Green"/>                  
   </computerbooks>  
   <cookbooks>  
     <book title="Silicon Valley Gastronomic Treats" author="Innes del Castill"/>  
   </cookbooks>  
</books>  

Nell'esempio di codice seguente viene illustrato come usare un controllo con un XmlDataSource controllo modello Repeater per visualizzare i dati XML. Il Repeater controllo usa un'espressione di data binding XPath per associare agli elementi di dati all'interno del documento XML rappresentato XmlDataSource . Per altre informazioni sulla XPath sintassi di XPathSelect data binding, vedere la XPathBinder classe .

<%@ 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>Order</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        XPath="orders/order"
        DataFile="order.xml" />

      <asp:Repeater ID="Repeater1"
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h2>Order</h2>
            <table>
              <tr>
                <td>Customer</td>
                <td><%#XPath("customer/@id")%></td>
                <td><%#XPath("customername/firstn")%></td>
                <td><%#XPath("customername/lastn")%></td>
              </tr>
              <tr>
                <td>Ship To</td>
                <td><%#XPath("shipaddress/address1")%></font></td>
                <td><%#XPath("shipaddress/city")%></td>
                <td><%#XPath("shipaddress/state")%>,
                    <%#XPath("shipaddress/zip")%></td>
              </tr>
            </table>
            <h3>Order Summary</h3>
            <asp:Repeater ID="Repeater2"
                 DataSource='<%#XPathSelect("summary/item")%>'
                 runat="server">
                <ItemTemplate>
                     <b><%#XPath("@dept")%></b> -
                         <%#XPath(".")%><br />
                </ItemTemplate>
            </asp:Repeater>
            <hr />
        </ItemTemplate>
    </asp:Repeater>

  </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>Order</title>
</head>
<body> 
    <form id="form1" runat="server">
      <asp:XmlDataSource
        runat="server"
        id="XmlDataSource1"
        XPath="orders/order"
        DataFile="order.xml" />

      <asp:Repeater ID="Repeater1"
        runat="server"
        DataSourceID="XmlDataSource1">
        <ItemTemplate>
            <h2>Order</h2>
            <table>
              <tr>
                <td>Customer</td>
                <td><%#XPath("customer/@id")%></td>
                <td><%#XPath("customername/firstn")%></td>
                <td><%#XPath("customername/lastn")%></td>
              </tr>
              <tr>
                <td>Ship To</td>
                <td><%#XPath("shipaddress/address1")%></font></td>
                <td><%#XPath("shipaddress/city")%></td>
                <td><%#XPath("shipaddress/state")%>,
                    <%#XPath("shipaddress/zip")%></td>
              </tr>
            </table>
            <h3>Order Summary</h3>
            <asp:Repeater ID="Repeater2"
                 DataSource='<%#XPathSelect("summary/item")%>'
                 runat="server">
                <ItemTemplate>
                     <b><%#XPath("@dept")%></b> -
                         <%#XPath(".")%><br />
                </ItemTemplate>
            </asp:Repeater>
            <hr />
        </ItemTemplate>
    </asp:Repeater>

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

Il file XML nell'esempio di codice contiene i dati seguenti:

<?xml version="1.0" encoding="iso-8859-1"?>  
 <orders>  
   <order>  
     <customer id="12345" />  
     <customername>  
         <firstn>John</firstn>  
         <lastn>Smith</lastn>  
     </customername>  
     <transaction id="12345" />  
     <shipaddress>  
         <address1>1234 Tenth Avenue</address1>  
         <city>Bellevue</city>  
         <state>Washington</state>  
         <zip>98001</zip>  
     </shipaddress>  
     <summary>  
         <item dept="tools">screwdriver</item>  
         <item dept="tools">hammer</item>  
         <item dept="plumbing">fixture</item>  
     </summary>  
   </order>  
</orders>  

Commenti

In questo argomento

Introduzione

Il XmlDataSource controllo è un controllo origine dati che presenta i dati XML ai controlli associati ai dati. Il XmlDataSource controllo può essere usato dai controlli associati ai dati per visualizzare dati gerarchici e tabulari. Il XmlDataSource controllo viene in genere usato per visualizzare i dati XML gerarchici negli scenari di sola lettura. Poiché il controllo estende la XmlDataSourceHierarchicalDataSourceControl classe, funziona con i dati gerarchici. Il XmlDataSource controllo implementa anche l'interfaccia IDataSource e funziona con dati tabulari o di tipo elenco.

Nota

A scopo di sicurezza, nessuno delle proprietà del XmlDataSource controllo viene archiviato nello stato di visualizzazione. Poiché è tecnicamente possibile decodificare il contenuto dello stato di visualizzazione nel client, archiviare informazioni riservate sulla struttura dei dati o il relativo contenuto potrebbe esporre a una minaccia di divulgazione delle informazioni. Si noti che se è necessario archiviare informazioni come XPath la proprietà nello stato di visualizzazione, è possibile abilitare la crittografia per proteggere il contenuto impostando ViewStateEncryptionMode la @ Page direttiva.

Gli sviluppatori di pagine usano il XmlDataSource controllo per visualizzare i dati XML usando i controlli associati ai dati.

Origini di dati XML

In XmlDataSource genere carica i dati XML da un file XML, specificato dalla DataFile proprietà . I dati XML possono essere archiviati direttamente dal controllo origine dati in formato stringa usando la Data proprietà . Se si desidera trasformare i dati XML prima che venga visualizzato da un controllo associato a dati, è possibile fornire un foglio di stile XSL (Extensible Stylesheet Language) per la trasformazione. Come per i dati XML, in genere si carica il foglio di stile da un file, indicato dalla TransformFile proprietà, ma è anche possibile archiviarlo in formato stringa direttamente usando la Transform proprietà .

Aggiornamento dei dati XML

Il XmlDataSource controllo viene comunemente usato negli scenari di dati di sola lettura in cui un controllo associato a dati visualizza i dati XML. Tuttavia, è anche possibile utilizzare il XmlDataSource controllo per modificare i dati XML. Per modificare i dati XML, chiamare il GetXmlDocument metodo per recuperare un XmlDataDocument oggetto che rappresenta una rappresentazione in memoria dei dati XML. È possibile utilizzare il modello a oggetti esposto dagli XmlDataDocument oggetti e XmlNode che contiene o utilizzare un'espressione di filtro XPath per modificare i dati nel documento. Dopo aver apportato modifiche alla rappresentazione in memoria dei dati XML, è possibile salvarla su disco chiamando il Save metodo .

Esistono alcune restrizioni alle funzionalità di modifica del XmlDataSource controllo:

  • I dati XML devono essere caricati da un file XML indicato dalla DataFile proprietà, non dal codice XML inline specificato nella Data proprietà .

  • Non è possibile specificare alcuna trasformazione XSLT nelle Transform proprietà o TransformFile .

  • Il Save metodo non gestisce le operazioni di salvataggio simultanee da richieste diverse. Se più utenti modificano un file XML tramite XmlDataSource, non è garantito che tutti gli utenti funzionino con gli stessi dati. È anche possibile che un'operazione Save non riesca a causa di questi stessi problemi di concorrenza.

Specifica di una trasformazione XSL

Un'operazione comune eseguita con i dati XML consiste nel trasformarla da un set di dati XML a un altro. Il XmlDataSource controllo supporta le trasformazioni XML con le Transform proprietà e TransformFile , che specificano un foglio di stile XSL da applicare ai dati XML prima che vengano passati a un controllo associato a dati e la TransformArgumentList proprietà , che consente di fornire argomenti del foglio di stile XSLT dinamici da utilizzare da un foglio di stile XSL durante la trasformazione. Se si specifica un'espressione di filtro XPath usando la XPath proprietà , questa viene applicata dopo l'applicazione della trasformazione.

Nota

La XmlDataSource classe usa la classe deprecata XslTransform per eseguire trasformazioni XSL. Se si desidera utilizzare le caratteristiche del foglio di stile introdotte dopo la deprecazione della XslTransform classe, applicare manualmente le trasformazioni usando la XslCompiledTransform classe .

Applicazione di filtri tramite un'espressione XPath

Per impostazione predefinita, il XmlDataSource controllo carica tutti i dati XML nel file XML identificato dalla DataFile proprietà o trovato inline nella Data proprietà , ma è possibile filtrare i dati usando un'espressione XPath. La XPath proprietà supporta un filtro della sintassi XPath applicato dopo il caricamento e la trasformazione dei dati XML.

Memorizzazione nella cache

Ai fini delle prestazioni, la memorizzazione nella cache è abilitata per il XmlDataSource controllo per impostazione predefinita. L'apertura e la lettura di un file XML nel server ogni volta che una pagina richiesta può ridurre le prestazioni dell'applicazione. La memorizzazione nella cache consente di ridurre il carico di elaborazione sul server a scapito della memoria nel server Web; nella maggior parte dei casi questo è un buon compromesso. Memorizza XmlDataSource automaticamente nella cache i dati quando la EnableCaching proprietà è impostata su e la CacheDuration proprietà viene impostata truesul numero di secondi in cui la cache archivia i dati prima che la cache venga invalidata. È possibile usare per CacheExpirationPolicy ottimizzare ulteriormente il comportamento di memorizzazione nella cache del controllo origine dati.

Funzionalità aggiuntive

Nella tabella seguente sono elencate le funzionalità aggiuntive supportate dal XmlDataSource controllo .

Funzionalità Descrizione
Ordinamento Non supportato dal XmlDataSource controllo .
Filtro La XPath proprietà può essere utilizzata per filtrare i dati XML usando un'espressione XPath appropriata.
Paging Non supportato dal XmlDataSource controllo .
Aggiornamento Supportato modificando direttamente e XmlDataDocument quindi chiamando il Save metodo .
Deleting Supportato modificando direttamente e XmlDataDocument quindi chiamando il Save metodo .
Inserimento Supportato modificando direttamente e XmlDataDocument quindi chiamando il Save metodo .
Memorizzazione nella cache Abilitato per impostazione predefinita, con la CacheDuration proprietà impostata su 0 (infinito) e la CacheExpirationPolicy proprietà impostata su Absolute.

Oggetto Vista dati

Poiché il XmlDataSource controllo supporta controlli associati a dati che visualizzano dati gerarchici e controlli che visualizzano dati tabulari, il controllo origine dati supporta più tipi di oggetti vista origine dati sui dati XML sottostanti. Il XmlDataSource controllo recupera un singolo oggetto denominato XmlDataSourceView quando viene utilizzato con un controllo associato a dati che visualizza i dati tabulari. Il GetViewNames metodo identifica questa singola vista denominata. Se usato con un controllo associato a dati che visualizza i dati gerarchici, il XmlDataSource controllo recupera un XmlHierarchicalDataSourceView oggetto per qualsiasi percorso gerarchico univoco passato al GetHierarchicalView metodo .

Sintassi dichiarativa

<asp:XmlDataSource  
    CacheDuration="string|Infinite"  
    CacheExpirationPolicy="Absolute|Sliding"  
    CacheKeyDependency="string"  
    DataFile="string"  
    EnableCaching="True|False"  
    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"  
    OnTransforming="Transforming event handler"  
    OnUnload="Unload event handler"  
    runat="server"  
    SkinID="string"  
    TransformArgumentList="string"  
    TransformFile="string"  
    Visible="True|False"  
    XPath="string"  
>  
    <Data>string</Data>  
    <Transform>string</Transform>  
</asp:XmlDataSource>  

Costruttori

XmlDataSource()

Crea una nuova istanza della classe XmlDataSource.

Proprietà

Adapter

Ottiene l'adattatore specifico del browser per il controllo.

(Ereditato da Control)
AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.

(Ereditato da Control)
BindingContainer

Ottiene il controllo contenente l'associazione dati del controllo corrente.

(Ereditato da Control)
CacheDuration

Ottiene o imposta il numero di secondi durante i quali il controllo origine dati memorizza nella cache i dati che ha recuperato.

CacheExpirationPolicy

Ottiene o imposta i criteri di scadenza della cache che vengono combinati con la durata della cache per descrivere il comportamento di memorizzazione nella cache utilizzata dal controllo origine dati.

CacheKeyContext

Ottiene o imposta il valore della chiave di cache per il controllo origine dati dallo stato di visualizzazione o aggiunge la chiave di cache allo stato di visualizzazione.

CacheKeyDependency

Ottiene o imposta una dipendenza di chiave definita dall'utente collegata a tutti gli oggetti cache dati creati dal controllo origine dati. Tutti gli oggetti cache scadono in modo esplicito quando scade la chiave.

ChildControlsCreated

Ottiene un valore che indica se i controlli figli del controllo server sono stati creati.

(Ereditato da Control)
ClientID

Ottiene l'identificatore del controllo server generato da ASP.NET.

(Ereditato da HierarchicalDataSourceControl)
ClientIDMode

Questa proprietà non viene utilizzata per i controlli origine dati.

(Ereditato da HierarchicalDataSourceControl)
ClientIDSeparator

Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID.

(Ereditato da Control)
Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.

(Ereditato da Control)
Controls

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.

(Ereditato da HierarchicalDataSourceControl)
Data

Ottiene o imposta un blocco di dati XML a cui si associa il controllo origine dati.

DataFile

Specifica il nome file di un file XML a cui si associa il controllo origine dati.

DataItemContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.

(Ereditato da Control)
DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.

(Ereditato da Control)
DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.

(Ereditato da Control)
EnableCaching

Ottiene o imposta un valore indicante se la memorizzazione di dati nella cache è abilitata nel controllo XmlDataSource.

EnableTheming

Ottiene un valore che indica se il controllo supporta i temi.

(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.

(Ereditato da Control)
Events

Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura.

(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.

(Ereditato da Control)
ID

Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server.

(Ereditato da Control)
IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.

(Ereditato da Control)
IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo.

(Ereditato da Control)
IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione.

(Ereditato da Control)
IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente.

(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.

(Ereditato da Control)
NamingContainer

Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID.

(Ereditato da Control)
Page

Ottiene un riferimento all'istanza Page che contiene il controllo server.

(Ereditato da Control)
Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.

(Ereditato da Control)
RenderingCompatibility

Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.

(Ereditato da Control)
Site

Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione.

(Ereditato da Control)
SkinID

Ottiene o imposta l'interfaccia da applicare al controllo HierarchicalDataSourceControl.

(Ereditato da HierarchicalDataSourceControl)
TemplateControl

Ottiene o imposta un riferimento al modello che contiene il controllo.

(Ereditato da Control)
TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente.

(Ereditato da Control)
Transform

Ottiene o imposta un blocco di dati XSL (Extensible Stylesheet Language) che definisce una trasformazione XSLT da eseguire sui dati XML gestiti dal controllo XmlDataSource.

TransformArgumentList

Fornisce un elenco di argomenti XSLT utilizzati con il foglio di stile definito dalla proprietà Transform o TransformFile per eseguire una trasformazione sui dati XML.

TransformFile

Specifica il nome di un file XSL (Extensible Stylesheet Language), con estensione XSL, che definisce una trasformazione XSLT da eseguire sui dati XML gestiti dal controllo XmlDataSource.

UniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.

(Ereditato da Control)
ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser.

(Ereditato da Control)
ViewState

Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina.

(Ereditato da Control)
ViewStateIgnoresCase

Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole.

(Ereditato da Control)
ViewStateMode

Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo.

(Ereditato da Control)
Visible

Ottiene o imposta un valore che indica se il controllo è visualizzato.

(Ereditato da HierarchicalDataSourceControl)
XPath

Specifica un'espressione XPath da applicare ai dati XML contenuti dalla proprietà Data o dal file XML indicato dalla proprietà DataFile.

Metodi

AddedControl(Control, Int32)

Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto Control.

(Ereditato da Control)
AddParsedSubObject(Object)

Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server.

(Ereditato da Control)
ApplyStyleSheetSkin(Page)

Applica al controllo le proprietà di stile definite nel foglio di stile della pagina.

(Ereditato da HierarchicalDataSourceControl)
BeginRenderTracing(TextWriter, Object)

Inizia la traccia in fase di progettazione dei dati di rendering.

(Ereditato da Control)
BuildProfileTree(String, Boolean)

Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina.

(Ereditato da Control)
ClearCachedClientID()

Imposta il valore memorizzato nella cache ClientID su null.

(Ereditato da Control)
ClearChildControlState()

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.

(Ereditato da Control)
ClearChildState()

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.

(Ereditato da Control)
ClearChildViewState()

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.

(Ereditato da Control)
ClearEffectiveClientIDMode()

Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.

(Ereditato da Control)
CreateChildControls()

Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering.

(Ereditato da Control)
CreateControlCollection()

Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server.

(Ereditato da HierarchicalDataSourceControl)
DataBind()

Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio.

(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.

(Ereditato da Control)
DataBindChildren()

Associa un'origine dati al controllo server e ai relativi controlli figlio.

(Ereditato da Control)
Dispose()

Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla memoria.

(Ereditato da Control)
EndRenderTracing(TextWriter, Object)

Termina la traccia in fase di progettazione dei dati di rendering.

(Ereditato da Control)
EnsureChildControls()

Determina se il controllo server contiene controlli figlio. In caso contrario, li crea.

(Ereditato da Control)
EnsureID()

Crea un identificatore per i controlli a cui non è assegnato alcun identificatore.

(Ereditato da Control)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
FindControl(String)

Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.

(Ereditato da 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. Non eseguire l'override di questa versione del metodo FindControl.

(Ereditato da Control)
Focus()

Imposta lo stato attivo per l'input del controllo.

(Ereditato da HierarchicalDataSourceControl)
GetDesignModeState()

Ottiene i dati della fase di progettazione per un controllo.

(Ereditato da Control)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetHierarchicalView(String)

Ottiene l'oggetto visualizzazione origine dati per il controllo XmlDataSource. Il parametro viewPath può essere un'espressione XPath.

GetRouteUrl(Object)

Ottiene l'URL corrispondente a un set di parametri di route.

(Ereditato da Control)
GetRouteUrl(RouteValueDictionary)

Ottiene l'URL corrispondente a un set di parametri di route.

(Ereditato da Control)
GetRouteUrl(String, Object)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.

(Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.

(Ereditato da Control)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
GetUniqueIDRelativeTo(Control)

Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato.

(Ereditato da Control)
GetXmlDocument()

Carica in memoria i dati XML, direttamente dall'archivio dati sottostante o dalla cache, e li restituisce nella forma di un oggetto XmlDataDocument.

HasControls()

Determina se il controllo server contiene controlli figlio.

(Ereditato da HierarchicalDataSourceControl)
HasEvents()

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio.

(Ereditato da Control)
IsLiteralContent()

Determina se il controllo server conserva solo il contenuto literal.

(Ereditato da Control)
LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState().

(Ereditato da Control)
LoadViewState(Object)

Ripristina le informazioni sullo stato di visualizzazione da una richiesta di pagina precedente salvata dal metodo SaveViewState().

(Ereditato da Control)
MapPathSecure(String)

Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo.

(Ereditato da Control)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(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.

(Ereditato da Control)
OnDataBinding(EventArgs)

Genera l'evento DataBinding.

(Ereditato da Control)
OnDataSourceChanged(EventArgs)

Genera l'evento DataSourceChanged.

(Ereditato da HierarchicalDataSourceControl)
OnInit(EventArgs)

Genera l'evento Init.

(Ereditato da Control)
OnLoad(EventArgs)

Genera l'evento Load.

(Ereditato da Control)
OnPreRender(EventArgs)

Genera l'evento PreRender.

(Ereditato da Control)
OnTransforming(EventArgs)

Genera l'evento Transforming prima che il controllo XmlDataSource esegua una trasformazione XSLT sui suoi dati XML.

OnUnload(EventArgs)

Genera l'evento Unload.

(Ereditato da Control)
OpenFile(String)

Ottiene un oggetto Stream utilizzato per leggere un file.

(Ereditato da Control)
RaiseBubbleEvent(Object, EventArgs)

Assegna eventuali origini dell'evento e relative informazioni al controllo padre.

(Ereditato da Control)
RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control.

(Ereditato da Control)
Render(HtmlTextWriter)

Invia il contenuto del controllo server a un oggetto HtmlTextWriter specificato che scrive il contenuto di cui eseguire il rendering nel client.

(Ereditato da Control)
RenderChildren(HtmlTextWriter)

Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client.

(Ereditato da Control)
RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata.

(Ereditato da HierarchicalDataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.

(Ereditato da Control)
ResolveAdapter()

Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato.

(Ereditato da Control)
ResolveClientUrl(String)

Ottiene un URL che può essere utilizzato dal browser.

(Ereditato da Control)
ResolveUrl(String)

Converte un URL in un formato utilizzabile dal client richiedente.

(Ereditato da Control)
Save()

Salva i dati XML al momento in memoria utilizzando il controllo XmlDataSource su disco se è impostata la proprietà DataFile.

SaveControlState()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.

(Ereditato da Control)
SaveViewState()

Salva eventuali modifiche dello stato di visualizzazione di un controllo server apportate dopo il postback della pagina nel server.

(Ereditato da Control)
SetDesignModeState(IDictionary)

Imposta i dati della fase di progettazione per un controllo.

(Ereditato da Control)
SetRenderMethodDelegate(RenderMethod)

Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre.

(Ereditato da Control)
SetTraceData(Object, Object)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia.

(Ereditato da Control)
SetTraceData(Object, Object, Object)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia.

(Ereditato da Control)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
TrackViewState()

Attiva il rilevamento delle modifiche dello stato di visualizzazione nel controllo server per consentirne la memorizzazione nell'oggetto StateBag del controllo server. È possibile accedere a questo oggetto tramite la proprietà ViewState.

(Ereditato da Control)

Eventi

DataBinding

Viene generato quando il controllo server viene associato a un'origine dati.

(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.

(Ereditato da Control)
Init

Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata.

(Ereditato da Control)
Load

Viene generato quando il controllo server è caricato nell'oggetto Page.

(Ereditato da Control)
PreRender

Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering.

(Ereditato da Control)
Transforming

Si verifica prima che il foglio di stile definito dalla proprietà Transform o identificato dalla proprietà TransformFile venga applicato ai dati XML.

Unload

Viene generato quando il controllo server viene scaricato dalla memoria.

(Ereditato da Control)

Implementazioni dell'interfaccia esplicita

IControlBuilderAccessor.ControlBuilder

Per una descrizione di questo membro, vedere ControlBuilder.

(Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()

Per una descrizione di questo membro, vedere GetDesignModeState().

(Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary).

(Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Per una descrizione di questo membro, vedere SetOwnerControl(Control).

(Ereditato da Control)
IControlDesignerAccessor.UserData

Per una descrizione di questo membro, vedere UserData.

(Ereditato da Control)
IDataBindingsAccessor.DataBindings

Per una descrizione di questo membro, vedere DataBindings.

(Ereditato da Control)
IDataBindingsAccessor.HasDataBindings

Per una descrizione di questo membro, vedere HasDataBindings.

(Ereditato da Control)
IDataSource.DataSourceChanged

Per una descrizione di questo membro, vedere DataSourceChanged.

IDataSource.GetView(String)

Ottiene la visualizzazione origine dati denominata associata al controllo origine dati.

IDataSource.GetViewNames()

Per una descrizione di questo membro, vedere GetViewNames().

IExpressionsAccessor.Expressions

Per una descrizione di questo membro, vedere Expressions.

(Ereditato da Control)
IExpressionsAccessor.HasExpressions

Per una descrizione di questo membro, vedere HasExpressions.

(Ereditato da Control)
IHierarchicalDataSource.DataSourceChanged

Si verifica quando l'oggetto HierarchicalDataSourceControl ha subito una qualsiasi modifica che influisce su controlli con associazione a dati.

(Ereditato da HierarchicalDataSourceControl)
IHierarchicalDataSource.GetHierarchicalView(String)

Ottiene l'oggetto di supporto della visualizzazione per l'interfaccia IHierarchicalDataSource per il percorso specificato.

(Ereditato da HierarchicalDataSourceControl)
IListSource.ContainsListCollection

Per una descrizione di questo membro, vedere ContainsListCollection.

IListSource.GetList()

Per una descrizione di questo membro, vedere GetList().

IParserAccessor.AddParsedSubObject(Object)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).

(Ereditato da Control)

Metodi di estensione

FindDataSourceControl(Control)

Restituisce l'origine dati associata al controllo dati per il controllo specificato.

FindFieldTemplate(Control, String)

Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.

FindMetaTable(Control)

Restituisce l'oggetto metatabella per il controllo contenitore dei dati.

GetDefaultValues(IDataSource)

Ottiene l'insieme di valori predefiniti per l'origine dati specificata.

GetMetaTable(IDataSource)

Ottiene i metadati per una tabella nell'oggetto origine dati specificato.

TryGetMetaTable(IDataSource, MetaTable)

Determina se sono disponibili i metadati della tabella.

Si applica a

Vedi anche