Прочитать на английском

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


XmlReader.Create Метод

Определение

Создает новый экземпляр XmlReader.

Перегрузки

Create(String, XmlReaderSettings, XmlParserContext)

Создает новый экземпляр XmlReader с помощью указанного URI, параметров и сведений о контексте для анализа.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Создает новый экземпляр XmlReader с использованием указанного средства чтения текста, параметров и сведений о контексте для анализа.

Create(Stream, XmlReaderSettings, XmlParserContext)

Создает новый экземпляр XmlReader, используя заданный поток, параметры и контекстную информацию для анализа.

Create(Stream, XmlReaderSettings, String)

Создает новый экземпляр XmlReader с использованием указанного потока, базового URI и параметров.

Create(XmlReader, XmlReaderSettings)

Создает новый экземпляр XmlReader, используя заданное средство чтения XML и параметры.

Create(TextReader, XmlReaderSettings, String)

Создает экземпляр XmlReader с использованием указанного средства чтения текста, параметров и базового кода URI.

Create(TextReader, XmlReaderSettings)

Создает новый экземпляр XmlReader с использованием указанного модуля чтения текста и параметров.

Create(Stream, XmlReaderSettings)

Создает экземпляр XmlReader с указанными потоком и параметрами.

Create(String)

Создает новый экземпляр XmlReader с указанным URI.

Create(TextReader)

Создает экземпляр XmlReader с использованием указанного средства чтения текста.

Create(Stream)

Создает новый экземпляр XmlReader, используя заданный поток с параметрами по умолчанию.

Create(String, XmlReaderSettings)

Создает новый экземпляр XmlReader с использованием указанного URI и параметров.

Комментарии

Дополнительные сведения об этом API см. в разделе Дополнительные примечания API для XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

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

Создает новый экземпляр XmlReader с помощью указанного URI, параметров и сведений о контексте для анализа.

public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);

Параметры

inputUri
String

URI файла с XML-данными. Объект XmlResolver в объекте XmlReaderSettings используется для преобразования пути в каноническое представление данных. Если XmlResolver равно null, используется новый объект XmlUrlResolver.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader. Это значение может быть равно null.

inputContext
XmlParserContext

Для синтаксического анализа фрагмента XML необходимы контекстные сведения. Контекстные сведения могут содержать используемый класс XmlNameTable, кодировку, область пространства имен, текущий xml:lang, область xml:space, базовый URI и описание типа документов.

Это значение может быть равно null.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение inputUri равно null.

Тип XmlReader не имеет достаточных разрешений для доступа к расположению XML-данных.

Свойства NameTable и NameTable содержат значения. (Только для одного из этих свойств NameTable можно задать значение и использовать это свойство).

Не удается найти файл, заданный с помощью URI.

Неправильный формат URI.

Комментарии

По умолчанию XmlUrlResolver объект без учетных данных используется для доступа к любым внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Это означает, что объект XmlReader может получить доступ к любым расположениям, не требующим проверки подлинности. Если внешний ресурс находится в сетевом ресурсе, который требует проверки подлинности, используйте XmlReaderSettings.XmlResolver свойство , чтобы указать XmlResolver с необходимыми учетными данными.

Важно!

Вы можете ограничить ресурсы, к которым XmlReader может получить доступ , задав XmlResolver для свойства XmlSecureResolver значение объекта .

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строки.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Create(TextReader, XmlReaderSettings, XmlParserContext)

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

Создает новый экземпляр XmlReader с использованием указанного средства чтения текста, параметров и сведений о контексте для анализа.

public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

Параметры

input
TextReader

Средство считывания текста, из которого следует считывать данные XML. Средство считывания текста возвращает поток символов Юникода, и указанная в объявлении XML кодировка не используется средством считывания XML для раскодирования потока данных.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader. Это значение может быть равно null.

inputContext
XmlParserContext

Для синтаксического анализа фрагмента XML необходимы контекстные сведения. Контекстные сведения могут содержать используемый класс XmlNameTable, кодировку, область пространства имен, текущий xml:lang, область xml:space, базовый URI и описание типа документов.

Это значение может быть равно null.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение input равно null.

Свойства NameTable и NameTable содержат значения. (Можно задать и использовать только одно из этих NameTable свойств.)

Примеры

В следующем примере создается XmlReader объект , который считывает ФРАГМЕНТ XML.

string xmlFrag ="<item rk:ID='abc-23'>hammer</item> " +
                        "<item rk:ID='r2-435'>paint</item>" +
                        "<item rk:ID='abc-39'>saw</item>";

// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");

// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context);

