XmlDataSource XmlDataSource XmlDataSource XmlDataSource Class

Definizione

Rappresenta un'origine dati XML per i controlli associati a dati.Represents an XML data source to data-bound controls.

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
type XmlDataSource = class
    inherit HierarchicalDataSourceControl
    interface IDataSource
    interface IListSource
Public Class XmlDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource
Ereditarietà
Attributi
Implementazioni

Esempi

In questa sezione sono riportati due esempi di codice.This section contains two code examples. Nel primo esempio di codice viene illustrato come utilizzare XmlDataSource un controllo con TreeView un controllo per visualizzare i dati XML dal file XML di esempio.The first code example demonstrates how to use an XmlDataSource control with a TreeView control to display XML data from the sample XML file. Nel secondo esempio viene illustrato come utilizzare un XmlDataSource controllo con un Repeater controllo basato su modelli per visualizzare i dati XML.The second example demonstrates how to use an XmlDataSource control with a templated Repeater control to display XML data.

Nell'esempio di codice riportato di seguito viene illustrato XmlDataSource come utilizzare un TreeView controllo con un controllo per visualizzare i dati XML.The following code example demonstrates how to use an XmlDataSource control with a TreeView control to display XML data. Carica i dati XML dal file XML identificato DataFile dalla proprietà. XmlDataSourceThe XmlDataSource loads XML data from the XML file identified by the DataFile property.

<%@ 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 include i dati seguenti:The XML file in the code example has the following data:

<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 riportato di seguito viene illustrato XmlDataSource come utilizzare un controllo con Repeater un controllo basato su modelli per visualizzare i dati XML.The following code example demonstrates how to use an XmlDataSource control with a templated Repeater control to display XML data. Il Repeater controllo utilizza un'espressione di associazione dati XPath per associare gli elementi di dati all'interno del documento XmlDataSource XML rappresentato da.The Repeater control uses an XPath data-binding expression to bind to data items within the XML document that the XmlDataSource represents. Per ulteriori informazioni sulla XPath XPathSelect sintassi di data binding, vedere la XPathBinder classe.For more information about XPath and XPathSelect data-binding syntax, see the XPathBinder class.

<%@ 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 include i dati seguenti:The XML file in the code example has the following data:

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

IntroduzioneIntroduction

Il XmlDataSource controllo è un controllo origine dati che presenta dati XML ai controlli con associazione a dati.The XmlDataSource control is a data source control that presents XML data to data-bound controls. Il XmlDataSource controllo può essere utilizzato dai controlli associati a dati per visualizzare sia i dati gerarchici che quelli tabulari.The XmlDataSource control can be used by data-bound controls to display both hierarchical and tabular data. Il XmlDataSource controllo viene in genere utilizzato per visualizzare i dati XML gerarchici in scenari di sola lettura.The XmlDataSource control is typically used to display hierarchical XML data in read-only scenarios. Poiché il XmlDataSource controllo estende la HierarchicalDataSourceControl classe, funziona con i dati gerarchici.Because the XmlDataSource control extends the HierarchicalDataSourceControl class, it works with hierarchical data. Il XmlDataSource controllo implementa anche l' IDataSource interfaccia e funziona con dati tabulari o di tipo elenco.The XmlDataSource control also implements the IDataSource interface and works with tabular, or list-style, data.

Nota

Per motivi di sicurezza, nessuna delle XmlDataSource proprietà del controllo viene archiviata nello stato di visualizzazione.For security purposes, none of the XmlDataSource control properties are stored in view state. Poiché è tecnicamente possibile decodificare il contenuto dello stato di visualizzazione nel client, l'archiviazione di informazioni riservate sulla struttura dei dati o sul suo contenuto potrebbe esporre una minaccia di divulgazione di informazioni.Since it is technically possible to decode the contents of view state on the client, storing sensitive information about the data structure or its contents could expose you to an information disclosure threat. Si noti che se è necessario archiviare informazioni come XPath la proprietà nello stato di visualizzazione, è possibile abilitare la crittografia per proteggere il contenuto ViewStateEncryptionMode impostando sulla @ Page direttiva.Note that if you need to store information such as XPath property in view state, you can enable encryption to protect the contents by setting ViewStateEncryptionMode on the @ Page directive.

