XmlResolver.GetEntity(Uri, String, Type) メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

Source:

XmlResolver.cs

派生クラスでオーバーライドされると、URI を実際のリソースを格納しているオブジェクトに割り当てます。

public:
 abstract System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);

public abstract object? GetEntity (Uri absoluteUri, string? role, Type? ofObjectToReturn);

abstract member GetEntity : Uri * string * Type -> obj

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

パラメーター

absoluteUri

Uri

ResolveUri(Uri, String) から返された URI。

role

String

現在は使用されていません。

ofObjectToReturn

Type

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

戻り値

Object

ストリーム オブジェクト。ストリーム以外の型が指定された場合は null。

例外

XmlException

ofObjectToReturn が Stream 型ではありません。

UriFormatException

指定した URI が絶対 URI ではありません。

ArgumentNullException

absoluteUri が nullです。

Exception

実行時エラー (サーバー接続の中断など) があります。

例

このメソッドの使用例については、 を参照してください XmlUrlResolver.GetEntity 。

注釈

このメソッドは、呼び出し元が URI が表す実際のリソースを含むオブジェクトに特定の URI をマップする場合に使用されます。 返されるオブジェクトの型は否定可能です。ただし、実装では常に をサポート System.IO.Streamする必要があります。

このメソッドの非同期バージョンについては、「」を参照してください GetEntityAsync。

重要

アプリケーションでは、読み取ったバイト数を制限する を実装IStreamすることで、 メソッドに対GetEntityするメモリサービス拒否の脅威を軽減できます。 これは、悪意のあるコードが無限のバイト ストリームを メソッドに渡そうとする状況から GetEntity 保護するのに役立ちます。