XmlDataSource.Transform プロパティ

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.dll

XmlDataSource コントロールで管理されている XML データに対して実行される XSLT 変換を定義する拡張スタイルシート言語 (XSL) データのブロックを取得または設定します。

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

プロパティ値

String

Data プロパティまたは DataFile プロパティのデータに対して実行される XML 変換を定義したインライン XSL 文字列。 既定値は Empty です。

属性

TypeConverterAttribute PersistenceModeAttribute

例外

InvalidOperationException

ドキュメントが読み込まれています。

例

次のコード例では、テンプレート化されたRepeaterコントロールでコントロールをXmlDataSource使用して、変換された XML データを表示する方法を示します。 変換を実行するスタイル シートは、データ ソース コントロールの プロパティによって Transform インラインで定義されます。

コード例の XML ファイルには、次のデータがあります。

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

注釈

宣言型のシナリオでは、 Transform プロパティは オブジェクトの複数行の XmlDataSource 内部プロパティとして指定されます。 内部プロパティは XSL スタイル シート データと互換性があります。これは、スタイル シートを任意の方法で書式設定し、引用符文字の埋め込みなどの文字埋め込みの問題を無視できるためです。

プロパティと プロパティのTransformFile両方が設定されている場合は、 TransformFile プロパティが優先され、 プロパティで指定されたスタイル シート要素の代わりに XSL スタイル シート ファイル (.xsl) のデータがTransform使用Transformされます。 XPath 式が プロパティを使用して XPath 設定されている場合は、XML データの変換後に適用されます。

プロパティの Transform 値を変更すると、イベントが発生します DataSourceChanged 。 キャッシュが有効になっており、 の Transform値を変更すると、キャッシュは無効になります。

Note

クラスは XmlDataSource 、非推奨 XslTransform のクラスを使用して XSL 変換を実行します。 クラスが非推奨になった後に導入されたスタイル シート機能を XslTransform 使用する場合は、 クラスを使用して変換を XslCompiledTransform 手動で適用します。

こちらもご覧ください

• TransformFile
• CacheKeyDependency