Комментарии

По умолчанию XmlUrlResolver объект без учетных данных используется для доступа к любым внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, который требует проверки подлинности, используйте XmlReaderSettings.XmlResolver свойство , чтобы указать XmlResolver с необходимыми учетными данными.

Важно!

Вы можете использовать один из следующих методов для управления ресурсами XmlReader , к которым может получить доступ.

  • Ограничить ресурсы, к которым имеет доступ XmlReader, установив в качестве значения свойства XmlResolver объект XmlSecureResolver.

-или-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строки.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Create(Stream, XmlReaderSettings, XmlParserContext)

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

Создает новый экземпляр XmlReader, используя заданный поток, параметры и контекстную информацию для анализа.

public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings, System.Xml.XmlParserContext inputContext);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings, System.Xml.XmlParserContext? inputContext);

Параметры

input
Stream

Поток, содержащий XML-данные.

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

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader. Это значение может быть равно null.

inputContext
XmlParserContext

Для синтаксического анализа фрагмента XML необходимы контекстные сведения. Контекстные сведения могут содержать используемый класс XmlNameTable, кодировку, область пространства имен, текущий xml:lang, область xml:space, базовый URI и описание типа документов.

Это значение может быть равно null.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение input равно null.

Комментарии

По умолчанию XmlUrlResolver объект без учетных данных используется для доступа к любым внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, который требует проверки подлинности, используйте XmlReaderSettings.XmlResolver свойство , чтобы указать XmlResolver с необходимыми учетными данными.

Важно!

Вы можете использовать один из следующих методов для управления ресурсами XmlReader , к которым может получить доступ.

  • Ограничить ресурсы, к которым имеет доступ XmlReader, установив в качестве значения свойства XmlResolver объект XmlSecureResolver.

-или-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строки.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Create(Stream, XmlReaderSettings, String)

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

Создает новый экземпляр XmlReader с использованием указанного потока, базового URI и параметров.

public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings, string? baseUri);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings, string baseUri);

Параметры

input
Stream

Поток, содержащий XML-данные.

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

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader. Это значение может быть равно null.

baseUri
String

Базовый URI считываемой сущности или документа. Это значение может быть равно null.

Примечание по безопасности. Базовый универсальный код ресурса (URI) используется для разрешения относительного URI XML-документа. Не используйте базовый URI из непроверенного источника.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение input равно null.

Комментарии

По умолчанию XmlUrlResolver объект без учетных данных используется для доступа к любым внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, который требует проверки подлинности, используйте XmlReaderSettings.XmlResolver свойство , чтобы указать XmlResolver с необходимыми учетными данными.

Важно!

Вы можете использовать один из следующих методов для управления ресурсами XmlReader , к которым может получить доступ.

  • Ограничить ресурсы, к которым имеет доступ XmlReader, установив в качестве значения свойства XmlResolver объект XmlSecureResolver.

-или-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строк.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Create(XmlReader, XmlReaderSettings)

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

Создает новый экземпляр XmlReader, используя заданное средство чтения XML и параметры.

public static System.Xml.XmlReader Create (System.Xml.XmlReader reader, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (System.Xml.XmlReader reader, System.Xml.XmlReaderSettings? settings);

Параметры

reader
XmlReader

Объект, который следует использовать в качестве базового средства чтения XML.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader.

Уровень согласованности объекта XmlReaderSettings должен быть равным уровню согласованности базового средства чтения или иметь значение Auto.

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

Объект, являющийся оболочкой для объекта XmlReader.

Исключения

Значение reader равно null.

Если объект XmlReaderSettings задает уровень согласованности, который не соответствует уровню согласованности базового средства чтения.

-или-

Базовый XmlReader находится в состоянии Error или Closed.

Примеры

В следующем примере создается проверяющий XmlReader объект, заключенный в оболочку объекта XmlNodeReader .

// Create the XmlNodeReader object.
XmlDocument doc = new XmlDocument();
doc.Load("books.xml");
XmlNodeReader nodeReader = new XmlNodeReader(doc);

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:bookstore-schema", "books.xsd");
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

// Create a validating reader that wraps the XmlNodeReader object.
XmlReader reader = XmlReader.Create(nodeReader, settings);
// Parse the XML file.
while (reader.Read());

Комментарии

Этот метод позволяет добавлять дополнительные функции в базовый XmlReader объект. Базовый XmlReader объект может быть другим XmlReader объектом, созданным методом Create , или объектом, созданным XmlReader с помощью одной из конкретных XmlReader реализаций.

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

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, требуемом XmlResolver проверки подлинности, укажите с необходимыми учетными данными XmlReaderSettings.XmlResolver с помощью свойства .

Важно!

Вы можете использовать один из следующих методов для управления ресурсами XmlReader , к которым может получить доступ.

  • Ограничить ресурсы, к которым имеет доступ XmlReader, установив в качестве значения свойства XmlResolver объект XmlSecureResolver.

-или-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строк.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Create(TextReader, XmlReaderSettings, String)

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

Создает экземпляр XmlReader с использованием указанного средства чтения текста, параметров и базового кода URI.

public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings, string? baseUri);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings, string baseUri);

