XmlSecureResolver.GetEntity メソッド

.NET Framework クラス ライブラリ リファレンス

XmlSecureResolver.GetEntity メソッド

実際のリソースを含むオブジェクトに URI を安全に割り当てます。このメソッドは、基になる XmlResolver で GetEntity を呼び出す前に PermissionSet.PermitOnly を呼び出すことで、コンストラクタで作成された System.Security.PermissionSet を一時的に設定してリソースを開きます。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 GetEntity ( _
    absoluteUri As Uri, _
    role As String, _
    ofObjectToReturn As Type _
) As Object

Visual Basic (使用法)

Dim instance As XmlSecureResolver
Dim absoluteUri As Uri
Dim role As String
Dim ofObjectToReturn As Type
Dim returnValue As Object

returnValue = instance.GetEntity(absoluteUri, role, ofObjectToReturn)

C#

public override Object GetEntity (
    Uri absoluteUri,
    string role,
    Type ofObjectToReturn
)

C++

public:
virtual Object^ GetEntity (
    Uri^ absoluteUri, 
    String^ role, 
    Type^ ofObjectToReturn
) override

J#

public Object GetEntity (
    Uri absoluteUri, 
    String role, 
    Type ofObjectToReturn
)

JScript

public override function GetEntity (
    absoluteUri : Uri, 
    role : String, 
    ofObjectToReturn : Type
) : Object

パラメータ

absoluteUri

ResolveUri から返された URI。

role

現在のバージョンでは、URI を解決するときにこのパラメータを使用しません。このパラメータは、将来の拡張のために提供されています。たとえば、このパラメータを xlink:role に割り当て、別の場合に実装固有の引数として使用できます。

ofObjectToReturn

返すオブジェクトの型。現在のバージョンだけが、Stream オブジェクトを返します。

戻り値
基になる XmlResolver で GetEntity を呼び出すことによって返される Stream オブジェクト。ストリーム以外の型が指定された場合は null 参照 (Visual Basic では Nothing) が返されます。

例外

例外の種類	条件
XmlException	ofObjectToReturn が null 参照 (Visual Basic では Nothing) でも Stream 型でもありません。
UriFormatException	指定した URI が絶対 URI ではありません。
NullReferenceException	absoluteUri が null 参照 (Visual Basic では Nothing) です。
Exception	ランタイム エラー (サーバー接続の中断など) があります。

解説

セキュリティに関するメモ
GetEntity メソッドでは、メモリの飽和をねらった DoS 攻撃が懸念されます。ラッピング実装された IStream をアプリケーションで実装し、読み取るバイト数を制限することにより、このような脅威を緩和できます。これにより、膨大なバイト ストリームを GetEntity メソッドに渡すような悪質なコードに備えることができます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
XmlSecureResolver クラス
XmlSecureResolver メンバ
System.Xml 名前空間
その他の技術情報
セキュリティと System.Xml アプリケーション