XmlDataSource.Transform Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

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.

public:
 virtual property System::String ^ Transform { System::String ^ get(); void set(System::String ^ value); };

[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public virtual string Transform { get; set; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
[<System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
member this.Transform : string with get, set

Public Overridable Property Transform As String

Valor da propriedade

String

Uma cadeia de caracteres de XSL embutido que define uma transformação XML a ser executada nos dados contidos nas Data propriedades ou DataFile . O valor padrão é Empty.

Atributos

TypeConverterAttribute PersistenceModeAttribute

Exceções

InvalidOperationException

O documento está carregando.

Exemplos

O exemplo de código a seguir demonstra como usar um XmlDataSource controle com um controle modelo Repeater para exibir dados XML transformados. A folha de estilos que executa a transformação é definida embutida pela Transform propriedade do controle da fonte de dados.

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>Todd</firstn>  
         <lastn>Rowe</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

Em cenários declarativos, a Transform propriedade é especificada como uma propriedade interna de várias linhas do XmlDataSource objeto. Uma propriedade interna é compatível com os dados da folha de estilos XSL, pois permite formatar a folha de estilos de qualquer forma e ignorar problemas de preenchimento de caracteres, como caracteres de aspas de preenchimento.

Se as TransformFile propriedades e Transform forem definidas, a TransformFile propriedade terá precedência e os dados no arquivo de folha de estilos XSL (.xsl) serão usados em vez dos elementos de folha de estilos especificados na Transform propriedade . Se uma expressão XPath for definida usando a XPath propriedade , ela será aplicada depois que os dados XML forem transformados.

Se você alterar o valor da Transform propriedade , o DataSourceChanged evento será gerado. Se o cache estiver habilitado e você alterar o valor de Transform, o cache será invalidado.

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 .

Confira também

• TransformFile
• CacheKeyDependency