Gli sviluppatori di pagine XmlDataSource utilizzano il controllo per visualizzare i dati XML utilizzando i controlli associati a dati.Page developers use the XmlDataSource control to display XML data using data-bound controls.

Origini dei dati XMLSources of XML Data

In XmlDataSource genere i dati XML vengono caricati da un file XML, specificato DataFile dalla proprietà.The XmlDataSource typically loads XML data from an XML file, which is specified by the DataFile property. I dati XML possono anche essere archiviati direttamente dal controllo origine dati in formato stringa utilizzando la Data proprietà.XML data can also be stored directly by the data source control in string form using the Data property. Se si desidera trasformare i dati XML prima che vengano visualizzati da un controllo associato a dati, è possibile specificare un foglio di stile Extensible Stylesheet Language (XSL) per la trasformazione.If you want to transform the XML data before it is displayed by a data-bound control, you can provide an Extensible Stylesheet Language (XSL) style sheet for the transformation. Come per i dati XML, in genere si carica il foglio di stile da un file, indicato TransformFile dalla proprietà, ma è anche possibile archiviarlo in formato stringa direttamente usando Transform la proprietà.As with the XML data, you typically load the style sheet from a file, indicated by the TransformFile property, but you can also store it in string form directly using the Transform property.

Aggiornamento di dati XMLUpdating XML Data

Il XmlDataSource controllo viene comunemente utilizzato negli scenari di dati di sola lettura in cui un controllo con associazione a dati Visualizza dati XML.The XmlDataSource control is commonly used in read-only data scenarios where a data-bound control displays XML data. Tuttavia, è anche possibile usare il XmlDataSource controllo per modificare i dati XML.However, you can also use the XmlDataSource control to edit XML data. Per modificare i dati XML, chiamare il GetXmlDocument metodo per recuperare un XmlDataDocument oggetto che è una rappresentazione in memoria dei dati XML.To edit the XML data, call the GetXmlDocument method to retrieve an XmlDataDocument object that is an in-memory representation of the XML data. È possibile utilizzare il modello a oggetti esposto dagli XmlDataDocument oggetti XmlNode e in esso contenuti oppure utilizzare un'espressione di filtro XPath per modificare i dati nel documento.You can use the object model exposed by the XmlDataDocument and XmlNode objects it contains or use an XPath filtering expression to manipulate data in the document. Dopo aver apportato modifiche alla rappresentazione in memoria dei dati XML, è possibile salvarli su disco chiamando il Save metodo.When you have made changes to the in-memory representation of the XML data, you can save it to disk by calling the Save method.

Esistono alcune restrizioni per le funzionalità di modifica del XmlDataSource controllo:There are some restrictions to the editing capabilities of the XmlDataSource control:

  • I dati XML devono essere caricati da un file XML indicato dalla DataFile proprietà, non dal codice XML inline specificato Data nella proprietà.The XML data must be loaded from an XML file that is indicated by the DataFile property, not from inline XML specified in the Data property.

  • Non è possibile specificare alcuna trasformazione XSLT nelle Transform proprietà TransformFile o.No XSLT transformation can be specified in the Transform or TransformFile properties.

  • Il Save metodo non gestisce operazioni di salvataggio simultanee da parte di richieste diverse.The Save method does not handle concurrent save operations by different requests. Se più di un utente sta modificando un file XML tramite XmlDataSource, non vi è alcuna garanzia che tutti gli utenti stiano utilizzando gli stessi dati.If more than one user is editing an XML file through the XmlDataSource, there is no guarantee that all users are operating with the same data. È anche possibile che un' Save operazione abbia esito negativo a causa di questi stessi problemi di concorrenza.It is also possible for a Save operation to fail due to these same concurrency issues.

Specifica di una trasformazione XSLSpecifying an XSL Transformation

Un'operazione comune eseguita con i dati XML lo trasforma da un set di dati XML in un altro.A common operation performed with XML data is transforming it from one XML data set into another. Il XmlDataSource controllo supporta le trasformazioni XML con Transform le TransformFile proprietà e, che specificano un foglio di stile XSL da applicare ai dati XML prima che venga passato a un controllo con associazione a TransformArgumentList dati e la proprietà, che consente di fornire argomenti del foglio di stile XSLT dinamici che devono essere utilizzati da un foglio di stile XSL durante la trasformazione.The XmlDataSource control supports XML transformations with the Transform and TransformFile properties, which specify an XSL style sheet to apply to XML data before it is passed to a data-bound control, and the TransformArgumentList property, which enables you to supply dynamic XSLT style sheet arguments to be used by an XSL style sheet during the transformation. Se si specifica un'espressione di filtro XPath usando XPath la proprietà, questa viene applicata dopo che la trasformazione ha luogo.If you specify an XPath filtering expression using the XPath property, it is applied after the transformation takes place.

