XmlDataSource Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa uma fonte de dados XML para controles ligados a dados.
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- Herança
- Atributos
- Implementações
Exemplos
Esta seção contém dois exemplos de código. O primeiro exemplo de código demonstra como usar um XmlDataSource controle com um TreeView controle para exibir dados XML do arquivo XML de exemplo. O segundo exemplo demonstra como usar um XmlDataSource controle com um controle modelo Repeater para exibir dados XML.
O exemplo de código a seguir demonstra como usar um XmlDataSource controle com um TreeView controle para exibir dados XML. O XmlDataSource carrega dados XML do arquivo XML identificado pela DataFile propriedade .
<%@ 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>
O arquivo XML no exemplo de código tem os seguintes dados:
<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>
O exemplo de código a seguir demonstra como usar um XmlDataSource controle com um controle modelo Repeater para exibir dados XML. O Repeater controle usa uma expressão de associação de dados XPath para associar a itens de dados dentro do documento XML que o XmlDataSource representa. Para obter mais informações sobre XPath a sintaxe de associação de dados e XPathSelect , consulte a XPathBinder classe .
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
O arquivo XML no exemplo de código tem os seguintes dados:
<?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>
Comentários
Neste tópico:
Introdução
O XmlDataSource controle é um controle de fonte de dados que apresenta dados XML para controles associados a dados. O XmlDataSource controle pode ser usado por controles associados a dados para exibir dados hierárquicos e tabulares. O XmlDataSource controle normalmente é usado para exibir dados XML hierárquicos em cenários somente leitura. Como o XmlDataSource controle estende a HierarchicalDataSourceControl classe , ele funciona com dados hierárquicos. O XmlDataSource controle também implementa a IDataSource interface e funciona com dados tabulares ou de estilo de lista.
Observação
Para fins de segurança, nenhuma das XmlDataSource propriedades de controle é armazenada no estado de exibição. Como tecnicamente é possível decodificar o conteúdo do estado de exibição no cliente, armazenar informações confidenciais sobre a estrutura de dados ou seu conteúdo pode expô-lo a uma ameaça de divulgação de informações. Observe que, se você precisar armazenar informações como XPath propriedade no estado de exibição, poderá habilitar a criptografia para proteger o conteúdo definindo ViewStateEncryptionMode na @ Page diretiva .
Os desenvolvedores de página usam o XmlDataSource controle para exibir dados XML usando controles associados a dados.
Fontes de dados XML
O XmlDataSource normalmente carrega dados XML de um arquivo XML, que é especificado pela DataFile propriedade . Os dados XML também podem ser armazenados diretamente pelo controle da fonte de dados no formato de cadeia de caracteres usando a Data propriedade . Se você quiser transformar os dados XML antes que eles sejam exibidos por um controle associado a dados, você poderá fornecer uma folha de estilos XSL (Extensible Stylesheet Language) para a transformação. Assim como acontece com os dados XML, você normalmente carrega a folha de estilos de um arquivo, indicado pela TransformFile propriedade , mas também pode armazená-la no formato de cadeia de caracteres diretamente usando a Transform propriedade .
Atualizando dados XML
O XmlDataSource controle é comumente usado em cenários de dados somente leitura em que um controle associado a dados exibe dados XML. No entanto, você também pode usar o XmlDataSource controle para editar dados XML. Para editar os dados XML, chame o GetXmlDocument método para recuperar um XmlDataDocument objeto que é uma representação na memória dos dados XML. Você pode usar o modelo de objeto exposto pelos XmlDataDocument objetos e XmlNode que ele contém ou usar uma expressão de filtragem XPath para manipular dados no documento. Quando você tiver feito alterações na representação na memória dos dados XML, poderá salvá-los no disco chamando o Save método .
Há algumas restrições para os recursos de edição do XmlDataSource controle:
Os dados XML devem ser carregados de um arquivo XML indicado pela DataFile propriedade, não do XML embutido especificado na Data propriedade .
Nenhuma transformação XSLT pode ser especificada nas Transform propriedades ou TransformFile .
O Save método não manipula operações de salvamento simultâneas por solicitações diferentes. Se mais de um usuário estiver editando um arquivo XML por meio do XmlDataSource, não haverá garantia de que todos os usuários estejam operando com os mesmos dados. Também é possível que uma Save operação falhe devido a esses mesmos problemas de simultaneidade.
Especificando uma transformação XSL
Uma operação comum executada com dados XML é transformá-la de um conjunto de dados XML em outro. O XmlDataSource controle dá suporte a transformações XML com as Transform propriedades e TransformFile , que especificam uma folha de estilos XSL a ser aplicada a dados XML antes de serem passados para um controle associado a dados e a TransformArgumentList propriedade , que permite fornecer argumentos dinâmicos da folha de estilos XSLT a serem usados por uma folha de estilos XSL durante a transformação. Se você especificar uma expressão de filtragem XPath usando a XPath propriedade , ela será aplicada depois que a transformação ocorrer.
Observação
A XmlDataSource classe usa a classe preterida XslTransform para executar transformações XSL. Se você quiser usar recursos de folha de estilos que foram introduzidos depois que a XslTransform classe foi preterida, aplique as transformações manualmente usando a XslCompiledTransform classe .
Filtragem usando uma expressão XPath
Por padrão, o XmlDataSource controle carrega todos os dados XML no arquivo XML identificado pela DataFile propriedade ou encontrado embutido na Data propriedade , mas você pode filtrar os dados usando uma expressão XPath. A XPath propriedade dá suporte a um filtro de sintaxe XPath que é aplicado depois que os dados XML são carregados e transformados.
Cache
Para fins de desempenho, o cache é habilitado para o XmlDataSource controle por padrão. Abrir e ler um arquivo XML no servidor sempre que uma página solicitada puder reduzir o desempenho do aplicativo. O cache permite reduzir a carga de processamento no servidor em detrimento da memória no servidor Web; na maioria dos casos, esta é uma boa compensação. O XmlDataSource armazena dados automaticamente em cache quando a EnableCaching propriedade é definida truecomo e a CacheDuration propriedade é definida como o número de segundos que o cache armazena dados antes que o cache seja invalidado. Você pode usar o CacheExpirationPolicy para ajustar ainda mais o comportamento de cache do controle da fonte de dados.
Recursos Adicionais
A tabela a seguir lista recursos adicionais compatíveis com o XmlDataSource controle .
| Recurso | Descrição |
|---|---|
| Classificação | Não há suporte para o XmlDataSource controle . |
| Filtragem | A XPath propriedade pode ser usada para filtrar os dados XML usando uma expressão XPath apropriada. |
| Paginamento | Não há suporte para o XmlDataSource controle . |
| Atualizar | Com suporte manipulando o XmlDataDocument diretamente e, em seguida, chamando o Save método . |
| Excluir | Com suporte manipulando o XmlDataDocument diretamente e, em seguida, chamando o Save método . |
| Inserindo | Com suporte manipulando o XmlDataDocument diretamente e, em seguida, chamando o Save método . |
| Cache | Habilitado por padrão, com a CacheDuration propriedade definida como 0 (infinito) e a CacheExpirationPolicy propriedade definida como Absolute. |
Objeto De Exibição de Dados
Como o controle dá suporte a XmlDataSource controles associados a dados que exibem dados hierárquicos, bem como controles que exibem dados tabulares, o controle da fonte de dados dá suporte a vários tipos de objetos de exibição de fonte de dados em seus dados XML subjacentes. O XmlDataSource controle recupera um único objeto nomeado XmlDataSourceView quando usado com um controle associado a dados que exibe dados tabulares. O GetViewNames método identifica esse único modo de exibição nomeado. Quando usado com um controle associado a dados que exibe dados hierárquicos, o XmlDataSource controle recupera um XmlHierarchicalDataSourceView para qualquer caminho hierárquico exclusivo passado para o GetHierarchicalView método .
Sintaxe 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>
Construtores
| XmlDataSource() |
Cria uma nova instância da classe XmlDataSource. |
Propriedades
| Adapter |
Obtém o adaptador específico de navegador para o controle. (Herdado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control) |
| BindingContainer |
Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control) |
| CacheDuration |
Obtém ou define o período de tempo, em segundos, em que o controle de fonte de dados armazena em cache os dados que recupera. |
| CacheExpirationPolicy |
Obtém ou define a política de expiração de cache que é combinada com a duração do cache para descrever o comportamento do cache que o controle de fonte de dados usa. |
| CacheKeyContext |
Obtém ou define o valor da chave de cache para o controle de fonte de dados do estado de exibição ou adiciona a chave de cache no estado de exibição. |
| CacheKeyDependency |
Obtém ou define uma dependência de chave definida pelo usuário que é vinculada a todos os objetos de cache de dados criados pelo controle de fonte de dados. Todos os objetos de cache expiram explicitamente quando a chave expira. |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o identificador de controle de servidor gerado pelo ASP.NET. (Herdado de HierarchicalDataSourceControl) |
| ClientIDMode |
Essa propriedade não é usada para controles de fonte de dados. (Herdado de HierarchicalDataSourceControl) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control) |
| Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control) |
| Controls |
Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário. (Herdado de HierarchicalDataSourceControl) |
| Data |
Obtém ou define um bloco de dados XML ao qual o controle de fonte de dados é associado. |
| DataFile |
Especifica o nome do arquivo de um arquivo XML ao qual a fonte de dados é associada. |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control) |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control) |
| EnableCaching |
Obtém ou define um valor que indica se o controle XmlDataSource tem o cache de dados habilitado. |
| EnableTheming |
Obtém um valor que indica se esse controle dá suporte a temas. (Herdado de HierarchicalDataSourceControl) |
| EnableViewState |
Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control) |
| HasChildViewState |
Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control) |
| ID |
Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control) |
| IdSeparator |
Obtém o caractere usado para separar identificadores de controle. (Herdado de Control) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control) |
| IsTrackingViewState |
Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control) |
| IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control) |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control) |
| Page |
Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control) |
| RenderingCompatibility |
Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou define a capa a ser aplicada ao controle HierarchicalDataSourceControl. (Herdado de HierarchicalDataSourceControl) |
| TemplateControl |
Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control) |
| Transform |
Obtém ou define um bloco de dados XSL (linguagem XSL) que define uma transformação XSLT a ser executada nos dados XML gerenciados pelo controle XmlDataSource. |
| TransformArgumentList |
Fornece uma lista de argumentos XSLT que são usados com a folha de estilos definida pelas propriedades Transform ou TransformFile para executar uma transformação nos dados XML. |
| TransformFile |
Especifica o nome do arquivo de um arquivo XSL (linguagem XSL) (.xsl) que define uma transformação XSLT a ser executada nos dados XML gerenciados pelo controle XmlDataSource. |
| UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control) |
| ValidateRequestMode |
Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| ViewState |
Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control) |
| Visible |
Obtém ou define um valor indicando se o controle é exibido visualmente. (Herdado de HierarchicalDataSourceControl) |
| XPath |
Especifica uma expressão XPath a ser aplicada aos dados XML contidos na propriedade Data ou pelo arquivo XML indicado pela propriedade DataFile. |
Métodos
| AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor. (Herdado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de HierarchicalDataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor ClientID armazenado em cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control) |
| ClearChildState() |
Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control) |
| CreateChildControls() |
Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control) |
| CreateControlCollection() |
Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de HierarchicalDataSourceControl) |
| DataBind() |
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de Control) |
| DataBind(Boolean) |
Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control) |
| DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control) |
| Dispose() |
Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control) |
| EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindControl(String) |
Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro |
| FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
| Focus() |
Define o foco de entrada para o controle. (Herdado de HierarchicalDataSourceControl) |
| GetDesignModeState() |
Obtém os dados de tempo de design para um controle. (Herdado de Control) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetHierarchicalView(String) |
Obtém o objeto de exibição de fonte de dados do controle XmlDataSource. O parâmetro |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control) |
| GetXmlDocument() |
Carrega os dados XML na memória, diretamente do armazenamento de dados subjacente ou do cache e o retorna no formato de um objeto XmlDataDocument. |
| HasControls() |
Determina se o controle de servidor contém algum controle filho. (Herdado de HierarchicalDataSourceControl) |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control) |
| IsLiteralContent() |
Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState(). (Herdado de Control) |
| LoadViewState(Object) |
Restaura informações de estado de exibição de uma solicitação de página anterior salva pelo método SaveViewState(). (Herdado de Control) |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding. (Herdado de Control) |
| OnDataSourceChanged(EventArgs) |
Aciona o evento DataSourceChanged. (Herdado de HierarchicalDataSourceControl) |
| OnInit(EventArgs) |
Aciona o evento Init. (Herdado de Control) |
| OnLoad(EventArgs) |
Aciona o evento Load. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o evento PreRender. (Herdado de Control) |
| OnTransforming(EventArgs) |
Gera o evento Transforming antes que o controle XmlDataSource execute uma transformação XSLT em seus dados XML. |
| OnUnload(EventArgs) |
Aciona o evento Unload. (Herdado de Control) |
| OpenFile(String) |
Obtém um Stream usado para ler um arquivo. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control) |
| RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control) |
| Render(HtmlTextWriter) |
Envia o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderChildren(HtmlTextWriter) |
Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de HierarchicalDataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control) |
| ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control) |
| Save() |
Salvará no disco os dados XML mantidos atualmente na memória pelo controle XmlDataSource se a propriedade DataFile estiver definida. |
| SaveControlState() |
Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control) |
| SaveViewState() |
Salva alterações de estado de exibição do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control) |
| SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Causa o acompanhamento das alterações de estado de exibição para o controle de servidor, para que elas possam ser armazenadas no objeto StateBag do controle de servidor. Esse objeto é acessível por meio da propriedade ViewState. (Herdado de Control) |
Eventos
| DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control) |
| Disposed |
Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control) |
| Load |
Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control) |
| PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control) |
| Transforming |
Ocorre antes que a folha de estilos definida pela propriedade Transform ou identificada pela propriedade TransformFile seja aplicada aos dados XML. |
| Unload |
Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control) |
Implantações explícitas de interface
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, confira UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control) |
| IDataSource.DataSourceChanged |
Para obter uma descrição desse membro, confira DataSourceChanged. |
| IDataSource.GetView(String) |
Obtém a exibição de fonte de dados nomeada associada ao controle de fonte de dados. |
| IDataSource.GetViewNames() |
Para obter uma descrição desse membro, confira GetViewNames(). |
| IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, confira Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control) |
| IHierarchicalDataSource.DataSourceChanged |
Ocorre quando o HierarchicalDataSourceControl é alterado de alguma forma que afeta controles associados a dados. (Herdado de HierarchicalDataSourceControl) |
| IHierarchicalDataSource.GetHierarchicalView(String) |
Obtém o objeto auxiliar de exibição para a interface IHierarchicalDataSource para o caminho especificado. (Herdado de HierarchicalDataSourceControl) |
| IListSource.ContainsListCollection |
Para obter uma descrição desse membro, confira ContainsListCollection. |
| IListSource.GetList() |
Para obter uma descrição desse membro, confira GetList(). |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control) |
Métodos de Extensão
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados do controle especificado. |
| FindFieldTemplate(Control, String) |
Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado. |
| FindMetaTable(Control) |
Retorna o objeto metatable para o controle que contém dados. |
| GetDefaultValues(IDataSource) |
Obtém a coleção de valores padrão para a fonte de dados especificada. |
| GetMetaTable(IDataSource) |
Obtém os metadados para uma tabela no objeto de fonte de dados especificado. |
| TryGetMetaTable(IDataSource, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |
Aplica-se a
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de