XslTransform.Load メソッド (XmlReader, XmlResolver, Evidence)

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

XmlReader に含まれる XSLT スタイルシートを読み込みます。このメソッドを使用すると、証拠を指定することによって、スタイルシートのアクセス許可を制限できます。

Overloads Public Sub Load( _
   ByVal stylesheet As XmlReader, _   ByVal resolver As XmlResolver, _   ByVal evidence As Evidence _)
[C#]
public void Load(XmlReaderstylesheet,XmlResolverresolver,Evidenceevidence);
[C++]
public: void Load(XmlReader* stylesheet,XmlResolver* resolver,Evidence* evidence);
[JScript]
public function Load(
   stylesheet : XmlReader,resolver : XmlResolver,evidence : Evidence);

パラメータ

• stylesheet
  読み込むスタイルシートを格納している XmlReader オブジェクト。

• resolver
  xsl:import 要素および xsl:include 要素で参照される任意のスタイル シートを読み込むために使用される XmlResolver 。これが null 参照 (Visual Basic では Nothing) の場合は、外部リソースが解決されません。

  Load メソッドが完了した後、 XmlResolver がキャッシュされていません。

• evidence
  XSLT スタイルシート内のスクリプト ブロックに対して生成されたアセンブリに設定された System.Security.Policy.Evidence 。

  これが null 参照 (Visual Basic では Nothing) の場合、スクリプト ブロックは処理されません。また、XSLT の document() 関数はサポートされず、特権拡張機能オブジェクトは許可されません。

  呼び出し元には、スクリプト アセンブリの証拠を提供するための ControlEvidence アクセス許可が必要です。信頼度の低い呼び出し元は、このパラメータを null 参照 (Nothing) に設定できます。

例外

解説

XslTransform は、XSLT 1.0 構文をサポートしています。XSLT スタイル シートには、名前空間宣言 xmlns:xsl= http://www.w3.org/1999/XSL/Transform を含める必要があります。

このメソッドは、 xsl:include 要素および xsl:import 要素で参照される任意のスタイル シートを含む XSLT スタイル シートを読み込みます。スタイル シートは、 XmlReader の現在のノードから、すべての子を通じて読み込まれます。これにより、ドキュメントの一部をスタイル シートとして使用できます。

Load メソッドが返されると、 XmlReader は、スタイル シートの末尾の後の次のノードに配置されます。ドキュメントの末尾に達すると、 XmlReader は、ファイルの末尾 (EOF) に配置されます。

スタイル シートにエンティティが含まれている場合は、エンティティを解決できる XmlReader を指定する必要があります。 XmlReader.CanResolveEntity は true を返します。この場合は、 XmlValidatingReader を使用できます。

証拠を提供するにはさまざまな方法があります。一般的なユーザー シナリオに対してどの種類の証拠を提供するかを次の表に示します。

使用例

[Visual Basic, C#, C++] XSLT 変換を実行する例を次に示します。 xsltReader は、スタイルシートを含む XmlReader で、 secureURL は、 Evidence を作成するときに使用できる信頼された URL です。 XmlSecureResolver.CreateEvidenceForUrl メソッドは、スタイルシートに適用する Evidence を作成するときに使用します。

 

   public shared sub TransformFile (xsltReader as XmlReader, secureURL as String) 
    
    ' Load the stylesheet using a default XmlUrlResolver and Evidence 
    ' created using the trusted URL.
    Dim xslt as XslTransform = new XslTransform()
    xslt.Load(xsltReader, new XmlUrlResolver(), XmlSecureResolver.CreateEvidenceForUrl(secureURL))

    ' Transform the file.
    xslt.Transform("books.xml", "books.html", new XmlUrlResolver())
   end sub

[C#] 

   public static void TransformFile (XmlReader xsltReader, String secureURL) {
    
    // Load the stylesheet using a default XmlUrlResolver and Evidence 
    // created using the trusted URL.
    XslTransform xslt = new XslTransform();
    xslt.Load(xsltReader, new XmlUrlResolver(), XmlSecureResolver.CreateEvidenceForUrl(secureURL));

    // Transform the file.
    xslt.Transform("books.xml", "books.html", new XmlUrlResolver());
   } 

[C++] 

void TransformFile (XmlReader* xsltReader, String* secureURL) {

    // Load the stylesheet using a default XmlUrlResolver and Evidence 
    // created using the trusted URL.
    XslTransform* xslt = new XslTransform();
    xslt->Load(xsltReader, new XmlUrlResolver(), XmlSecureResolver::CreateEvidenceForUrl(secureURL));

    // Transform the file.
    xslt->Transform(S"books.xml", S"books.html", new XmlUrlResolver());
} 

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

• SecurityPermission (証拠を提供するために必要なパーミッション)。 SecurityPermissionFlag.ControlEvidence (関連する列挙体)

参照

XslTransform クラス | XslTransform メンバ | System.Xml.Xsl 名前空間 | XslTransform.Load オーバーロードの一覧 | XmlResolver.Credentials | NetworkCredential | CredentialCache | 証拠 | System.Security.SecurityZone | XmlSecureResolver | XmlSecureResolver.CreateEvidenceForUrl