Udostępnij za pośrednictwem


XmlDataSource.Transform Właściwość

Definicja

Pobiera lub ustawia blok danych języka XSL (Extensible Stylesheet Language), które definiują przekształcenie XSLT do wykonania na danych XML zarządzanych przez kontrolkę XmlDataSource .

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

Wartość właściwości

Ciąg wbudowanego kodu XSL definiujący przekształcenie XML, które ma być wykonywane na danych zawartych we właściwościach Data lub DataFile . Wartość domyślna to Empty.

Atrybuty

Wyjątki

Dokument jest ładowany.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać kontrolki XmlDataSource z kontrolką szablonu Repeater do wyświetlania przekształconych danych XML. Arkusz stylów, który wykonuje transformację, jest zdefiniowany w tekście przez Transform właściwość kontrolki źródła danych.

Plik XML w przykładzie kodu zawiera następujące dane:

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

Uwagi

W scenariuszach Transform deklaratywnych właściwość jest określana jako wielowierszowa właściwość wewnętrzna XmlDataSource obiektu. Właściwość wewnętrzna jest zgodna z danymi arkusza stylów XSL, ponieważ umożliwia formatowanie arkusza stylów w dowolny sposób i ignorowanie problemów z wypełnieniem znaków, takich jak znaki cudzysłowu.

Jeśli właściwości TransformFile i Transform są ustawione, TransformFile właściwość ma pierwszeństwo, a dane w pliku arkusza stylów XSL (.xsl) są używane zamiast elementów arkusza stylów określonych we Transform właściwości. Jeśli wyrażenie XPath jest ustawione przy użyciu XPath właściwości, jest stosowane po przekształceniu danych XML.

Jeśli zmienisz wartość Transform właściwości, DataSourceChanged zdarzenie zostanie podniesione. Jeśli buforowanie jest włączone i zmieniasz wartość Transform, pamięć podręczna zostanie unieważniona.

Uwaga

Klasa XmlDataSource używa przestarzałej XslTransform klasy do wykonywania przekształceń XSL. Jeśli chcesz użyć funkcji arkusza stylów, które zostały wprowadzone po XslTransform wycofaniu klasy, zastosuj przekształcenia ręcznie przy użyciu XslCompiledTransform klasy.

Dotyczy

Zobacz też