Nota

La XmlDataSource classe utilizza la XslTransform classe deprecata per eseguire trasformazioni XSL.The XmlDataSource class uses the deprecated XslTransform class to perform XSL transformations. Se si desidera utilizzare le funzionalità del foglio di stile introdotte dopo che XslTransform la classe è stata deprecata, applicare le trasformazioni manualmente utilizzando XslCompiledTransform la classe.If you want to use style sheet features that were introduced after the XslTransform class was deprecated, apply the transforms manually by using the XslCompiledTransform class.

Applicazione di filtri tramite un'espressione XPathFiltering using an XPath Expression

Per impostazione predefinita, XmlDataSource il controllo carica tutti i dati XML nel file XML identificato DataFile dalla proprietà o Data trovato inline nella proprietà, ma è possibile filtrare i dati utilizzando un'espressione XPath.By default, the XmlDataSource control loads all the XML data in the XML file identified by the DataFile property or found inline in the Data property, but you can filter the data using an XPath expression. La XPath proprietà supporta un filtro della sintassi XPath applicato dopo il caricamento e la trasformazione dei dati XML.The XPath property supports an XPath-syntax filter that is applied after XML data is loaded and transformed.

Memorizzazione nella cacheCaching

Per motivi di prestazioni, per impostazione predefinita la memorizzazione XmlDataSource nella cache è abilitata per il controllo.For performance purposes, caching is enabled for the XmlDataSource control by default. L'apertura e la lettura di un file XML sul server ogni volta che una pagina richiesta può ridurre le prestazioni dell'applicazione.Opening and reading an XML file on the server every time a page requested can reduce the performance of your application. La memorizzazione nella cache consente di ridurre il carico di elaborazione sul server a scapito della memoria del server Web. nella maggior parte dei casi si tratta di un compromesso valido.Caching lets you reduce the processing load on your server at the expense of memory on the Web server; in most cases this is a good trade-off. I XmlDataSource dati vengono automaticamente memorizzati nella cache EnableCaching quando la proprietà è trueimpostata su e CacheDuration la proprietà viene impostata sul numero di secondi durante i quali la cache archivia i dati prima che la cache venga invalidata.The XmlDataSource automatically caches data when the EnableCaching property is set to true, and the CacheDuration property is set to the number of seconds that the cache stores data before the cache is invalidated. È possibile utilizzare CacheExpirationPolicy per ottimizzare ulteriormente il comportamento di memorizzazione nella cache del controllo origine dati.You can use the CacheExpirationPolicy to further fine-tune the caching behavior of the data source control.

Funzionalità aggiuntiveAdditional Features

Nella tabella seguente sono elencate le funzionalità aggiuntive supportate dal XmlDataSource controllo.The following table lists additional features that are supported by the XmlDataSource control.

FunzionalitàCapability DescriptionDescription
OrdinamentoSorting Non supportato dal XmlDataSource controllo.Not supported by the XmlDataSource control.
FiltroFiltering La XPath proprietà può essere utilizzata per filtrare i dati XML utilizzando un'espressione XPath appropriata.The XPath property can be used to filter the XML data using an appropriate XPath expression.
PagingPaging Non supportato dal XmlDataSource controllo.Not supported by the XmlDataSource control.
UpdatingUpdating Supportato dalla manipolazione XmlDataDocument diretta di e quindi dalla chiamata al Save metodo.Supported by manipulating the XmlDataDocument directly and then calling the Save method.
EliminazioneDeleting Supportato dalla manipolazione XmlDataDocument diretta di e quindi dalla chiamata al Save metodo.Supported by manipulating the XmlDataDocument directly and then calling the Save method.
InserimentoInserting Supportato dalla manipolazione XmlDataDocument diretta di e quindi dalla chiamata al Save metodo.Supported by manipulating the XmlDataDocument directly and then calling the Save method.
Memorizzazione nella cacheCaching Abilitata per impostazione predefinita, CacheDuration con la proprietà impostata su 0 (infinita) CacheExpirationPolicy e la proprietà Absoluteimpostata su.Enabled by default, with the CacheDuration property set to 0 (infinite) and the CacheExpirationPolicy property set to Absolute.

