XmlDataSource XmlDataSource XmlDataSource XmlDataSource Class

Definición

Representa un origen de datos XML para controles enlazados a datos.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
Herencia
Atributos
Implementaciones

Ejemplos

Esta sección contiene dos ejemplos de código.This section contains two code examples. En el primer ejemplo de código se muestra cómo XmlDataSource usar un control TreeView con un control para Mostrar datos XML del archivo XML de ejemplo.The first code example demonstrates how to use an XmlDataSource control with a TreeView control to display XML data from the sample XML file. En el segundo ejemplo se muestra cómo usar XmlDataSource un control con un Repeater control con plantilla para Mostrar datos XML.The second example demonstrates how to use an XmlDataSource control with a templated Repeater control to display XML data.

En el ejemplo de código siguiente se muestra cómo XmlDataSource usar un control TreeView con un control para Mostrar datos XML.The following code example demonstrates how to use an XmlDataSource control with a TreeView control to display XML data. Carga los datos XML del archivo XML identificado por la DataFile propiedad. 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>

El archivo XML en el ejemplo de código tiene los datos siguientes: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>  

En el ejemplo de código siguiente se muestra cómo XmlDataSource usar un control con un Repeater control con plantilla para Mostrar datos XML.The following code example demonstrates how to use an XmlDataSource control with a templated Repeater control to display XML data. El Repeater control utiliza una expresión de enlace de datos XPath para enlazar a los elementos de datos dentro del XmlDataSource documento XML que representa.The Repeater control uses an XPath data-binding expression to bind to data items within the XML document that the XmlDataSource represents. Para obtener más información XPath sobre XPathSelect la sintaxis de enlace de datos y XPathBinder , vea la clase.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>

El archivo XML en el ejemplo de código tiene los datos siguientes: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>  

Comentarios

En este tema:In this topic:

IntroducciónIntroduction

El XmlDataSource control es un control de origen de datos que presenta los datos XML a los controles enlazados a datos.The XmlDataSource control is a data source control that presents XML data to data-bound controls. Los XmlDataSource controles enlazados a datos pueden utilizar el control para mostrar los datos jerárquicos y tabulares.The XmlDataSource control can be used by data-bound controls to display both hierarchical and tabular data. Normalmente XmlDataSource , el control se usa para Mostrar datos XML jerárquicos en escenarios de solo lectura.The XmlDataSource control is typically used to display hierarchical XML data in read-only scenarios. Dado que XmlDataSource el control extiende HierarchicalDataSourceControl la clase, funciona con datos jerárquicos.Because the XmlDataSource control extends the HierarchicalDataSourceControl class, it works with hierarchical data. El XmlDataSource control también implementa la IDataSource interfaz y funciona con datos tabulares o de estilo de lista.The XmlDataSource control also implements the IDataSource interface and works with tabular, or list-style, data.

Nota

Por motivos de seguridad, ninguna de XmlDataSource las propiedades del control se almacenan en el estado de vista.For security purposes, none of the XmlDataSource control properties are stored in view state. Dado que es técnicamente posible descodificar el contenido del estado de vista en el cliente, el almacenamiento de información confidencial sobre la estructura de datos o su contenido podría exponerle una amenaza de divulgación de información.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. Tenga en cuenta que si necesita almacenar información como XPath Property en el estado de vista, puede habilitar el cifrado para proteger el contenido ViewStateEncryptionMode estableciendo en la @ Page Directiva.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.

Los desarrolladores de páginas XmlDataSource utilizan el control para Mostrar datos XML mediante controles enlazados a datos.Page developers use the XmlDataSource control to display XML data using data-bound controls.

Orígenes de datos XMLSources of XML Data

Normalmente XmlDataSource , carga los datos XML de un archivo XML, que se especifica mediante DataFile la propiedad.The XmlDataSource typically loads XML data from an XML file, which is specified by the DataFile property. Los datos XML también se pueden almacenar directamente mediante el control de origen de datos en formato Data de cadena mediante la propiedad.XML data can also be stored directly by the data source control in string form using the Data property. Si desea transformar los datos XML antes de que se muestren en un control enlazado a datos, puede proporcionar una hoja de estilos XSL (Extensible Stylesheet Language) para la transformación.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. Al igual que con los datos XML, normalmente se carga la hoja de estilos desde un archivo, TransformFile indicado por la propiedad, pero también se puede almacenar en forma de cadena Transform directamente mediante la propiedad.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.

Actualizar datos XMLUpdating XML Data

El XmlDataSource control se usa normalmente en escenarios de datos de solo lectura donde un control enlazado a datos muestra datos XML.The XmlDataSource control is commonly used in read-only data scenarios where a data-bound control displays XML data. Sin embargo, también puede utilizar el XmlDataSource control para editar datos XML.However, you can also use the XmlDataSource control to edit XML data. Para editar los datos XML, llame GetXmlDocument al método para recuperar un XmlDataDocument objeto que es una representación en memoria de los datos 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. Puede usar el modelo de objetos expuesto por los XmlDataDocument objetos XmlNode y que contiene, o utilizar una expresión de filtrado XPath para manipular los datos del 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. Cuando haya realizado cambios en la representación en memoria de los datos XML, puede guardarlos en el disco llamando al Save método.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.

Existen algunas restricciones a las capacidades de edición del XmlDataSource control:There are some restrictions to the editing capabilities of the XmlDataSource control:

  • Los datos XML se deben cargar desde un archivo XML indicado por la DataFile propiedad, no desde XML insertado especificado en la Data propiedad.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.

  • No se puede especificar ninguna transformación XSLT en Transform las TransformFile propiedades o.No XSLT transformation can be specified in the Transform or TransformFile properties.

  • El Save método no controla las operaciones de guardado simultáneas por diferentes solicitudes.The Save method does not handle concurrent save operations by different requests. Si más de un usuario está editando un archivo XML a XmlDataSourcetravés de, no hay ninguna garantía de que todos los usuarios estén trabajando con los mismos datos.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. También es posible que se produzca Save un error en una operación debido a estos mismos problemas de simultaneidad.It is also possible for a Save operation to fail due to these same concurrency issues.

Especificar una transformación XSLSpecifying an XSL Transformation

Una operación común realizada con datos XML es transformarla de un conjunto de datos XML en otro.A common operation performed with XML data is transforming it from one XML data set into another. El XmlDataSource control admite las transformaciones XML con Transform las TransformFile propiedades y, que especifican una hoja de estilos XSL que se aplica a los datos XML antes de pasarla a un control enlazado a datos, y la TransformArgumentList propiedad, que le permite proporcionar argumentos de hojas de estilos XSLT dinámicas que se usarán en una hoja de estilos XSL durante la transformación.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. Si especifica una expresión de filtrado XPath mediante la XPath propiedad, se aplicará después de que tenga lugar la transformación.If you specify an XPath filtering expression using the XPath property, it is applied after the transformation takes place.

Nota

La XmlDataSource clase utiliza la XslTransform clase desusada para realizar transformaciones XSL.The XmlDataSource class uses the deprecated XslTransform class to perform XSL transformations. Si desea usar las características de la hoja de estilos que se introdujeron XslTransform después de que la clase estuviera en desuso, aplique las transformaciones XslCompiledTransform manualmente mediante la clase.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.

Filtrar mediante una expresión XPathFiltering using an XPath Expression

De forma predeterminada, XmlDataSource el control carga todos los datos XML del archivo XML identificados por DataFile la propiedad o que se encuentran alineados en la Data propiedad, pero puede filtrar los datos mediante una expresión 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 propiedad admite un filtro de sintaxis XPath que se aplica una vez cargados y transformados los datos XML.The XPath property supports an XPath-syntax filter that is applied after XML data is loaded and transformed.

Almacenamiento en memoria cachéCaching

Por motivos de rendimiento, el almacenamiento en caché XmlDataSource está habilitado de forma predeterminada para el control.For performance purposes, caching is enabled for the XmlDataSource control by default. Abrir y leer un archivo XML en el servidor cada vez que una página solicitada puede reducir el rendimiento de la aplicación.Opening and reading an XML file on the server every time a page requested can reduce the performance of your application. El almacenamiento en caché le permite reducir la carga de procesamiento en el servidor a costa de la memoria en el servidor Web. en la mayoría de los casos, se trata de un buen equilibrio.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. Almacena automáticamente en caché los datos cuando EnableCaching la propiedad está establecida trueen y la CacheDuration propiedad se establece en el número de segundos que la memoria caché almacena los datos antes de que se invalide la memoria caché. XmlDataSourceThe 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. Puede utilizar CacheExpirationPolicy para ajustar aún más el comportamiento de almacenamiento en caché del control de origen de datos.You can use the CacheExpirationPolicy to further fine-tune the caching behavior of the data source control.

Características adicionalesAdditional Features

En la tabla siguiente se enumeran las características adicionales que XmlDataSource admite el control.The following table lists additional features that are supported by the XmlDataSource control.

