XmlDataSource Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa un origen de datos XML para controles enlazados a datos.
public ref class XmlDataSource : System::Web::UI::HierarchicalDataSourceControl, System::ComponentModel::IListSource, System::Web::UI::IDataSource[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))]
public class XmlDataSource : System.Web.UI.HierarchicalDataSourceControl, System.ComponentModel.IListSource, System.Web.UI.IDataSource[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))>]
type XmlDataSource = class
inherit HierarchicalDataSourceControl
interface IDataSource
interface IListSourcePublic Class XmlDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource- Herencia
- Atributos
- Implementaciones
Ejemplos
Esta sección contiene dos ejemplos de código. En el primer ejemplo de código se muestra cómo usar un XmlDataSource control con un TreeView control para mostrar datos XML del archivo XML de ejemplo. En el segundo ejemplo se muestra cómo usar un XmlDataSource control con un control con Repeater plantilla para mostrar datos XML.
En el ejemplo de código siguiente se muestra cómo usar un XmlDataSource control con un TreeView control para mostrar datos XML. XmlDataSource Carga datos XML del archivo XML identificado por la DataFile propiedad .
<%@ 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 del ejemplo de código tiene los datos siguientes:
<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 usar un XmlDataSource control con un control con Repeater plantilla para mostrar datos XML. El Repeater control usa una expresión de enlace de datos XPath para enlazar a elementos de datos dentro del documento XML que XmlDataSource representa. Para obtener más información sobre XPath la sintaxis de enlace de datos y XPathSelect , vea la XPathBinder clase .
<%@ 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 del ejemplo de código tiene los datos siguientes:
<?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:
Introducción
El XmlDataSource control es un control de origen de datos que presenta datos XML a controles enlazados a datos. Los XmlDataSource controles enlazados a datos pueden usar el control para mostrar datos jerárquicos y tabulares. El XmlDataSource control se usa normalmente para mostrar datos XML jerárquicos en escenarios de solo lectura. Dado que el XmlDataSource control extiende la HierarchicalDataSourceControl clase , funciona con datos jerárquicos. El XmlDataSource control también implementa la IDataSource interfaz y funciona con datos tabulares, o de estilo de lista.
Nota
Con fines de seguridad, ninguna de las propiedades del XmlDataSource control se almacena en estado de vista. Dado que técnicamente es posible descodificar el contenido del estado de vista en el cliente, almacenar información confidencial sobre la estructura de datos o su contenido podría exponerle a una amenaza de divulgación de información. Tenga en cuenta que si necesita almacenar información como XPath la propiedad en estado de vista, puede habilitar el cifrado para proteger el contenido estableciendo ViewStateEncryptionMode en la @ Page directiva .
Los desarrolladores de páginas usan el XmlDataSource control para mostrar datos XML mediante controles enlazados a datos.
Orígenes de datos XML
Normalmente XmlDataSource , los datos XML se cargan desde un archivo XML, que se especifica mediante la DataFile propiedad . Los datos XML también se pueden almacenar directamente mediante el control de origen de datos en forma de cadena mediante la Data propiedad . Si desea transformar los datos XML antes de que se muestren mediante un control enlazado a datos, puede proporcionar una hoja de estilos de Lenguaje de hoja de estilos extensible (XSL) para la transformación. Al igual que con los datos XML, normalmente se carga la hoja de estilos desde un archivo, indicado por la TransformFile propiedad , pero también se puede almacenar en forma de cadena directamente mediante la Transform propiedad .
Actualización de datos XML
El XmlDataSource control se usa normalmente en escenarios de datos de solo lectura en los que un control enlazado a datos muestra datos XML. Sin embargo, también puede usar el XmlDataSource control para editar datos XML. Para editar los datos XML, llame al GetXmlDocument método para recuperar un XmlDataDocument objeto que sea una representación en memoria de los datos XML. Puede usar el modelo de objetos expuesto por los XmlDataDocument objetos y XmlNode que contiene o usar una expresión de filtrado XPath para manipular los datos del documento. Cuando haya realizado cambios en la representación en memoria de los datos XML, puede guardarlos en el disco llamando al Save método .
Hay algunas restricciones para las funcionalidades de edición del XmlDataSource control:
Los datos XML se deben cargar desde un archivo XML indicado por la propiedad , no desde el DataFile XML insertado especificado en la Data propiedad .
No se puede especificar ninguna transformación XSLT en las Transform propiedades o TransformFile .
El Save método no controla las operaciones de guardado simultáneas mediante solicitudes diferentes. Si más de un usuario está editando un archivo XML a través de XmlDataSource, no hay ninguna garantía de que todos los usuarios estén trabajando con los mismos datos. También es posible que se produzca un error en una Save operación debido a estos mismos problemas de simultaneidad.
Especificación de una transformación XSL
Una operación común realizada con datos XML es transformarla de un conjunto de datos XML a otro. El XmlDataSource control admite transformaciones XML con las Transform propiedades y TransformFile , que especifican una hoja de estilos XSL que se va a aplicar a los datos XML antes de pasarse a un control enlazado a datos, y la TransformArgumentList propiedad , que permite proporcionar argumentos dinámicos de hoja de estilos XSLT que se van a usar en una hoja de estilos XSL durante la transformación. Si especifica una expresión de filtrado XPath mediante la XPath propiedad , se aplica después de que se produzca la transformación.
Nota
La XmlDataSource clase usa la clase en desuso XslTransform para realizar transformaciones XSL. Si desea usar las características de hoja de estilos que se introdujeron después de que la XslTransform clase haya quedado en desuso, aplique las transformaciones manualmente mediante la XslCompiledTransform clase .
Filtrado mediante una expresión XPath
De forma predeterminada, el XmlDataSource control carga todos los datos XML del archivo XML identificado por la DataFile propiedad o encontrados insertados en la Data propiedad , pero puede filtrar los datos mediante una expresión XPath. La XPath propiedad admite un filtro de sintaxis XPath que se aplica después de cargar y transformar los datos XML.
Almacenamiento en memoria caché
Con fines de rendimiento, el almacenamiento en caché está habilitado para el XmlDataSource control de forma predeterminada. Abrir y leer un archivo XML en el servidor cada vez que una página solicitada puede reducir el rendimiento de la aplicación. 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, esto es un buen equilibrio. Almacena XmlDataSource automáticamente los datos en caché cuando la EnableCaching propiedad se establece trueen y la CacheDuration propiedad se establece en el número de segundos que almacena la memoria caché antes de invalidar la memoria caché. Puede usar CacheExpirationPolicy para ajustar aún más el comportamiento de almacenamiento en caché del control de origen de datos.
Características adicionales
En la tabla siguiente se enumeran características adicionales compatibles con el XmlDataSource control .
| Capacidad | Descripción |
|---|---|
| Ordenar | No es compatible con el XmlDataSource control . |
| Filtros | La XPath propiedad se puede usar para filtrar los datos XML mediante una expresión XPath adecuada. |
| Paginación | No es compatible con el XmlDataSource control . |
| Actualizando | Se admite mediante la XmlDataDocument manipulación de directamente y, a continuación, la llamada al Save método . |
| Eliminando | Se admite mediante la XmlDataDocument manipulación de directamente y, a continuación, la llamada al Save método . |
| Inserción | Se admite mediante la XmlDataDocument manipulación de directamente y, a continuación, la llamada al Save método . |
| Almacenamiento en memoria caché | Habilitado de forma predeterminada, con la CacheDuration propiedad establecida en 0 (infinito) y la CacheExpirationPolicy propiedad establecida en Absolute. |
Objeto de vista de datos
Dado que el XmlDataSource control admite controles enlazados a datos que muestran datos jerárquicos, así como 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. El XmlDataSource control recupera un único objeto con nombre XmlDataSourceView cuando se usa con un control enlazado a datos que muestra datos tabulares. El GetViewNames método identifica esta vista con nombre única. Cuando se usa con un control enlazado a datos que muestra datos jerárquicos, el XmlDataSource control recupera una XmlHierarchicalDataSourceView para cualquier ruta jerárquica única que se pase al GetHierarchicalView método .
Sintaxis declarativa
<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() |
Crea una nueva instancia de la clase XmlDataSource. |
Propiedades
| Adapter |
Obtiene el adaptador específico del explorador para el control. (Heredado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control. (Heredado de Control) |
| BindingContainer |
Obtiene el control que contiene el enlace de datos de este control. (Heredado de Control) |
| 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. |
| 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. |
| 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. |
| 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. Todos los objetos almacenados en caché expiran explícitamente cuando la clave expira. |
| ChildControlsCreated |
Obtiene un valor que indica si se han creado controles secundarios del control de servidor. (Heredado de Control) |
| ClientID |
Obtiene el identificador del control de servidor generado por ASP.NET. (Heredado de HierarchicalDataSourceControl) |
| ClientIDMode |
Esta propiedad no se utiliza para los controles de orígenes de datos. (Heredado de HierarchicalDataSourceControl) |
| ClientIDSeparator |
Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID. (Heredado de Control) |
| Context |
Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual. (Heredado de Control) |
| 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. (Heredado de HierarchicalDataSourceControl) |
| Data |
Obtiene o establece un bloque de datos XML al que se enlaza el control de origen de datos. |
| DataFile |
Especifica el nombre de un archivo XML al que se enlaza el origen de datos. |
| DataItemContainer |
Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer. (Heredado de Control) |
| DataKeysContainer |
Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl. (Heredado de Control) |
| DesignMode |
Obtiene un valor que indica si se está utilizando un control en una superficie de diseño. (Heredado de Control) |
| EnableCaching |
Obtiene o establece un valor que indica si el control XmlDataSource está habilitado. |
| EnableTheming |
Obtiene un valor que indica si el control admite temas. (Heredado de HierarchicalDataSourceControl) |
| 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. (Heredado de Control) |
| Events |
Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura. (Heredado de Control) |
| HasChildViewState |
Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista. (Heredado de Control) |
| ID |
Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control) |
| IdSeparator |
Obtiene el carácter utilizado para separar los identificadores de control. (Heredado de Control) |
| IsChildControlStateCleared |
Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control. (Heredado de Control) |
| IsTrackingViewState |
Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista. (Heredado de Control) |
| IsViewStateEnabled |
Obtiene un valor que indica si el estado de vista está habilitado para este control. (Heredado de Control) |
| LoadViewStateByID |
Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice. (Heredado de Control) |
| 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. (Heredado de Control) |
| Page |
Obtiene una referencia a la instancia Page que contiene el control de servidor. (Heredado de Control) |
| Parent |
Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página. (Heredado de Control) |
| RenderingCompatibility |
Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados. (Heredado de Control) |
| Site |
Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño. (Heredado de Control) |
| SkinID |
Obtiene o establece la máscara que se ha de aplicar al control HierarchicalDataSourceControl. (Heredado de HierarchicalDataSourceControl) |
| TemplateControl |
Obtiene o establece una referencia a la plantilla que contiene este control. (Heredado de Control) |
| TemplateSourceDirectory |
Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Heredado de Control) |
| 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. |
| 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. |
| 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. |
| UniqueID |
Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Heredado de Control) |
| ValidateRequestMode |
Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos. (Heredado de Control) |
| 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. (Heredado de Control) |
| ViewStateIgnoresCase |
Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas. (Heredado de Control) |
| ViewStateMode |
Obtiene o establece el modo del estado de vista de este control. (Heredado de Control) |
| Visible |
Obtiene o establece un valor que indica si el control se muestra gráficamente. (Heredado de HierarchicalDataSourceControl) |
| 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. |
Métodos
| AddedControl(Control, Int32) |
Se llama después de agregar un control secundario a la colección Controls del objeto Control. (Heredado de Control) |
| 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. (Heredado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica al control las propiedades de estilo definidas en la hoja de estilos de página. (Heredado de HierarchicalDataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Comienza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control) |
| 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. (Heredado de Control) |
| ClearCachedClientID() |
Establece en |
| ClearChildControlState() |
Elimina la información sobre el estado de control de los controles secundarios del control de servidor. (Heredado de Control) |
| ClearChildState() |
Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor. (Heredado de Control) |
| ClearChildViewState() |
Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control) |
| ClearEffectiveClientIDMode() |
Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit. (Heredado de Control) |
| 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. (Heredado de Control) |
| CreateControlCollection() |
Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor. (Heredado de HierarchicalDataSourceControl) |
| DataBind() |
Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Heredado de Control) |
| 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. (Heredado de Control) |
| DataBindChildren() |
Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control) |
| Dispose() |
Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria. (Heredado de Control) |
| EndRenderTracing(TextWriter, Object) |
Finaliza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control) |
| EnsureChildControls() |
Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea. (Heredado de Control) |
| EnsureID() |
Crea un identificador para controles que no tiene un identificador asignado. (Heredado de Control) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| FindControl(String) |
Busca un control de servidor con el parámetro |
| FindControl(String, Int32) |
Busca el contenedor de nomenclatura actual para un control de servidor con el |
| Focus() |
Establece el foco de entrada en el control. (Heredado de HierarchicalDataSourceControl) |
| GetDesignModeState() |
Obtiene datos en tiempo de diseño para un control. (Heredado de Control) |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetHierarchicalView(String) |
Obtiene el objeto de vista del origen de datos para el control XmlDataSource. El parámetro |
| GetRouteUrl(Object) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control) |
| GetRouteUrl(String, Object) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| GetUniqueIDRelativeTo(Control) |
Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado. (Heredado de Control) |
| 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. |
| HasControls() |
Determina si el control de servidor contiene controles secundarios. (Heredado de HierarchicalDataSourceControl) |
| HasEvents() |
Devuelve un valor que indica si se registran eventos para el control o los controles secundarios. (Heredado de Control) |
| IsLiteralContent() |
Determina si el control de servidor alberga únicamente contenido literal. (Heredado de Control) |
| LoadControlState(Object) |
Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState(). (Heredado de Control) |
| LoadViewState(Object) |
Restaura la información de estado de vista de una solicitud de página anterior guardada por el método SaveViewState(). (Heredado de Control) |
| MapPathSecure(String) |
Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Heredado de Control) |
| MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
| 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. (Heredado de Control) |
| OnDataBinding(EventArgs) |
Genera el evento DataBinding. (Heredado de Control) |
| OnDataSourceChanged(EventArgs) |
Genera el evento DataSourceChanged. (Heredado de HierarchicalDataSourceControl) |
| OnInit(EventArgs) |
Genera el evento Init. (Heredado de Control) |
| OnLoad(EventArgs) |
Genera el evento Load. (Heredado de Control) |
| OnPreRender(EventArgs) |
Genera el evento PreRender. (Heredado de Control) |
| OnTransforming(EventArgs) |
Provoca el evento Transforming antes de que el control XmlDataSource realice una transformación XSLT en sus datos XML. |
| OnUnload(EventArgs) |
Genera el evento Unload. (Heredado de Control) |
| OpenFile(String) |
Obtiene un objeto Stream utilizado para leer un archivo. (Heredado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Asigna los orígenes del evento y su información al control principal del control. (Heredado de Control) |
| RemovedControl(Control) |
Se llama después de quitar un control secundario de la colección Controls del objeto Control. (Heredado de Control) |
| Render(HtmlTextWriter) |
Envía el contenido del control de servidor al objeto HtmlTextWriter proporcionado, que escribe el contenido que se representará en el cliente. (Heredado de Control) |
| RenderChildren(HtmlTextWriter) |
Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente. (Heredado de Control) |
| 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. (Heredado de HierarchicalDataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado. (Heredado de Control) |
| ResolveAdapter() |
Obtiene el adaptador de controles que se encarga de representar el control especificado. (Heredado de Control) |
| ResolveClientUrl(String) |
Obtiene una dirección URL que el explorador puede utilizar. (Heredado de Control) |
| ResolveUrl(String) |
Convierte una dirección URL en una que el cliente solicitante pueda utilizar. (Heredado de Control) |
| Save() |
Guarda en disco los datos XML que el control XmlDataSource mantiene actualmente en memoria si se establece la propiedad DataFile. |
| 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. (Heredado de Control) |
| 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. (Heredado de Control) |
| SetDesignModeState(IDictionary) |
Establece los datos en tiempo de diseño para un control. (Heredado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal. (Heredado de Control) |
| 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. (Heredado de Control) |
| 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. (Heredado de Control) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
| 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. Este objeto es accesible a través de la propiedad ViewState. (Heredado de Control) |
Eventos
| DataBinding |
Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control) |
| 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. (Heredado de Control) |
| Init |
Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida. (Heredado de Control) |
| Load |
Se produce cuando el control de servidor se carga en el objeto Page. (Heredado de Control) |
| PreRender |
Se produce una vez que se carga el objeto Control, pero antes de su representación. (Heredado de Control) |
| 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. |
| Unload |
Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control) |
Implementaciones de interfaz explícitas
| IControlBuilderAccessor.ControlBuilder |
Para obtener una descripción de este miembro, vea ControlBuilder. (Heredado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obtener una descripción de este miembro, vea GetDesignModeState(). (Heredado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary). (Heredado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obtener una descripción de este miembro, vea SetOwnerControl(Control). (Heredado de Control) |
| IControlDesignerAccessor.UserData |
Para obtener una descripción de este miembro, vea UserData. (Heredado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obtener una descripción de este miembro, vea DataBindings. (Heredado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obtener una descripción de este miembro, vea HasDataBindings. (Heredado de Control) |
| IDataSource.DataSourceChanged |
Para obtener una descripción de este miembro, vea DataSourceChanged. |
| IDataSource.GetView(String) |
Obtiene la vista de origen de datos con nombre asociada al control de origen de datos. |
| IDataSource.GetViewNames() |
Para obtener una descripción de este miembro, vea GetViewNames(). |
| IExpressionsAccessor.Expressions |
Para obtener una descripción de este miembro, vea Expressions. (Heredado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obtener una descripción de este miembro, vea HasExpressions. (Heredado de Control) |
| IHierarchicalDataSource.DataSourceChanged |
Se produce cuando los cambios de HierarchicalDataSourceControl afectan de alguna manera a los controles enlazados a datos. (Heredado de HierarchicalDataSourceControl) |
| IHierarchicalDataSource.GetHierarchicalView(String) |
Obtiene el objeto del asistente de la vista para la interfaz IHierarchicalDataSource para la ruta de acceso especificada. (Heredado de HierarchicalDataSourceControl) |
| IListSource.ContainsListCollection |
Para obtener una descripción de este miembro, vea ContainsListCollection. |
| IListSource.GetList() |
Para obtener una descripción de este miembro, vea GetList(). |
| IParserAccessor.AddParsedSubObject(Object) |
Para obtener una descripción de este miembro, vea AddParsedSubObject(Object). (Heredado de Control) |
Métodos de extensión
| FindDataSourceControl(Control) |
Devuelve el origen de datos que está asociado al control de datos del control especificado. |
| FindFieldTemplate(Control, String) |
Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado. |
| FindMetaTable(Control) |
Devuelve el objeto de metatabla para el control de datos contenedor. |
| GetDefaultValues(IDataSource) |
Obtiene la colección de los valores predeterminados para el origen de datos especificado. |
| GetMetaTable(IDataSource) |
Obtiene los metadatos para una tabla en el objeto de origen de datos especificado. |
| TryGetMetaTable(IDataSource, MetaTable) |
Determina si están disponibles los metadatos de la tabla. |
Se aplica a
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de