Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe XmlDataSource

 

Representa uma fonte de dados XML para controles ligados a dados.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.HierarchicalDataSourceControl
      System.Web.UI.WebControls.XmlDataSource

[ToolboxBitmapAttribute(typeof(XmlDataSource))]
public class XmlDataSource : HierarchicalDataSourceControl, IDataSource, 
	IListSource

NomeDescrição
System_CAPS_pubmethodXmlDataSource()

Cria uma nova instância de XmlDataSource classe.

NomeDescrição
System_CAPS_protpropertyAdapter

Obtém as especificações do navegador para o controle. (Herdado de Control.)

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.(Herdado de Control.)

System_CAPS_pubpropertyBindingContainer

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o controle que contém a vinculação de dados desse controle.(Herdado de Control.)

System_CAPS_pubpropertyCacheDuration

Obtém ou define o período de tempo, em segundos, que o controle da fonte de dados armazena dados em cache que foi recuperada.

System_CAPS_pubpropertyCacheExpirationPolicy

Obtém ou define a política de expiração do cache é combinada com a duração de cache para descrever o comportamento do cache do cache que usa o controle de fonte de dados.

System_CAPS_pubpropertyCacheKeyContext

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 para estado de exibição.

System_CAPS_pubpropertyCacheKeyDependency

Obtém ou define uma dependência de chave definidas pelo usuário que está vinculada a todos os objetos de cache de dados criados pelo controle da fonte de dados. Todos os objetos em cache expirarem explicitamente quando a chave expira.

System_CAPS_protpropertyChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.(Herdado de Control.)

System_CAPS_pubpropertyClientID

Obtém o identificador de controle de servidor gerado pelo ASP.NET.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_pubpropertyClientIDMode

Essa propriedade não é usada para controles da fonte de dados.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_protpropertyClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.(Herdado de Control.)

System_CAPS_protpropertyContext

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.(Herdado de Control.)

System_CAPS_pubpropertyControls

Obtém uma ControlCollection objeto que representa os controles filho de um controle de servidor especificado na hierarquia de interface do usuário.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_pubpropertyData

Obtém ou define um bloco de dados XML ao qual o controle de fonte de dados é associado.

System_CAPS_pubpropertyDataFile

Especifica o nome do arquivo de um arquivo XML ao qual a fonte de dados é associada.

System_CAPS_pubpropertyDataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.(Herdado de Control.)

System_CAPS_pubpropertyDataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.(Herdado de Control.)

System_CAPS_protpropertyDesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.(Herdado de Control.)

System_CAPS_pubpropertyEnableCaching

Obtém ou define um valor que indica se o controle XmlDataSource tem o cache de dados habilitado.

System_CAPS_pubpropertyEnableTheming

Obtém um valor que indica se esse controle oferece suporte a temas.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_pubpropertyEnableViewState

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

System_CAPS_protpropertyEvents

Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura.(Herdado de Control.)

System_CAPS_protpropertyHasChildViewState

Obtém um valor indicando se os atuais controles filhos do controle do servidor têm quaisquer configurações do estado de visualização salvas.(Herdado de Control.)

System_CAPS_pubpropertyID

Obtém ou define o identificador programático atribuído ao controle de servidor.(Herdado de Control.)

System_CAPS_protpropertyIdSeparator

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o caractere usado para separar identificadores de controle.(Herdado de Control.)

System_CAPS_protpropertyIsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado do controle.(Herdado de Control.)

