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