Oggetto visualizzazione datiData View Object

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.Because the XmlDataSource control supports data-bound controls that display hierarchical data as well as controls that display tabular data, the data source control supports multiple types of data source view objects on its underlying XML data. Il XmlDataSource controllo Recupera un singolo oggetto XmlDataSourceView denominato quando viene usato con un controllo con associazione a dati che Visualizza dati tabulari.The XmlDataSource control retrieves a single named XmlDataSourceView object when used with a data-bound control that displays tabular data. Il GetViewNames metodo identifica questa singola visualizzazione denominata.The GetViewNames method identifies this single named view. Quando viene usato con un controllo con associazione a dati che Visualizza dati gerarchici XmlDataSource , il controllo XmlHierarchicalDataSourceView recupera un oggetto per qualsiasi percorso gerarchico univoco GetHierarchicalView passato al metodo.When used with a data-bound control that displays hierarchical data, the XmlDataSource control retrieves an XmlHierarchicalDataSourceView for any unique hierarchical path passed to the GetHierarchicalView method.

Sintassi dichiarativaDeclarative Syntax

<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() XmlDataSource() XmlDataSource() XmlDataSource()

Crea una nuova istanza della classe XmlDataSource.Creates a new instance of the XmlDataSource class.

Proprietà

Adapter Adapter Adapter Adapter

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

(Inherited from Control)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory 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.

(Inherited from Control)
BindingContainer BindingContainer BindingContainer BindingContainer

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

(Inherited from Control)
CacheDuration CacheDuration CacheDuration CacheDuration

Ottiene o imposta il numero di secondi durante i quali il controllo origine dati memorizza nella cache i dati che ha recuperato.Gets or sets the length of time, in seconds, that the data source control caches data it has retrieved.

CacheExpirationPolicy CacheExpirationPolicy CacheExpirationPolicy 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.Gets or sets the cache expiration policy that is combined with the cache duration to describe the caching behavior of the cache that the data source control uses.

CacheKeyContext CacheKeyContext CacheKeyContext 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.Gets or sets the value of the cache key for the data source control from view state, or adds the cache key to view state.

CacheKeyDependency CacheKeyDependency CacheKeyDependency CacheKeyDependency

Ottiene o imposta una dipendenza di chiave definita dall'utente collegata a tutti gli oggetti cache dati creati dal controllo origine dati.Gets or sets a user-defined key dependency that is linked to all data cache objects created by the data source control. Tutti gli oggetti cache scadono in modo esplicito quando scade la chiave.All cache objects explicitly expire when the key expires.

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

(Inherited from Control)
ClientID ClientID ClientID ClientID

Ottiene l'identificatore del controllo server generato da ASP.NET.Gets the server control identifier generated by ASP.NET.

(Inherited from HierarchicalDataSourceControl)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

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

(Inherited from HierarchicalDataSourceControl)
ClientIDSeparator ClientIDSeparator ClientIDSeparator 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.

(Inherited from Control)
Context Context Context 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.

(Inherited from Control)
Controls Controls Controls 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.

(Inherited from HierarchicalDataSourceControl)
Data Data Data Data

Ottiene o imposta un blocco di dati XML a cui si associa il controllo origine dati.Gets or sets a block of XML data that the data source control binds to.

DataFile DataFile DataFile DataFile

Specifica il nome file di un file XML a cui si associa il controllo origine dati.Specifies the file name of an XML file that the data source binds to.

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

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer 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.

(Inherited from Control)
DesignMode DesignMode DesignMode 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.

(Inherited from Control)
EnableCaching EnableCaching EnableCaching EnableCaching

Ottiene o imposta un valore indicante se la memorizzazione di dati nella cache è abilitata nel controllo XmlDataSource.Gets or sets a value indicating whether the XmlDataSource control has data caching enabled.

EnableTheming EnableTheming EnableTheming EnableTheming

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

(Inherited from HierarchicalDataSourceControl)
EnableViewState EnableViewState EnableViewState 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.

(Inherited from Control)
Events Events Events 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.

(Inherited from Control)
HasChildViewState HasChildViewState HasChildViewState 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.

(Inherited from Control)
IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

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

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

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

(Inherited from Control)
ID ID ID 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.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

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

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

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

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

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

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

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

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

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

(Inherited from Control)
IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared 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.

(Inherited from Control)
IsTrackingViewState IsTrackingViewState IsTrackingViewState 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.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled 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.

(Inherited from Control)
LoadViewStateByID LoadViewStateByID LoadViewStateByID 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.

(Inherited from Control)
NamingContainer NamingContainer NamingContainer 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.

(Inherited from Control)
Page Page Page Page

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

(Inherited from Control)
Parent Parent Parent 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.

(Inherited from Control)
RenderingCompatibility RenderingCompatibility RenderingCompatibility 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.

(Inherited from Control)
Site Site Site 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.

(Inherited from Control)
SkinID SkinID SkinID SkinID

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

(Inherited from HierarchicalDataSourceControl)
TemplateControl TemplateControl TemplateControl TemplateControl

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

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory 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.

(Inherited from Control)
Transform Transform Transform 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.Gets or sets a block of Extensible Stylesheet Language (XSL) data that defines an XSLT transformation to be performed on the XML data managed by the XmlDataSource control.

TransformArgumentList TransformArgumentList TransformArgumentList 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.Provides a list of XSLT arguments that are used with the style sheet defined by the Transform or TransformFile properties to perform a transformation on the XML data.

TransformFile TransformFile TransformFile 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.Specifies the file name of an Extensible Stylesheet Language (XSL) file (.xsl) that defines an XSLT transformation to be performed on the XML data managed by the XmlDataSource control.

UniqueID UniqueID UniqueID UniqueID

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

(Inherited from Control)
ValidateRequestMode ValidateRequestMode ValidateRequestMode 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.

(Inherited from Control)
ViewState ViewState ViewState 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.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase 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.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

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

(Inherited from Control)
Visible Visible Visible Visible

Ottiene o imposta un valore che indica se il controllo è visualizzato.Gets or sets a value indicating whether the control is visually displayed.

(Inherited from HierarchicalDataSourceControl)
XPath XPath XPath XPath

Specifica un'espressione XPath da applicare ai dati XML contenuti dalla proprietà Data o dal file XML indicato dalla proprietà DataFile.Specifies an XPath expression to be applied to the XML data contained by the Data property or by the XML file indicated by the DataFile property.

Metodi

AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) 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.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) 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.

(Inherited from Control)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) 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.

(Inherited from HierarchicalDataSourceControl)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

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

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) 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.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

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

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() 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.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() 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.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() 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.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() 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.

(Inherited from Control)
CreateChildControls() CreateChildControls() CreateChildControls() 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.

(Inherited from Control)
CreateControlCollection() CreateControlCollection() CreateControlCollection() 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.

(Inherited from HierarchicalDataSourceControl)
DataBind() DataBind() DataBind() DataBind()

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

(Inherited from Control)
DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) 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.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

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

(Inherited from Control)
Dispose() Dispose() Dispose() 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.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

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

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() 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.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() 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.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) 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.

(Inherited from HierarchicalDataSourceControl)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) 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.

(Inherited from Control)
Focus() Focus() Focus() Focus()

Imposta lo stato attivo per l'input del controllo.Sets input focus to the control.

(Inherited from HierarchicalDataSourceControl)
GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

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

(Inherited from Control)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetHierarchicalView(String) GetHierarchicalView(String) GetHierarchicalView(String) GetHierarchicalView(String)

Ottiene l'oggetto visualizzazione origine dati per il controllo XmlDataSource.Gets the data source view object for the XmlDataSource control. Il parametro viewPath può essere un'espressione XPath.The viewPath parameter can be an XPath expression.

GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(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.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

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

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) 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.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) 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.

(Inherited from Control)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) 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.

(Inherited from Control)
GetXmlDocument() GetXmlDocument() GetXmlDocument() GetXmlDocument()

Carica in memoria i dati XML, direttamente dall'archivio dati sottostante o dalla cache, e li restituisce nella forma di un oggetto XmlDataDocument.Loads the XML data into memory, either directly from the underlying data storage or from the cache, and returns it in the form of an XmlDataDocument object.

HasControls() HasControls() HasControls() HasControls()

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

(Inherited from HierarchicalDataSourceControl)
HasEvents() HasEvents() HasEvents() 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.

