XmlDataSource.Transform Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Obtient ou définit un bloc de données XSL (Extensible Stylesheet Language) qui définit une transformation XSLT à effectuer sur les données XML gérées par le XmlDataSource contrôle.

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

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

Attributs

TypeConverterAttribute PersistenceModeAttribute

Exceptions

InvalidOperationException

Le document est chargé.

Exemples

L’exemple de code suivant montre comment utiliser un XmlDataSource contrôle avec un contrôle modèle Repeater pour afficher des données XML transformées. 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 le remplissage des caractères de guillemets.

Si les propriétés et Transform les TransformFile propriétés sont définies, la TransformFile propriété est prioritaire et les données du fichier de feuille de style XSL (.xsl) sont utilisées au lieu 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 une fois les données XML transformées.

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 est invalidé.

Note

La XmlDataSource classe utilise la classe déconseillé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