XmlDataSource.Transform Propiedad

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

[System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
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")]
public virtual string Transform { get; set; }

[<System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.Transform : string with 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 de propiedad

Cadena de XSL en línea que define una transformación de XML que se va a realizar en los datos incluidos en las propiedades Data o DataFile. El valor predeterminado es Empty.

Atributos

TypeConverterAttribute PersistenceModeAttribute

Excepciones

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un XmlDataSource control con plantilla Repeater para mostrar datos XML transformados. La hoja de estilos que realiza la transformación se define en línea mediante la Transform propiedad del control de origen de datos.

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

Comentarios

En escenarios declarativos, la Transform propiedad se especifica como una propiedad interna de varias líneas del XmlDataSource objeto . Una propiedad interna es compatible con los datos de la hoja de estilos XSL, ya que permite dar formato a la hoja de estilos de cualquier manera y omitir problemas de relleno de caracteres, como caracteres de comillas de relleno.

Si se establecen las TransformFile propiedades y Transform , la TransformFile propiedad tiene prioridad y los datos del archivo de hoja de estilos XSL (.xsl) se usan en lugar de los elementos de hoja de estilos especificados en la Transform propiedad . Si se establece una expresión XPath mediante la XPath propiedad , se aplica después de transformar los datos XML.

Si cambia el valor de la Transform propiedad , se genera el DataSourceChanged evento . Si el almacenamiento en caché está habilitado y cambia el valor de Transform, la memoria caché se invalida.

Se aplica a

Consulte también

• TransformFile
• CacheKeyDependency