Поделиться через


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

URI, возвращаемый методом ResolveUri(Uri, String).

role
String

В настоящее время не используется.

ofObjectToReturn
Type

Тип возвращаемого объекта. В текущей версии возвращаются только объекты System.IO.Stream.

Возвращаемое значение

Объект потока или значение null, если указан тип, отличающийся от потока.

Исключения

Параметр ofObjectToReturn не относится к типу Stream.

Заданный URI не является абсолютным.

absoluteUri имеет значение null.

Есть ошибка среды выполнения (например, разрыв подключения к серверу).

Примеры

См XmlUrlResolver.GetEntity . пример использования этого метода.

Комментарии

Этот метод используется, когда вызывающий объект хочет сопоставить заданный URI с объектом, содержащим фактический ресурс, который представляет URI. Тип возвращаемого объекта подлежит обсуждению; однако реализация всегда должна поддерживать System.IO.Stream.

Асинхронную версию этого метода см. в разделе GetEntityAsync.

Важно!

Приложение может устранить угрозы типа "отказ в обслуживании" в GetEntity памяти для метода путем реализации IStream , ограничивающего число считываемых байтов. Это помогает защититься от ситуаций, когда вредоносный код пытается передать в метод бесконечный GetEntity поток байтов.

Применяется к