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 -> 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 не является абсолютным.
absoluteUri имеет значение null.
Есть ошибка среды выполнения (например, разрыв подключения к серверу).
Примеры
См XmlUrlResolver.GetEntity . пример использования этого метода.
Комментарии
Этот метод используется, когда вызывающий объект хочет сопоставить заданный URI с объектом, содержащим фактический ресурс, который представляет URI. Тип возвращаемого объекта подлежит обсуждению; однако реализация всегда должна поддерживать System.IO.Stream.
Асинхронную версию этого метода см. в разделе GetEntityAsync.
Важно!
Приложение может устранить угрозы типа "отказ в обслуживании" в GetEntity памяти для метода путем реализации IStream , ограничивающего число считываемых байтов. Это помогает защититься от ситуаций, когда вредоносный код пытается передать в метод бесконечный GetEntity поток байтов.
