XmlDataSource.Transform Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.dll

Obtiene o establece un bloque de datos XSL (Extensible Stylesheet Language) que define una transformación XSLT que se realizará en los datos XML que administra el control 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 de propiedad

String

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

InvalidOperationException

El documento se está cargando.

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.

Nota

La XmlDataSource clase usa la clase en desuso XslTransform para realizar transformaciones XSL. Si desea usar las características de hoja de estilos que se introdujeron después de que la XslTransform clase haya quedado en desuso, aplique las transformaciones manualmente mediante la XslCompiledTransform clase .

Consulte también

• TransformFile
• CacheKeyDependency