XmlDataSource.Transform Proprietà

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

Valore della proprietà

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

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.

Si applica a

Vedi anche

• TransformFile
• CacheKeyDependency