XmlResolver.GetEntity(Uri, String, Type) Метод

Ссылка

Определение

Пространство имен:: System.Xml

Сборка:: System.Xml.ReaderWriter.dll

Сборка:: System.Xml.dll

Сборка:: netstandard.dll

Исходный код:: XmlResolver.cs

Исходный код:: XmlResolver.cs

Исходный код:: 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);

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.

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

Object

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

Исключения

XmlException

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

UriFormatException

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

ArgumentNullException

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

Exception

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

Примеры

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

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

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

Важно!

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

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

Share via