XmlDataSource.Transform 속성

정의

네임스페이스:

System.Web.UI.WebControls

어셈블리:

System.Web.dll

XmlDataSource 컨트롤에서 관리하는 XML 데이터에 대해 수행될 XSLT 변환을 정의하는 XSL(Extensible Stylesheet Language) 데이터의 블록을 가져오거나 설정합니다.

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

문서를 로드하고 있는 경우

예제

다음 코드 예제에 사용 하는 방법을 보여 줍니다.는 XmlDataSource 템플릿 기반 컨트롤과 Repeater 컨트롤이 표시 하는 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 및 Transform 속성을 설정 합니다 TransformFile 속성이 우선 및 XSL 스타일 시트 파일 (.xsl)의 데이터에 지정 된 스타일 시트 요소 대신 사용 됩니다는 Transform 속성입니다. XPath 식을 사용 하 여 설정 된 경우는 XPath 속성을 XML 데이터를 변환한 후 적용 됩니다.

값을 변경 하는 경우는 Transform 속성을 DataSourceChanged 이벤트가 발생 합니다. 캐싱을 사용 하는 및의 값을 변경 하는 경우 Transform, 캐시를 무효화 합니다.

참고

합니다 XmlDataSource 클래스를 사용 하 여 사용 되지 않는 XslTransform XSL 변환을 수행 하는 클래스입니다. 이후 도입 된 스타일 시트 기능을 사용 하려는 경우는 XslTransform 클래스의 사용이 중단 되었으며, 사용 하 여 수동으로 변환을 적용 합니다 XslCompiledTransform 클래스입니다.

추가 정보

• TransformFile
• CacheKeyDependency