次の方法で共有


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

定義

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

public:
 abstract System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);
public abstract object? GetEntity (Uri absoluteUri, 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 オブジェクトだけを返します。

戻り値

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

例外

ofObjectToReturnStream 型ではありません。

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

absoluteUrinullです。

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

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

注釈

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

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

重要

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

適用対象