XmlResolver.GetEntity(Uri, String, Type) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
파생 클래스에서 재정의되는 경우 실제 리소스가 포함된 개체에 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 -> objPublic MustOverride Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As Object매개 변수
- absoluteUri
- Uri
에서 반환된 URI입니다 ResolveUri(Uri, String).
- role
- String
현재 사용하지 않습니다.
- ofObjectToReturn
- Type
반환할 개체의 형식입니다. 현재 버전은 System.IO.Stream 개체만 반환합니다.
반품
스트림 개체이거나 null 스트림 이외의 형식이 지정된 경우
예외
ofObjectToReturn가 형식이 아닌 경우 Stream
지정된 URI가 절대 URI가 아닙니다.
absoluteUri은 null입니다.
런타임 오류(예: 중단된 서버 연결)가 있습니다.
예제
이 메서드를 사용하는 예제를 참조 XmlUrlResolver.GetEntity 하세요.
설명
이 메서드는 호출자가 지정된 URI를 URI가 나타내는 실제 리소스를 포함하는 개체에 매핑하려는 경우에 사용됩니다. 반환된 개체의 형식은 협상할 수 있습니다. 그러나 구현은 항상 지원 System.IO.Stream해야 합니다.
이 메서드의 비동기 버전은 다음을 참조하세요 GetEntityAsync.
Important
애플리케이션은 읽은 바이트 수를 제한하는 GetEntity 구현을 통해 IStream 메서드에 대한 메모리 서비스 거부 위협을 완화할 수 있습니다. 이렇게 하면 악의적인 코드가 무한 바이트 스트림을 메서드에 전달하려고 하는 상황을 방지할 수 GetEntity 있습니다.