FunciónCapability DescripciónDescription
OrdenarSorting No es compatible con XmlDataSource el control.Not supported by the XmlDataSource control.
FiltradoFiltering La XPath propiedad se puede utilizar para filtrar los datos XML utilizando una expresión XPath adecuada.The XPath property can be used to filter the XML data using an appropriate XPath expression.
PaginaciónPaging No es compatible con XmlDataSource el control.Not supported by the XmlDataSource control.
UpdatingUpdating Se admite al manipular XmlDataDocument directamente y, a continuación, llamar al Save método.Supported by manipulating the XmlDataDocument directly and then calling the Save method.
EliminandoDeleting Se admite al manipular XmlDataDocument directamente y, a continuación, llamar al Save método.Supported by manipulating the XmlDataDocument directly and then calling the Save method.
InserciónInserting Se admite al manipular XmlDataDocument directamente y, a continuación, llamar al Save método.Supported by manipulating the XmlDataDocument directly and then calling the Save method.
Almacenamiento en memoria cachéCaching Habilitado de forma predeterminada, CacheDuration con la propiedad establecida en 0 (infinito) CacheExpirationPolicy y la propiedad Absoluteestablecida en.Enabled by default, with the CacheDuration property set to 0 (infinite) and the CacheExpirationPolicy property set to Absolute.

Objeto de vista de datosData View Object

Dado que XmlDataSource el control admite controles enlazados a datos que muestran datos jerárquicos y controles que muestran datos tabulares, el control de origen de datos admite varios tipos de objetos de vista del origen de datos en sus datos XML subyacentes.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. El XmlDataSource control recupera un solo objeto con XmlDataSourceView nombre cuando se usa con un control enlazado a datos que muestra los datos tabulares.The XmlDataSource control retrieves a single named XmlDataSourceView object when used with a data-bound control that displays tabular data. El GetViewNames método identifica esta vista con nombre única.The GetViewNames method identifies this single named view. Cuando se utiliza con un control enlazado a datos que muestra datos jerárquicos XmlDataSource , el control recupera XmlHierarchicalDataSourceView un para cualquier ruta de acceso jerárquica única que GetHierarchicalView se pasa al método.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.

Sintaxis declarativaDeclarative 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>  

Constructores

XmlDataSource() XmlDataSource() XmlDataSource() XmlDataSource()

Crea una nueva instancia de la clase XmlDataSource.Creates a new instance of the XmlDataSource class.

Propiedades

Adapter Adapter Adapter Adapter

Obtiene el adaptador específico del explorador para el control.Gets the browser-specific adapter for the control.

(Inherited from Control)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.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

Obtiene el control que contiene el enlace de datos de este control.Gets the control that contains this control's data binding.

(Inherited from Control)
CacheDuration CacheDuration CacheDuration CacheDuration

Obtiene o establece el período de tiempo, en segundos, durante el cual el control de origen de datos almacena en memoria caché los datos que ha recuperado.Gets or sets the length of time, in seconds, that the data source control caches data it has retrieved.

CacheExpirationPolicy CacheExpirationPolicy CacheExpirationPolicy CacheExpirationPolicy

Obtiene o establece la directiva de expiración de la memoria caché que se combina con la duración de la caché para describir el comportamiento del almacenamiento en caché de la caché que utiliza el control de origen de datos.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

Obtiene o establece el valor de la clave de caché para el control de origen de datos del estado de vista o agrega la clave de caché al estado de vista.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

Obtiene o establece una dependencia de clave definida por el usuario que se vincula a todos los objetos de caché de datos creada por el control de origen de datos.Gets or sets a user-defined key dependency that is linked to all data cache objects created by the data source control. Todos los objetos almacenados en caché expiran explícitamente cuando la clave expira.All cache objects explicitly expire when the key expires.

ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

Obtiene el identificador del control de servidor generado por ASP.NET.Gets the server control identifier generated by ASP.NET.

(Inherited from HierarchicalDataSourceControl)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

Esta propiedad no se utiliza para los controles de orígenes de datos.This property is not used for data source controls.

(Inherited from HierarchicalDataSourceControl)
ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
Context Context Context Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls Controls

Obtiene un objeto ControlCollection que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.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

Obtiene o establece un bloque de datos XML al que se enlaza el control de origen de datos.Gets or sets a block of XML data that the data source control binds to.

DataFile DataFile DataFile DataFile

Especifica el nombre de un archivo XML al que se enlaza el origen de datos.Specifies the file name of an XML file that the data source binds to.

DataItemContainer DataItemContainer DataItemContainer DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
EnableCaching EnableCaching EnableCaching EnableCaching

