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

Определение

Пространство имен:
System.Xml
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll
Исходный код:
XmlResolver.cs
Исходный код:
XmlResolver.cs
Исходный код:
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) не является абсолютным универсальным кодом ресурса (URI).

ArgumentNullException

absoluteUri равно null.

Exception

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

Примеры

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

Комментарии

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

Сведения об асинхронной версии этого метода см. в разделе GetEntityAsync.

Important

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

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