XmlDataSource.Transform Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ottiene o imposta un blocco di dati XSL (Extensible Stylesheet Language) che definisce una trasformazione XSLT da eseguire sui dati XML gestiti dal controllo 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

Valore della proprietà

String

Stringa di codice XSL inline che definisce una trasformazione XML da eseguire sui dati contenuti nelle proprietà Data o DataFile. Il valore predefinito è Empty.

Attributi

TypeConverterAttribute PersistenceModeAttribute

Eccezioni

InvalidOperationException

È in corso il caricamento del documento.

Esempio

Nell'esempio di codice seguente viene illustrato come usare un controllo con un XmlDataSource controllo modello Repeater per visualizzare i dati XML trasformati. Il foglio di stile che esegue la trasformazione è definito inline dalla Transform proprietà del controllo origine dati.

Il file XML nell'esempio di codice contiene i dati seguenti:

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

Commenti

Negli scenari dichiarativi, la Transform proprietà viene specificata come proprietà interna multilinea dell'oggetto XmlDataSource . Una proprietà interna è compatibile con i dati del foglio di stile XSL, perché consente di formattare il foglio di stile in qualsiasi modo e ignorare i problemi di spaziatura dei caratteri, ad esempio i caratteri delle virgolette di riempimento.

Se entrambe le TransformFile proprietà e Transform sono impostate, la TransformFile proprietà ha la precedenza e i dati nel file del foglio di stile XSL (.xsl) vengono usati anziché gli elementi del foglio di stile specificati nella Transform proprietà. Se un'espressione XPath viene impostata usando la XPath proprietà, viene applicata dopo la trasformazione dei dati XML.

Se si modifica il valore della proprietà, viene generato l'evento TransformDataSourceChanged . Se la memorizzazione nella cache è abilitata e si modifica il valore di Transform, la cache non è valida.

Nota

La XmlDataSource classe usa la classe deprecata XslTransform per eseguire trasformazioni XSL. Se si desidera usare le funzionalità del foglio di stile introdotte dopo che la XslTransform classe è stata deprecata, applicare manualmente le trasformazioni usando la XslCompiledTransform classe .

Vedi anche

• TransformFile
• CacheKeyDependency