Obtiene o establece un valor que indica si el control XmlDataSource está habilitado.Gets or sets a value indicating whether the XmlDataSource control has data caching enabled.

EnableTheming EnableTheming EnableTheming EnableTheming

Obtiene un valor que indica si el control admite temas.Gets a value indicating whether this control supports themes.

(Inherited from HierarchicalDataSourceControl)
EnableViewState EnableViewState EnableViewState EnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.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

Obtiene una lista de delegados de controladores de eventos del control.Gets a list of event handler delegates for the control. Esta propiedad es de sólo lectura.This property is read-only.

(Inherited from Control)
HasChildViewState HasChildViewState HasChildViewState HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.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

Para obtener una descripción de este miembro, vea ControlBuilder.For a description of this member, see ControlBuilder.

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

Para una descripción de este miembro, vea UserData.For a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

Obtiene o establece el identificador de programación asignado al control de servidor.Gets or sets the programmatic identifier assigned to the server control.

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

Para una descripción de este miembro, vea DataBindings.For a description of this member, see DataBindings.

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

Para obtener una descripción de este miembro, vea HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.Gets the character used to separate control identifiers.

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

Para una descripción de este miembro, vea Expressions.For a description of this member, see Expressions.

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

Para una descripción de este miembro, vea HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.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

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad 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

Obtiene una referencia a la instancia Page que contiene el control de servidor.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent Parent Parent Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
Site Site Site Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

Obtiene o establece la máscara que se ha de aplicar al control HierarchicalDataSourceControl.Gets or sets the skin to apply to the HierarchicalDataSourceControl control.

(Inherited from HierarchicalDataSourceControl)
TemplateControl TemplateControl TemplateControl TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
Transform Transform Transform Transform

Obtiene o establece un bloque de datos XSL (Extensible Stylesheet Language) que define una transformación XSLT que se realizará en los datos XML que administra el control 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

Proporciona una lista de los argumentos XSLT que se utilizan con la hoja de estilos que las propiedades Transform o TransformFile definen para llevar a cabo una transformación en los datos 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

Especifica el nombre de un archivo con extensión .xsl (Extensible Stylesheet Language) que define una transformación XSLT que se realizará en los datos XML que administra el control 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

Obtiene el identificador único calificado jerárquicamente para el control de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.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

Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.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

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

Obtiene o establece el modo del estado de vista de este control.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible Visible Visible Visible

Obtiene o establece un valor que indica si el control se muestra gráficamente.Gets or sets a value indicating whether the control is visually displayed.

(Inherited from HierarchicalDataSourceControl)
XPath XPath XPath XPath

Especifica una expresión XPath que se va a aplicar a los datos XML incluidos en la propiedad Data o en el archivo XML que indica la propiedad 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.

Métodos

AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto 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 control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.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)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de página.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)

Comienza el seguimiento en tiempo de diseño de los datos de representación.Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean)

Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página.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()

Establece en null el valor de ClientID almacenado en caché.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
CreateChildControls() CreateChildControls() CreateChildControls() CreateChildControls()

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.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 nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.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()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.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)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el 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()

Enlaza un origen de datos a los controles secundarios del control de servidor.Binds a data source to the server control's child controls.

(Inherited from Control)
Dispose() Dispose() Dispose() Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la 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)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() EnsureChildControls()

Determina si el control de servidor contiene controles secundarios.Determines whether the server control contains child controls. Si no tiene controles secundarios, los crea.If it does not, it creates child controls.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.Creates an identifier for controls that do not have an identifier assigned.

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.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)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda.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. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

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

Establece el foco de entrada en el control.Sets input focus to the control.

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

Obtiene datos en tiempo de diseño para un control.Gets design-time data for a control.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene el objeto de vista del origen de datos para el control XmlDataSource.Gets the data source view object for the XmlDataSource control. El parámetro viewPath puede ser una expresión XPath.The viewPath parameter can be an XPath expression.

GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

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

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.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)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.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)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.Returns the prefixed portion of the UniqueID property of the specified control.

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

Carga los datos XML en la memoria, ya sea directamente a partir del almacén de datos subyacentes o desde la caché, y los devuelve con el formato de un objeto 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 si el control de servidor contiene controles secundarios.Determines if the server control contains any child controls.

(Inherited from HierarchicalDataSourceControl)
HasEvents() HasEvents() HasEvents() HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.Returns a value indicating whether events are registered for the control or any child controls.

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

Determina si el control de servidor alberga únicamente contenido literal.Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) LoadControlState(Object)

Restaura información de estado de control de una solicitud de página anterior guardada por el método 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)