Параметры

input
TextReader

Средство считывания текста, из которого следует считывать данные XML. Средство считывания текста возвращает поток символов Юникода, и указанная в объявлении XML кодировка не используется XmlReader для декодирования потока данных.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader. Это значение может быть равно null.

baseUri
String

Базовый URI считываемой сущности или документа. Это значение может быть равно null.

Примечание по безопасности. Базовый универсальный код ресурса (URI) используется для разрешения относительного URI XML-документа. Не используйте базовый URI из непроверенного источника.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение input равно null.

Комментарии

По умолчанию XmlUrlResolver объект без учетных данных используется для доступа к любым внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, который требует проверки подлинности, используйте XmlReaderSettings.XmlResolver свойство , чтобы указать XmlResolver с необходимыми учетными данными.

Важно!

Вы можете использовать один из следующих методов для управления ресурсами XmlReader , к которым может получить доступ.

  • Ограничить ресурсы, к которым имеет доступ XmlReader, установив в качестве значения свойства XmlResolver объект XmlSecureResolver.

-или-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строк.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Create(TextReader, XmlReaderSettings)

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

Создает новый экземпляр XmlReader с использованием указанного модуля чтения текста и параметров.

public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings? settings);

Параметры

input
TextReader

Средство считывания текста, из которого следует считывать данные XML. Средство считывания текста возвращает поток символов Юникода, и указанная в объявлении XML кодировка не используется средством считывания XML для раскодирования потока данных.

settings
XmlReaderSettings

Параметры для нового XmlReader. Это значение может быть равно null.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение input равно null.

Комментарии

По умолчанию XmlUrlResolver объект без учетных данных используется для доступа к любым внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, который требует проверки подлинности, используйте XmlReaderSettings.XmlResolver свойство , чтобы указать XmlResolver с необходимыми учетными данными.

Важно!

Вы можете использовать один из следующих методов для управления ресурсами XmlReader , к которым может получить доступ.

  • Ограничить ресурсы, к которым имеет доступ XmlReader, установив в качестве значения свойства XmlResolver объект XmlSecureResolver.

-или-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строк.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Create(Stream, XmlReaderSettings)

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

Создает экземпляр XmlReader с указанными потоком и параметрами.

public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings? settings);

Параметры

input
Stream

Поток, содержащий XML-данные.

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

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader. Это значение может быть равно null.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение input равно null.

Комментарии

По умолчанию XmlUrlResolver объект без учетных данных используется для доступа к любым внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, который требует проверки подлинности, используйте XmlReaderSettings.XmlResolver свойство , чтобы указать XmlResolver с необходимыми учетными данными.

Важно!

Вы можете использовать один из следующих методов для управления ресурсами XmlReader , к которым может получить доступ.

  • Ограничить ресурсы, к которым имеет доступ XmlReader, установив в качестве значения свойства XmlResolver объект XmlSecureResolver.

-или-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строк.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Create(String)

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

Создает новый экземпляр XmlReader с указанным URI.

public static System.Xml.XmlReader Create (string inputUri);

Параметры

inputUri
String

URI файла с XML-данными. Класс XmlUrlResolver используется для преобразования пути к классическому представлению данных.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение inputUri равно null.

Тип XmlReader не имеет достаточных разрешений для доступа к расположению XML-данных.

Файл, указанный в URI, не существует.

Неправильный формат URI.

Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов перехватите исключение FormatExceptionбазового класса , .

Примеры

В следующем примере создается XmlReader объект , который считывает XML-файл данных, указанный в URI.

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("books.xml");

Комментарии

Для XmlReaderSettings создания средства чтения используется объект с параметрами по умолчанию. Если вы хотите указать функции, которые будут поддерживаться в созданном средстве чтения, используйте перегрузку XmlReaderSettings , которая принимает объект в XmlReaderSettings качестве одного из своих аргументов, и передайте объект с правильными параметрами.

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

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, требуемом XmlResolver проверки подлинности, укажите с необходимыми учетными данными XmlReaderSettings.XmlResolver с помощью свойства .

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строк.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Create(TextReader)

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

