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.

중요

애플리케이션 메모리에 대 한 서비스 거부를 완화할 수는 GetEntity 메서드를 구현 하 여는 IStream 읽은 바이트 수를 제한 합니다. 이렇게 하면 악성 코드가 메서드에 무한 바이트 스트림을 전달하려고 시도하는 상황을 보호할 수 GetEntity 있습니다.