Restaura la información sobre el estado de vista de una solicitud de página anterior guardada por el método 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 la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.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 el evento DataBinding.Raises the DataBinding event.

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

Genera el evento DataSourceChanged.Raises the DataSourceChanged event.

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

Genera el evento Init.Raises the Init event.

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

Genera el evento Load.Raises the Load event.

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

Genera el evento PreRender.Raises the PreRender event.

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

Provoca el evento Transforming antes de que el control XmlDataSource realice una transformación XSLT en sus datos 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 el evento Unload.Raises the Unload event.

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

Obtiene un objeto Stream utilizado para leer un archivo.Gets a Stream used to read a file.

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.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)

Se llama después de quitar un control secundario de la colección Controls del objeto 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)

Envía el contenido del control de servidor al objeto HtmlTextWriter proporcionado, que escribe el contenido que se representará en el cliente.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)

Envía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente.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)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.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)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

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

Obtiene el adaptador de controles que se encarga de representar el control especificado.Gets the control adapter responsible for rendering the specified control.

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

Obtiene una dirección URL que el explorador puede utilizar.Gets a URL that can be used by the browser.

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

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.Converts a URL into one that is usable on the requesting client.

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

Guarda en disco los datos XML que el control XmlDataSource mantiene actualmente en memoria si se establece la propiedad 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()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.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()

Guarda los cambios realizados en el estado de vista del control de servidor desde que la página volvió a publicarse en el servidor.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)

Establece los datos en tiempo de diseño para un control.Sets design-time data for a control.

(Inherited from Control)
SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.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)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento.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)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento.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()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Origina el seguimiento de los cambios del estado de vista del control de servidor de manera que se puedan almacenar en el objeto StateBag del control de servidor.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Este objeto es accesible a través de la propiedad ViewState.This object is accessible through the ViewState property.

(Inherited from Control)

Eventos

DataBinding DataBinding DataBinding DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.Occurs when the server control binds to a data source.

(Inherited from Control)
Disposed Disposed Disposed Disposed

Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página 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

Se produce cuando los cambios de HierarchicalDataSourceControl afectan de alguna manera a los controles enlazados a datos.Occurs when the HierarchicalDataSourceControl has changed in some way that affects data-bound controls.

(Inherited from HierarchicalDataSourceControl)
Init Init Init Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load Load Load Load

Se produce cuando el control de servidor se carga en el objeto Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PreRender PreRender PreRender PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
Transforming Transforming Transforming Transforming

Se produce antes de aplicar a los datos XML la hoja de estilos que define la propiedad Transform o que identifica la propiedad TransformFile.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

Se produce cuando el control de servidor se descarga de la memoria.Occurs when the server control is unloaded from memory.

(Inherited from Control)

Implementaciones de interfaz explícitas

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

Para una descripción de este miembro, vea GetDesignModeState().For a description of this member, see GetDesignModeState().

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

Para una descripción de este miembro, vea 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)

Para una descripción de este miembro, vea SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

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

Para una descripción de este miembro, vea DataSourceChanged.For a description of this member, see DataSourceChanged.

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

Obtiene la vista de origen de datos con nombre asociada al control de origen de datos.Gets the named data source view associated with the data source control.

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

Para obtener una descripción de este miembro, vea GetViewNames().For a description of this member, see GetViewNames().

IHierarchicalDataSource.GetHierarchicalView(String) IHierarchicalDataSource.GetHierarchicalView(String) IHierarchicalDataSource.GetHierarchicalView(String) IHierarchicalDataSource.GetHierarchicalView(String)

Obtiene el objeto del asistente de la vista para la interfaz IHierarchicalDataSource para la ruta de acceso especificada.Gets the view helper object for the IHierarchicalDataSource interface for the specified path.

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

Para una descripción de este miembro, vea ContainsListCollection.For a description of this member, see ContainsListCollection.

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

Para una descripción de este miembro, vea GetList().For a description of this member, see GetList().

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

Para una descripción de este miembro, vea AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)

Métodos de extensión

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.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)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.Returns the metatable object for the containing data control.

GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) GetDefaultValues(IDataSource) GetDefaultValues(IDataSource)

Obtiene la colección de los valores predeterminados para el origen de datos especificado.Gets the collection of the default values for the specified data source.

GetMetaTable(IDataSource) GetMetaTable(IDataSource) GetMetaTable(IDataSource) GetMetaTable(IDataSource)

Obtiene los metadatos para una tabla en el objeto de origen de datos especificado.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 si están disponibles los metadatos de la tabla.Determines whether table metadata is available.

Se aplica a

Consulte también: