XmlDataSource.Transform XmlDataSource.Transform XmlDataSource.Transform XmlDataSource.Transform Property

Definizione

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.Gets or sets a block of Extensible Stylesheet Language (XSL) data that defines an XSLT transformation to be performed on the XML data managed by the XmlDataSource control.

public:
 virtual property System::String ^ Transform { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
[System.ComponentModel.TypeConverter("System.ComponentModel.MultilineStringConverter,System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public virtual string Transform { get; set; }
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.A string of inline XSL that defines an XML transformation to be performed on the data contained in the Data or DataFile properties. Il valore predefinito è Empty.The default value is Empty.

Eccezioni

È in corso il caricamento del documento.The document is loading.

Esempi

Esempio di codice seguente viene illustrato come utilizzare un XmlDataSource controllo con una basata su modelli Repeater controllo per visualizzare i dati XML trasformati.The following code example demonstrates how to use an XmlDataSource control with a templated Repeater control to display transformed XML data. Il foglio di stile che esegue la trasformazione viene definito inline dal Transform proprietà del controllo origine dati.The style sheet that performs the transformation is defined inline by the Transform property of the data source control.

Il file XML nell'esempio di codice presenta i seguenti dati:The XML file in the code example has the following data:

<?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 una proprietà interna su più righe del XmlDataSource oggetto.In declarative scenarios, the Transform property is specified as a multiline inner property of the XmlDataSource object. Una proprietà interna è compatibile con i dati del foglio di stile XSL, perché ti consente di formattare il foglio di stile in qualsiasi modo e ignorare i problemi di riempimento caratteri quali virgolette di riempimento.An inner property is compatible with XSL style sheet data, because it enables you to format the style sheet in any way and ignore character padding issues such as padding quote characters.

Se entrambi i TransformFile e Transform sono impostate, il TransformFile proprietà ha la precedenza e i dati nel file di foglio di stile XSL (con estensione xsl) viene usati invece gli elementi del foglio di stile specificati nel Transform proprietà.If both the TransformFile and Transform properties are set, the TransformFile property takes precedence and the data in the XSL style sheet file (.xsl) is used instead of the style sheet elements specified in the Transform property. Se un'espressione XPath viene impostata utilizzando il XPath proprietà, viene applicata dopo che i dati XML viene trasformati.If an XPath expression is set using the XPath property, it is applied after the XML data is transformed.

Se si modifica il valore della Transform proprietà, il DataSourceChanged viene generato l'evento.If you change the value of the Transform property, the DataSourceChanged event is raised. Se la memorizzazione nella cache è abilitata e si modifica il valore di Transform, la cache viene invalidata.If caching is enabled and you change the value of Transform, the cache is invalidated.

Nota

Il XmlDataSource classe utilizza deprecate XslTransform classe per eseguire trasformazioni XSL.The XmlDataSource class uses the deprecated XslTransform class to perform XSL transformations. Se si desidera utilizzare le funzionalità di foglio di stile che sono stati introdotti dopo la XslTransform classe è stata deprecata, applicare le trasformazioni manualmente utilizzando il XslCompiledTransform classe.If you want to use style sheet features that were introduced after the XslTransform class was deprecated, apply the transforms manually by using the XslCompiledTransform class.

Si applica a

Vedi anche