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

Определение

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

System.Xml.Resolvers

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

Сопоставляет код URI с объектом, содержащим фактический ресурс.

public:
 override System::Object ^ GetEntity(Uri ^ absoluteUri, System::String ^ role, Type ^ ofObjectToReturn);

public override object? GetEntity (Uri absoluteUri, string? role, Type? ofObjectToReturn);

public override object GetEntity (Uri absoluteUri, string role, Type ofObjectToReturn);

override this.GetEntity : Uri * string * Type -> obj

Public Overrides Function GetEntity (absoluteUri As Uri, role As String, ofObjectToReturn As Type) As Object

Параметры

absoluteUri

Uri

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

role

String

В текущей версии .NET Framework для Silverlight этот параметр не используется при распознавании URI. Этот параметр предоставлен с целью расширения возможностей в будущем. Например, этот параметр можно сопоставить роли xlink:role и использовать в качестве зависящего от реализации аргумента в других сценариях.

ofObjectToReturn

Type

Тип возвращаемого объекта. Распознаватель XmlPreloadedResolver поддерживает объекты Stream и объекты TextReader для кодов URI, добавленных в виде значений типа String. Если запрашиваемый тип не поддерживается распознавателем, создается исключение. Чтобы определить, поддерживается ли определенный тип Type распознавателем, воспользуйтесь методом SupportsType(Uri, Type).

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

Object

Объект Stream или TextReader, соответствующий фактическому источнику.

Исключения

ArgumentNullException

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

XmlException

Не удается разрешить URI, переданный в параметре absoluteUri.

-или- Параметр ofObjectToReturn не относится к поддерживаемому типу.

Комментарии

Сначала XmlPreloadedResolver попытается найти ресурс в хранилище предварительно загруженных данных. Если не удается найти его, он вызовет метод резервного GetEntity сопоставителя. Если в конструкторе XmlPreloadedResolver не был предоставлен резервный сопоставитель, создается исключение.