Создает экземпляр XmlReader с использованием указанного средства чтения текста.

public static System.Xml.XmlReader Create (System.IO.TextReader input);

Параметры

input
TextReader

Средство считывания текста, из которого следует считывать данные XML. Средство считывания текста возвращает поток символов Юникода, и указанная в объявлении XML кодировка не используется средством считывания XML для раскодирования потока данных.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение input равно null.

Примеры

В следующем примере класс используется для StringReader чтения XML-строки.

string xmlData ="<item productID='124390'>" +
                        "<price>5.95</price>" +
                        "</item>";

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(new StringReader(xmlData));

Комментарии

Для XmlReaderSettings создания средства чтения используется объект с параметрами по умолчанию. Если вы хотите указать функции, которые будут поддерживаться в созданном средстве чтения, используйте перегрузку XmlReaderSettings , которая принимает объект в XmlReaderSettings качестве одного из своих аргументов, и передайте объект с правильными параметрами.

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

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, требуемом XmlResolver проверки подлинности, укажите с необходимыми учетными данными XmlReaderSettings.XmlResolver с помощью свойства .

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строк.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Create(Stream)

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

Создает новый экземпляр XmlReader, используя заданный поток с параметрами по умолчанию.

public static System.Xml.XmlReader Create (System.IO.Stream input);

Параметры

input
Stream

Поток, содержащий XML-данные.

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

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение input равно null.

Тип XmlReader не имеет достаточных разрешений для доступа к расположению XML-данных.

Примеры

В следующем примере создается XmlReader объект , который считывает данные из FileStream.


FileStream fs = new FileStream(@"C:\data\books.xml", FileMode.OpenOrCreate,
                                                                    FileAccess.Read, FileShare.Read);

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(fs);

Комментарии

Для XmlReaderSettings создания средства чтения используется объект с параметрами по умолчанию. Если вы хотите указать функции, которые будут поддерживаться в созданном средстве чтения, используйте перегрузку XmlReaderSettings , которая принимает объект в XmlReaderSettings качестве одного из своих аргументов, и передайте объект с правильными параметрами.

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

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Если внешний ресурс находится в сетевом ресурсе, требуемом XmlResolver проверки подлинности, укажите с необходимыми учетными данными XmlReaderSettings.XmlResolver с помощью свойства .

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строк.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Create(String, XmlReaderSettings)

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

Создает новый экземпляр XmlReader с использованием указанного URI и параметров.

public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings settings);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings? settings);

Параметры

inputUri
String

URI файла с XML-данными. Объект XmlResolver в объекте XmlReaderSettings используется для преобразования пути в каноническое представление данных. Если XmlResolver равно null, используется новый объект XmlUrlResolver.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader. Это значение может быть равно null.

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

Объект, используемый для чтения данных XML в потоке.

Исключения

Значение inputUri равно null.

Не удается найти файл, заданный с помощью URI.

Неправильный формат URI.

Примечание. Вместо этого в .NET для приложений Магазина Windows или переносимой библиотеке классов перехватите исключение FormatExceptionбазового класса , .

Примеры

В следующем примере создается объект, поддерживающий XmlReader проверку определения типа документа (DTD).

// Set the validation settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.DtdProcessing = DtdProcessing.Parse;
settings.ValidationType = ValidationType.DTD;
settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

 // Create the XmlReader object.
XmlReader reader = XmlReader.Create("itemDTD.xml", settings);

// Parse the file.
while (reader.Read()) {}

Комментарии

По умолчанию XmlUrlResolver объект без учетных данных используется для доступа к любым внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.

Важно!

Начиная с .NET Framework 4.5.2, по умолчанию XmlUrlResolver не предоставляется. Если ваше решение предназначено для .NET Framework 4.5.2 или более поздних версий XmlResolver , укажите с помощью XmlReaderSettings.XmlResolver свойства .

Это означает, что XmlReader может получить доступ к любым расположениям, не требующим проверки подлинности. Если внешний ресурс находится в сетевом ресурсе, который требует проверки подлинности, используйте XmlReaderSettings.XmlResolver свойство , чтобы указать XmlResolver с необходимыми учетными данными.

Важно!

Вы можете ограничить ресурсы, к которым XmlReader может получить доступ , задав XmlResolver для свойства значение объекта XmlSecureResolver .

Созданный XmlReader объект расширяет ссылки на сущности и выполняет нормализацию XML новых символов строк.

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0