Udostępnij za pośrednictwem

XmlDataSource.Transform Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

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

String

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
TypeConverterAttribute PersistenceModeAttribute

Wyjątki

InvalidOperationException

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ż