XmlDataSource.Transform Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Ruft einen Block von XSL-Daten (Extensible Stylesheet Language) ab, der eine XSLT-Transformation definiert, die für die vom XmlDataSource-Steuerelement verwalteten XML-Daten durchgeführt werden soll, bzw. legt diesen Block fest.

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

Eigenschaftswert

String

Eine Zeichenfolge mit Inline-XSL, das eine XML-Transformation definiert, die für die in der Data-Eigenschaft oder DataFile-Eigenschaft enthaltenen Daten ausgeführt werden soll. Der Standardwert ist Empty.

Attribute

TypeConverterAttribute PersistenceModeAttribute

Ausnahmen

InvalidOperationException

Das Dokument wird geladen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein XmlDataSource Steuerelement mit einem Steuerelement mit Vorlagen Repeater verwenden, um transformierte XML-Daten anzuzeigen. Das Stylesheet, das die Transformation ausführt, wird inline durch die Transform -Eigenschaft des Datenquellensteuerelements definiert.

Die XML-Datei im Codebeispiel enthält die folgenden Daten:

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

Hinweise

In deklarativen Szenarien wird die Transform -Eigenschaft als mehrlinienige innere Eigenschaft des XmlDataSource -Objekts angegeben. Eine innere Eigenschaft ist mit XSL-Stylesheetdaten kompatibel, da sie es Ihnen ermöglicht, das Stylesheet in beliebiger Weise zu formatieren und Zeichenabstandsprobleme wie das Auffüllen von Anführungszeichen zu ignorieren.

Wenn sowohl die -Eigenschaft als auch die TransformFile -Eigenschaft festgelegt sind, hat die TransformFile -Eigenschaft Vorrang, und die Daten in der XSL-Stylesheetdatei (.xsl) werden anstelle der in der Transform -Eigenschaft angegebenen Stylesheetelemente Transform verwendet. Wenn ein XPath-Ausdruck mithilfe der XPath -Eigenschaft festgelegt wird, wird er angewendet, nachdem die XML-Daten transformiert wurden.

Wenn Sie den Wert der Transform -Eigenschaft ändern, wird das DataSourceChanged -Ereignis ausgelöst. Wenn die Zwischenspeicherung aktiviert ist und Sie den Wert von Transformändern, wird der Cache ungültig.

Hinweis

Die XmlDataSource -Klasse verwendet die veraltete XslTransform Klasse, um XSL-Transformationen auszuführen. Wenn Sie Stylesheetfeatures verwenden möchten, die eingeführt wurden, nachdem die XslTransform Klasse veraltet ist, wenden Sie die Transformationen manuell mithilfe der XslCompiledTransform -Klasse an.

Weitere Informationen

• TransformFile
• CacheKeyDependency