(Inherited from Control)
IsLiteralContent() IsLiteralContent() IsLiteralContent() IsLiteralContent()

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

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) 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.

(Inherited from Control)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) 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.

(Inherited from Control)
MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) 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.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) 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.

(Inherited from Control)
OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Genera l'evento DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnDataSourceChanged(EventArgs) OnDataSourceChanged(EventArgs) OnDataSourceChanged(EventArgs) OnDataSourceChanged(EventArgs)

Genera l'evento DataSourceChanged.Raises the DataSourceChanged event.

(Inherited from HierarchicalDataSourceControl)
OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs)

Genera l'evento Init.Raises the Init event.

(Inherited from Control)
OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Genera l'evento Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Genera l'evento PreRender.Raises the PreRender event.

(Inherited from Control)
OnTransforming(EventArgs) OnTransforming(EventArgs) OnTransforming(EventArgs) OnTransforming(EventArgs)

Genera l'evento Transforming prima che il controllo XmlDataSource esegua una trasformazione XSLT sui suoi dati XML.Raises the Transforming event before the XmlDataSource control performs an XSLT transformation on its XML data.

OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Genera l'evento Unload.Raises the Unload event.

(Inherited from Control)
OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

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

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) 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.

(Inherited from Control)
RemovedControl(Control) RemovedControl(Control) RemovedControl(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.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) 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.

(Inherited from Control)
RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) 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.

(Inherited from Control)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) 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.

(Inherited from HierarchicalDataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) 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.

(Inherited from Control)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

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

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

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

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

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

(Inherited from Control)
Save() Save() Save() Save()

Salva i dati XML al momento in memoria utilizzando il controllo XmlDataSource su disco se è impostata la proprietà DataFile.Saves the XML data currently held in memory by the XmlDataSource control to disk if the DataFile property is set.

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

(Inherited from Control)
SaveViewState() SaveViewState() SaveViewState() 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.

(Inherited from Control)
SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

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

(Inherited from Control)
SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) 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.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) 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.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) 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.

(Inherited from Control)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() 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.

(Inherited from Control)

Eventi

DataBinding DataBinding DataBinding DataBinding

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

(Inherited from Control)
Disposed Disposed Disposed 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.

(Inherited from Control)
IHierarchicalDataSource.DataSourceChanged IHierarchicalDataSource.DataSourceChanged IHierarchicalDataSource.DataSourceChanged 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.

(Inherited from HierarchicalDataSourceControl)
Init Init Init 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.

(Inherited from Control)
Load Load Load Load

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

(Inherited from Control)
PreRender PreRender PreRender PreRender

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

(Inherited from Control)
Transforming Transforming Transforming Transforming

Si verifica prima che il foglio di stile definito dalla proprietà Transform o identificato dalla proprietà TransformFile venga applicato ai dati XML.Occurs before the style sheet that is defined by the Transform property or identified by the TransformFile property is applied to XML data.

Unload Unload Unload Unload

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

(Inherited from Control)

Implementazioni dell'interfaccia esplicita

IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

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

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

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

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

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

(Inherited from Control)
IDataSource.DataSourceChanged IDataSource.DataSourceChanged IDataSource.DataSourceChanged IDataSource.DataSourceChanged

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

IDataSource.GetView(String) IDataSource.GetView(String) IDataSource.GetView(String) IDataSource.GetView(String)

Ottiene la visualizzazione origine dati denominata associata al controllo origine dati.Gets the named data source view associated with the data source control.

IDataSource.GetViewNames() IDataSource.GetViewNames() IDataSource.GetViewNames() IDataSource.GetViewNames()

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

IHierarchicalDataSource.GetHierarchicalView(String) IHierarchicalDataSource.GetHierarchicalView(String) IHierarchicalDataSource.GetHierarchicalView(String) 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.

(Inherited from HierarchicalDataSourceControl)
IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection IListSource.ContainsListCollection

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

IListSource.GetList() IListSource.GetList() IListSource.GetList() IListSource.GetList()

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

IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

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

(Inherited from Control)

Metodi di estensione

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) 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) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) 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) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

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

GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) 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) GetMetaTable(IDataSource) GetMetaTable(IDataSource) 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) TryGetMetaTable(IDataSource, MetaTable) TryGetMetaTable(IDataSource, MetaTable) TryGetMetaTable(IDataSource, MetaTable)

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

Si applica a

Vedi anche