XmlDataSource.Transform Właściwość

Odwołanie

Definicja

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

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Share via