System_CAPS_protpropertyIsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando as alterações em seu estado de exibição.(Herdado de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.(Herdado de Control.)

System_CAPS_protpropertyLoadViewStateByID

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

System_CAPS_pubpropertyNamingContainer

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 Control.ID.(Herdado de Control.)

System_CAPS_pubpropertyPage

Obtém uma referência para a instância Page que contém o controle de servidor.(Herdado de Control.)

System_CAPS_pubpropertyParent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.(Herdado de Control.)

System_CAPS_pubpropertyRenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.(Herdado de Control.)

System_CAPS_pubpropertySite

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.(Herdado de Control.)

System_CAPS_pubpropertySkinID

Obtém ou define a capa a ser aplicada ao controle HierarchicalDataSourceControl.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_pubpropertyTemplateControl

Obtém ou define uma referência ao modelo que contém este controle.(Herdado de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.(Herdado de Control.)

System_CAPS_pubpropertyTransform

Obtém ou define um bloco de dados Extensible Stylesheet Language (XSL) que define uma transformação XSLT a ser executada nos dados XML gerenciados pelo XmlDataSource controle.

System_CAPS_pubpropertyTransformArgumentList

Fornece uma lista de argumentos XSLT que são usados com a folha de estilo definida pelo Transform ou TransformFile Propriedades para executar uma transformação nos dados XML.

System_CAPS_pubpropertyTransformFile

Especifica o nome de um arquivo Extensible Stylesheet Language (XSL) (. xsl) que define uma transformação XSLT a ser executada nos dados XML gerenciados pelo XmlDataSource controle.

System_CAPS_pubpropertyUniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.(Herdado de Control.)

System_CAPS_pubpropertyValidateRequestMode

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

System_CAPS_protpropertyViewState

Obtém um dicionário de informações de estado que permite você salvar e restaurar o estado de exibição de um controle de servidor nas várias solicitações para a mesma página. (Herdado de Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.(Herdado de Control.)

System_CAPS_pubpropertyViewStateMode

Obtém ou define o modo de estado de exibição deste controle.(Herdado de Control.)

System_CAPS_pubpropertyVisible

Obtém ou define um valor que indica se o controle é exibido visualmente.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_pubpropertyXPath

Especifica uma expressão XPath a ser aplicada aos dados XML contidos na propriedade Data ou pelo arquivo XML indicado pela propriedade DataFile.

NomeDescrição
System_CAPS_protmethodAddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.(Herdado de Control.)

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

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Aplica-se as propriedades de estilo que são definidas na folha de estilos de página para o controle.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Começa o rastreamento de tempo de design de dados de renderização.(Herdado de Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Reúne informações sobre o controle de servidor e enviá-lo para o Trace propriedade a ser exibida quando o rastreamento está habilitado para a página.(Herdado de Control.)

System_CAPS_protmethodClearCachedClientID()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Define o valor ClientID armazenado em cache como null.(Herdado de Control.)

System_CAPS_protmethodClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearChildState()

Exclui as informações de estado de exibição e estado de controle para controles filho de todo o controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Conjuntos de ClientIDMode propriedade da instância atual do controle e de todos os controles filho para Inherit.(Herdado de Control.)

System_CAPS_protmethodCreateChildControls()

Chamado pela estrutura da página ASP.NET para notificar os controles de servidor que usam implementação baseada em composição para criar os controles filho que eles contêm em preparação para postagem ou processamento. (Herdado de Control.)

System_CAPS_protmethodCreateControlCollection()

Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_pubmethodDataBind()

Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.(Herdado de Control.)

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

System_CAPS_protmethodDataBindChildren()

Associa uma fonte de dados para os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_pubmethodDispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.(Herdado de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Termina o rastreamento em tempo de design de dados de renderização.(Herdado de Control.)

System_CAPS_protmethodEnsureChildControls()

Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho.(Herdado de Control.)

System_CAPS_protmethodEnsureID()

Cria um identificador para controles que não têm um identificador atribuído.(Herdado de Control.)

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodFindControl(String)

Procura o contêiner de nomeação atual para um controle de servidor com especificado id parâmetro.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_protmethodFindControl(String, Int32)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl.(Herdado de Control.)

System_CAPS_pubmethodFocus()

Define o foco para o controle de entrada.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_protmethodGetDesignModeState()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém dados de tempo de design para um controle.(Herdado de Control.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_protmethodGetHierarchicalView(String)

Obtém o objeto de exibição de fonte de dados para o XmlDataSource controle. O viewPath parâmetro pode ser uma expressão XPath.(Substitui o HierarchicalDataSourceControl.GetHierarchicalView(String).)

System_CAPS_pubmethodGetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.(Herdado de Control.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.(Herdado de Control.)

System_CAPS_pubmethodGetXmlDocument()

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.

System_CAPS_pubmethodHasControls()

Determina se o controle de servidor contém todos os controles filho.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_protmethodHasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.(Herdado de Control.)

System_CAPS_protmethodIsLiteralContent()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Determina se o controle de servidor contém apenas o conteúdo literal.(Herdado de Control.)

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

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

System_CAPS_protmethodMapPathSecure(String)

Recupera o caminho físico que é mapeado para um caminho virtual, relativo ou absoluto.(Herdado de Control.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

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

System_CAPS_protmethodOnDataBinding(EventArgs)

Aciona o evento DataBinding.(Herdado de Control.)

System_CAPS_protmethodOnDataSourceChanged(EventArgs)
System_CAPS_protmethodOnInit(EventArgs)

Aciona o evento Init.(Herdado de Control.)

System_CAPS_protmethodOnLoad(EventArgs)

Aciona o evento Load.(Herdado de Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Aciona o evento PreRender.(Herdado de Control.)

System_CAPS_protmethodOnTransforming(EventArgs)

Gera o Transforming evento antes do XmlDataSource controle executa uma transformação XSLT em seus dados XML.

System_CAPS_protmethodOnUnload(EventArgs)

Aciona o evento Unload.(Herdado de Control.)

System_CAPS_protmethodOpenFile(String)

Obtém um Stream usado para ler um arquivo.(Herdado de Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.(Herdado de Control.)

System_CAPS_protmethodRemovedControl(Control)

Chamado após a remoção de um controle filho a Controls coleção do Control objeto.(Herdado de Control.)

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

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Gera o conteúdo de filhos de um controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.(Herdado de Control.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor a um fornecido HtmlTextWriter de objeto e armazena informações de rastreamento sobre o controle se o rastreamento está habilitado.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.(Herdado de Control.)

System_CAPS_protmethodResolveAdapter()

Obtém o adaptador de controle responsável por processar o controle especificado.(Herdado de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.(Herdado de Control.)

System_CAPS_pubmethodResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.(Herdado de Control.)

System_CAPS_pubmethodSave()

Salva os dados XML atualmente mantidos na memória, o XmlDataSource controle no disco se o DataFile está definida.

System_CAPS_protmethodSaveControlState()

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

System_CAPS_protmethodSaveViewState()

Salva quaisquer alterações no viewstate de um controle de servidor que ocorreram apos o último postback da página.(Herdado de Control.)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.(Herdado de Control.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.(Herdado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de dados de rastreamento de dados de renderização, usando a chave de dados de rastreamento e o valor de dados de rastreamento de tempo de design de rastreamento.(Herdado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de dados de rastreamento de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor de dados de rastreamento de tempo de design de rastreamento.(Herdado de Control.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

System_CAPS_protmethodTrackViewState()

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 Control.ViewState.(Herdado de Control.)

NomeDescrição
System_CAPS_pubeventDataBinding

Ocorre quando o server control vincula a uma fonte de dados.(Herdado de Control.)

System_CAPS_pubeventDisposed

Ocorre quando um server control é liberado da memória, que é a última etapa do ciclo de vida do server contorl quando uma página ASP.NET é solicitada.(Herdado de Control.)

System_CAPS_pubeventInit

Ocorre quando o server control é inicializado, que é o primeiro passo em seu ciclo de vida.(Herdado de Control.)

System_CAPS_pubeventLoad

Ocorre quando o controle de servidor é carregado no objeto Page.(Herdado de Control.)

System_CAPS_pubeventPreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.(Herdado de Control.)

System_CAPS_pubeventTransforming

Ocorre antes da folha de estilos é definida pelo Transform propriedade ou identificado pelo TransformFile propriedade é aplicada aos dados XML.

System_CAPS_pubeventUnload

Ocorre quando o server control é descarregado da memória.(Herdado de Control.)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_priveventIDataSource.DataSourceChanged

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte DataSourceChanged.

System_CAPS_pubinterfaceSystem_CAPS_priveventIHierarchicalDataSource.DataSourceChanged

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Ocorre quando o HierarchicalDataSourceControl foi alterado de alguma forma que afeta os controles ligados a dados.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIListSource.GetList()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte GetList.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.GetDesignModeState.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.SetDesignModeState.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte IControlDesignerAccessor.SetOwnerControl.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetView(String)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém a exibição da fonte de dados chamado associada com o controle de fonte de dados.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIDataSource.GetViewNames()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte GetViewNames.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIHierarchicalDataSource.GetHierarchicalView(String)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o objeto auxiliar de exibição para o IHierarchicalDataSource interface para o caminho especificado.(Herdado de HierarchicalDataSourceControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, consulte IParserAccessor.AddParsedSubObject.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIListSource.ContainsListCollection

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte ContainsListCollection.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, consulte IControlBuilderAccessor.ControlBuilder.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.UserData.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, consulte IDataBindingsAccessor.DataBindings.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, consulte IDataBindingsAccessor.HasDataBindings.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para obter uma descrição desse membro, consulte IExpressionsAccessor.Expressions.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, consulte IExpressionsAccessor.HasExpressions.(Herdado de Control.)

NomeDescrição
System_CAPS_pubmethodFindDataSourceControl()

Retorna a fonte de dados associada ao controle de dados do controle especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Retorna que o modelo de campo para a coluna especificada no controle especificado do contêiner de nomeação.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Retorna o objeto metatable contendo o controle de dados.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodGetDefaultValues()

Sobrecarregado. Obtém a coleção de valores padrão para a fonte de dados especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Sobrecarregado. Obtém os metadados para uma tabela no objeto de fonte de dados especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Sobrecarregado. Determina se os metadados da tabela estão disponível.(Definido pelo DynamicDataExtensions.)

The T:System.Web.UI.WebControls.XmlDataSource control is a data source control that presents XML data to data-bound controls. The T:System.Web.UI.WebControls.XmlDataSource control can be used by data-bound controls to display both hierarchical and tabular data. The T:System.Web.UI.WebControls.XmlDataSource control is typically used to display hierarchical XML data in read-only scenarios. Because the T:System.Web.UI.WebControls.XmlDataSource control extends the T:System.Web.UI.HierarchicalDataSourceControl class, it works with hierarchical data. The T:System.Web.UI.WebControls.XmlDataSource control also implements the T:System.Web.UI.IDataSource interface and works with tabular, or list-style, data.

System_CAPS_noteObservação

For security purposes, none of the T:System.Web.UI.WebControls.XmlDataSource control properties are stored in view state. 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. Note that if you need to store information such as P:System.Web.UI.WebControls.XmlDataSource.XPath property in view state, you can enable encryption to protect the contents by setting P:System.Web.UI.Page.ViewStateEncryptionMode on the @ Page directive.

Page developers use the T:System.Web.UI.WebControls.XmlDataSource control to display XML data using data-bound controls.

The T:System.Web.UI.WebControls.XmlDataSource typically loads XML data from an XML file, which is specified by the P:System.Web.UI.WebControls.XmlDataSource.DataFile property. XML data can also be stored directly by the data source control in string form using the P:System.Web.UI.WebControls.XmlDataSource.Data property. 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. As with the XML data, you typically load the style sheet from a file, indicated by the P:System.Web.UI.WebControls.XmlDataSource.TransformFile property, but you can also store it in string form directly using the P:System.Web.UI.WebControls.XmlDataSource.Transform property.

The T:System.Web.UI.WebControls.XmlDataSource control is commonly used in read-only data scenarios where a data-bound control displays XML data. However, you can also use the T:System.Web.UI.WebControls.XmlDataSource control to edit XML data. To edit the XML data, call the M:System.Web.UI.WebControls.XmlDataSource.GetXmlDocument method to retrieve an T:System.Xml.XmlDataDocument object that is an in-memory representation of the XML data. You can use the object model exposed by the T:System.Xml.XmlDataDocument and T:System.Xml.XmlNode objects it contains or use an XPath filtering expression to manipulate data in the document. When you have made changes to the in-memory representation of the XML data, you can save it to disk by calling the M:System.Web.UI.WebControls.XmlDataSource.Save method.

There are some restrictions to the editing capabilities of the T:System.Web.UI.WebControls.XmlDataSource control:

  • The XML data must be loaded from an XML file that is indicated by the P:System.Web.UI.WebControls.XmlDataSource.DataFile property, not from inline XML specified in the P:System.Web.UI.WebControls.XmlDataSource.Data property.

  • No XSLT transformation can be specified in the P:System.Web.UI.WebControls.XmlDataSource.Transform or P:System.Web.UI.WebControls.XmlDataSource.TransformFile properties.

  • The M:System.Web.UI.WebControls.XmlDataSource.Save method does not handle concurrent save operations by different requests. If more than one user is editing an XML file through the T:System.Web.UI.WebControls.XmlDataSource, there is no guarantee that all users are operating with the same data. It is also possible for a M:System.Web.UI.WebControls.XmlDataSource.Save operation to fail due to these same concurrency issues.

A common operation performed with XML data is transforming it from one XML data set into another. The T:System.Web.UI.WebControls.XmlDataSource control supports XML transformations with the P:System.Web.UI.WebControls.XmlDataSource.Transform and P:System.Web.UI.WebControls.XmlDataSource.TransformFile properties, which specify an XSL style sheet to apply to XML data before it is passed to a data-bound control, and the P:System.Web.UI.WebControls.XmlDataSource.TransformArgumentList property, which enables you to supply dynamic XSLT style sheet arguments to be used by an XSL style sheet during the transformation. If you specify an XPath filtering expression using the P:System.Web.UI.WebControls.XmlDataSource.XPath property, it is applied after the transformation takes place.

System_CAPS_noteObservação

The T:System.Web.UI.WebControls.XmlDataSource class uses the deprecated T:System.Xml.Xsl.XslTransform class to perform XSL transformations. If you want to use style sheet features that were introduced after the T:System.Xml.Xsl.XslTransform class was deprecated, apply the transforms manually by using the T:System.Xml.Xsl.XslCompiledTransform class.

By default, the T:System.Web.UI.WebControls.XmlDataSource control loads all the XML data in the XML file identified by the P:System.Web.UI.WebControls.XmlDataSource.DataFile property or found inline in the P:System.Web.UI.WebControls.XmlDataSource.Data property, but you can filter the data using an XPath expression. The P:System.Web.UI.WebControls.XmlDataSource.XPath property supports an XPath-syntax filter that is applied after XML data is loaded and transformed.

For performance purposes, caching is enabled for the T:System.Web.UI.WebControls.XmlDataSource control by default. Opening and reading an XML file on the server every time a page requested can reduce the performance of your application. 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. The T:System.Web.UI.WebControls.XmlDataSource automatically caches data when the P:System.Web.UI.WebControls.XmlDataSource.EnableCaching property is set to true, and the P:System.Web.UI.WebControls.XmlDataSource.CacheDuration property is set to the number of seconds that the cache stores data before the cache is invalidated. You can use the P:System.Web.UI.WebControls.XmlDataSource.CacheExpirationPolicy to further fine-tune the caching behavior of the data source control.

The following table lists additional features that are supported by the T:System.Web.UI.WebControls.XmlDataSource control.

Capability

Description

Sorting

Not supported by the T:System.Web.UI.WebControls.XmlDataSource control.

Filtering

The P:System.Web.UI.WebControls.XmlDataSource.XPath property can be used to filter the XML data using an appropriate XPath expression.

Paging

Not supported by the T:System.Web.UI.WebControls.XmlDataSource control.

Updating

Supported by manipulating the T:System.Xml.XmlDataDocument directly and then calling the M:System.Web.UI.WebControls.XmlDataSource.Save method.

Deleting

Supported by manipulating the T:System.Xml.XmlDataDocument directly and then calling the M:System.Web.UI.WebControls.XmlDataSource.Save method.

Inserting

Supported by manipulating the T:System.Xml.XmlDataDocument directly and then calling the M:System.Web.UI.WebControls.XmlDataSource.Save method.

Caching

Enabled by default, with the P:System.Web.UI.WebControls.XmlDataSource.CacheDuration property set to 0 (infinite) and the P:System.Web.UI.WebControls.XmlDataSource.CacheExpirationPolicy property set to F:System.Web.UI.DataSourceCacheExpiry.Absolute.

Because the T:System.Web.UI.WebControls.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. The T:System.Web.UI.WebControls.XmlDataSource control retrieves a single named T:System.Web.UI.WebControls.XmlDataSourceView object when used with a data-bound control that displays tabular data. The M:System.Web.UI.IDataSource.GetViewNames method identifies this single named view. When used with a data-bound control that displays hierarchical data, the T:System.Web.UI.WebControls.XmlDataSource control retrieves an T:System.Web.UI.WebControls.XmlHierarchicalDataSourceView for any unique hierarchical path passed to the M:System.Web.UI.WebControls.XmlDataSource.GetHierarchicalView(System.String) method.

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

This section contains two code examples. The first code example demonstrates how to use an T:System.Web.UI.WebControls.XmlDataSource control with a T:System.Web.UI.WebControls.TreeView control to display XML data from the sample XML file. The second example demonstrates how to use an T:System.Web.UI.WebControls.XmlDataSource control with a templated T:System.Web.UI.WebControls.Repeater control to display XML data.

The following code example demonstrates how to use an T:System.Web.UI.WebControls.XmlDataSource control with a T:System.Web.UI.WebControls.TreeView control to display XML data. The T:System.Web.UI.WebControls.XmlDataSource loads XML data from the XML file identified by the P:System.Web.UI.WebControls.XmlDataSource.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>

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>

The following code example demonstrates how to use an T:System.Web.UI.WebControls.XmlDataSource control with a templated T:System.Web.UI.WebControls.Repeater control to display XML data. The T:System.Web.UI.WebControls.Repeater control uses an XPath data-binding expression to bind to data items within the XML document that the T:System.Web.UI.WebControls.XmlDataSource represents. For more information about XPath and XPathSelect data-binding syntax, see the T:System.Web.UI.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>

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>

.NET Framework
Disponível desde 2.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: