XmlDataSource.Transform Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Obtient ou définit un bloc des données XSL (Extensible Stylesheet Language) qui définit une transformation XSLT à exécuter sur les données XML gérées par le contrôle 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

Valeur de propriété

String

Une chaîne de XSL inline qui définit une transformation XML à exécuter sur les données contenues dans les propriétés Data ou DataFile. La valeur par défaut est Empty.

Attributs

TypeConverterAttribute PersistenceModeAttribute

Exceptions

InvalidOperationException

Le document est en cours de chargement.

Exemples

L’exemple de code suivant montre comment utiliser un XmlDataSource contrôle avec un contrôle avec un modèle pour afficher des données XML transformées Repeater . La feuille de style qui effectue la transformation est définie inline par la Transform propriété du contrôle de source de données.

Le fichier XML de l’exemple de code contient les données suivantes :

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

Remarques

Dans les scénarios déclaratifs, la Transform propriété est spécifiée en tant que propriété interne multiligne de l’objet XmlDataSource . Une propriété interne est compatible avec les données de feuille de style XSL, car elle vous permet de mettre en forme la feuille de style de quelque manière que ce soit et d’ignorer les problèmes de remplissage de caractères tels que les guillemets de remplissage.

Si les TransformFile propriétés et Transform sont définies, la TransformFile propriété est prioritaire et les données du fichier de feuille de style XSL (.xsl) sont utilisées à la place des éléments de feuille de style spécifiés dans la Transform propriété . Si une expression XPath est définie à l’aide de la XPath propriété , elle est appliquée après la transformation des données XML.

Si vous modifiez la valeur de la Transform propriété, l’événement DataSourceChanged est déclenché. Si la mise en cache est activée et que vous modifiez la valeur de Transform, le cache n’est pas valide.

Notes

La XmlDataSource classe utilise la classe dépréciée XslTransform pour effectuer des transformations XSL. Si vous souhaitez utiliser des fonctionnalités de feuille de style introduites après la dépréciation de la XslTransform classe, appliquez les transformations manuellement à l’aide de la XslCompiledTransform classe .

Voir aussi

• TransformFile
• CacheKeyDependency