XmlReader.Create Method

Definition

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

Overloads

Create(String, XmlReaderSettings, XmlParserContext)

Создает новый экземпляр XmlReader с помощью указанного URI, параметров и сведений о контексте для анализа.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Создает новый экземпляр XmlReader с использованием указанного средства чтения текста, параметров и сведений о контексте для анализа.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, XmlParserContext)

Создает новый экземпляр XmlReader, используя заданный поток, параметры и контекстную информацию для анализа.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, String)

Создает новый экземпляр XmlReader с использованием указанного потока, базового URI и параметров.Creates a new XmlReader instance using the specified stream, base URI, and settings.

Create(XmlReader, XmlReaderSettings)

Создает новый экземпляр XmlReader, используя заданное средство чтения XML и параметры.Creates a new XmlReader instance by using the specified XML reader and settings.

Create(TextReader, XmlReaderSettings, String)

Создает экземпляр XmlReader с использованием указанного средства чтения текста, параметров и базового кода URI.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

Create(TextReader, XmlReaderSettings)

Создает новый экземпляр XmlReader с использованием указанного модуля чтения текста и параметров.Creates a new XmlReader instance by using the specified text reader and settings.

Create(Stream, XmlReaderSettings)

Создает экземпляр XmlReader с указанными потоком и параметрами.Creates a new XmlReader instance with the specified stream and settings.

Create(String)

Создает новый экземпляр XmlReader с указанным URI.Creates a new XmlReader instance with specified URI.

Create(TextReader)

Создает экземпляр XmlReader с использованием указанного средства чтения текста.Creates a new XmlReader instance by using the specified text reader.

Create(Stream)

Создает новый экземпляр XmlReader, используя заданный поток с параметрами по умолчанию.Creates a new XmlReader instance using the specified stream with default settings.

Create(String, XmlReaderSettings)

Создает новый экземпляр XmlReader с использованием указанного URI и параметров.Creates a new XmlReader instance by using the specified URI and settings.

Examples

В этом примере создается модуль чтения XML, который удаляет незначащие пробелы, пробельные комментарии и выполняет проверку соответствия на уровне фрагментов.This example creates an XML reader that strips insignificant white space, strips comments, and performs fragment-level conformance checking.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.IgnoreWhitespace = true;
settings.IgnoreComments = true;
XmlReader reader = XmlReader.Create("books.xml", settings);

Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.IgnoreWhitespace = true
settings.IgnoreComments = true
Dim reader As XmlReader = XmlReader.Create("books.xml", settings)

В следующем примере используется XmlUrlResolver с учетными данными по умолчанию для доступа к файлу.The following example uses an XmlUrlResolver with default credentials to access a file.

// Set the reader settings.
XmlReaderSettings^ settings = gcnew XmlReaderSettings;
settings->IgnoreComments = true;
settings->IgnoreProcessingInstructions = true;
settings->IgnoreWhitespace = true;

// Set the reader settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true;
settings.IgnoreProcessingInstructions = true;
settings.IgnoreWhitespace = true;
' Set the reader settings.
Dim settings as XmlReaderSettings = new XmlReaderSettings()
settings.IgnoreComments = true
settings.IgnoreProcessingInstructions = true
settings.IgnoreWhitespace = true
// Create a resolver with default credentials.
XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
resolver->Credentials = System::Net::CredentialCache::DefaultCredentials;

 // Set the reader settings object to use the resolver.
 settings->XmlResolver = resolver;

// Create the XmlReader object.
XmlReader^ reader = XmlReader::Create( L"http://ServerName/data/books.xml", settings );

// Create a resolver with default credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Set the reader settings object to use the resolver.
settings.XmlResolver = resolver;

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("http://ServerName/data/books.xml", settings);
' Create a resolver with default credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials

' Set the reader settings object to use the resolver.
settings.XmlResolver = resolver

' Create the XmlReader object.
Dim reader as XmlReader = XmlReader.Create("http://ServerName/data/books.xml", settings)

Следующий код создает оболочку для экземпляра модуля чтения в другом модуле чтения.The following code wraps a reader instance within another reader.

XmlTextReader txtReader = new XmlTextReader("bookOrder.xml");
XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("urn:po-schema", "PO.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader reader = XmlReader.Create(txtReader, settings);

Dim txtReader As XmlTextReader = New XmlTextReader("bookOrder.xml")
Dim settings As New XmlReaderSettings()
settings.Schemas.Add("urn:po-schema", "PO.xsd")
settings.ValidationType = ValidationType.Schema
Dim reader As XmlReader = XmlReader.Create(txtReader, settings)

В этом примере читатели привязывает средства чтения для добавления проверки DTD и схемы XML.This example chains readers to add DTD and XML schema validation.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.DTD;
XmlReader inner = XmlReader.Create("book.xml", settings); // DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader outer = XmlReader.Create(inner, settings);  // XML Schema Validation
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.DTD
Dim inner As XmlReader = XmlReader.Create("book.xml", settings) ' DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd")
settings.ValidationType = ValidationType.Schema
Dim outer As XmlReader = XmlReader.Create(inner, settings)  ' XML Schema Validation

Remarks

Большая часть Create перегрузок включает параметр settings, который принимает объект XmlReaderSettings.Most of the Create overloads include a settings parameter that accepts an XmlReaderSettings object. Этот объект можно использовать для следующих действий:You can use this object to:

  • Укажите, какие функции должны поддерживаться для объекта XmlReader.Specify which features you want supported on the XmlReader object.

  • Повторное использование объекта XmlReaderSettings для создания нескольких модулей чтения.Reuse the XmlReaderSettings object to create multiple readers. Можно использовать те же настройки для создания нескольких объектов средства чтения с одинаковой функциональностью.You can use the same settings to create multiple readers with the same functionality. Или можно изменить параметры на экземпляре XmlReaderSettings и создать новое средство чтения с другим набором компонентов.Or, you can modify the settings on an XmlReaderSettings instance and create a new reader with a different set of features.

  • Добавление компонентов к существующему модулю чтения XML.Add features to an existing XML reader. Метод Create может принимать другой объект XmlReader.The Create method can accept another XmlReader object. Базовым объектом XmlReader может быть определяемый пользователем модуль чтения, объект XmlTextReader или другой экземпляр XmlReader, к которому требуется добавить дополнительные функции.The underlying XmlReader object can be a user-defined reader, a XmlTextReader object, or another XmlReader instance that you want to add additional features to.

  • Воспользуйтесь всеми преимуществами таких функций, как улучшенная проверка соответствия и соответствие рекомендациям для XML 1,0 (четвертого выпуска) , которые доступны только для XmlReader объектов, созданных статическим методом Create.Take full advantage of features such as better conformance checking and compliance to the XML 1.0 (fourth edition) recommendation that are available only on XmlReader objects created by the static Create method.

Note

Хотя .NET Framework включает конкретные реализации класса XmlReader, такие как XmlTextReader, XmlNodeReaderи классы XmlValidatingReader, рекомендуется создавать экземпляры XmlReader с помощью метода Create.Although the .NET Framework includes concrete implementations of the XmlReader class, such as the XmlTextReader, XmlNodeReader, and the XmlValidatingReader classes, we recommend that you create XmlReader instances by using the Create method.

Параметры по умолчаниюDefault settings

При использовании перегрузки Create, которая не принимает объект XmlReaderSettings, используются следующие параметры модуля чтения по умолчанию:If you use a Create overload that doesn't accept a XmlReaderSettings object, the following default reader settings are used:

ПараметрSetting По умолчаниюDefault
CheckCharacters true
ConformanceLevel ConformanceLevel.Document
IgnoreComments false
IgnoreProcessingInstructions false
IgnoreWhitespace false
LineNumberOffset 00
LinePositionOffset 00
NameTable null
DtdProcessing Prohibit
Schemas Пустой объект XmlSchemaSetAn empty XmlSchemaSet object
ValidationFlags ProcessIdentityConstraints включеноProcessIdentityConstraints enabled
ValidationType None
XmlResolver Новый объект XmlUrlResolver.A new XmlUrlResolver object. Начиная с .NET Framework 4.5.2, этот параметр имеет значение по умолчанию null.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Параметры для распространенных сценариевSettings for common scenarios

Ниже приведены свойства XmlReaderSettings, которые следует задать для некоторых типовых сценариев средства чтения XML.Here are the XmlReaderSettings properties you should set for some of the typical XML reader scenarios.

ТребованиеRequirement Присвойте параметруSet
Данные должны представлять собой XML-документ правильного формата.Data must be a well-formed XML document. ConformanceLevel Document.ConformanceLevel to Document.
Данные должны быть правильно сформированными XML-проанализированными сущностями.Data must be a well-formed XML parsed entity. ConformanceLevel Fragment.ConformanceLevel to Fragment.
Данные должны быть проверены по DTD.Data must be validated against a DTD. Запустите командлет DtdProcessing для установки по пути Parse.DtdProcessing to Parse
ValidationType DTD.ValidationType to DTD.
Данные должны быть проверены по схеме XML.Data must be validated against an XML schema. Запустите командлет ValidationType для установки по пути Schema.ValidationType to Schema
Schemas XmlSchemaSet, используемый для проверки.Schemas to the XmlSchemaSet to use for validation. Обратите внимание, что XmlReader не поддерживает проверку схемы XML-Data Reduceed (XDR).Note that XmlReader doesn't support XML-Data Reduced (XDR) schema validation.
Данные должны быть проверены по встроенной схеме XML.Data must be validated against an inline XML schema. Запустите командлет ValidationType для установки по пути Schema.ValidationType to Schema
ValidationFlags ProcessInlineSchema.ValidationFlags to ProcessInlineSchema.
Поддержка типов.Type support. Запустите командлет ValidationType для установки по пути Schema.ValidationType to Schema
Schemas XmlSchemaSet для использования.Schemas to the XmlSchemaSet to use.

XmlReader не поддерживает проверку схемы XML-Data Reduceed (XDR).XmlReader doesn't support XML-Data Reduced (XDR) schema validation.

Асинхронное программированиеAsynchronous programming

В синхронном режиме метод Create считывает первый фрагмент данных из буфера чтения файла, потока или средства считывания текста.In synchronous mode, the Create method reads the first chunk of data from the buffer of the file, stream, or text reader. Это может вызвать исключение в случае сбоя операции ввода-вывода.This may throw an exception if an I/O operation fails. В асинхронном режиме первая операция ввода-вывода выполняется с операцией чтения, поэтому возникающие исключения будут выдаваться при выполнении операции чтения.In asynchronous mode, the first I/O operation occurs with a read operation, so exceptions that arise will be thrown when the read operation occurs.

Вопросы безопасностиSecurity considerations

По умолчанию XmlReader использует объект XmlUrlResolver без учетных данных пользователя для открытия ресурсов.By default, the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. Это означает, что по умолчанию модуль чтения XML может получить доступ к любому расположению, которое не требует учетных данных.This means that, by default, the XML reader can access any location that doesn't require credentials. Используйте свойство XmlResolver для управления доступом к ресурсам.Use the XmlResolver property to control access to resources:

  • Задайте XmlResolver объекту XmlSecureResolver, чтобы ограничить ресурсы, к которым может обращаться модуль чтения XML.Set XmlResolver to an XmlSecureResolver object to restrict the resources that the XML reader can access.

-или--or-

  • Задайте для параметра XmlResolver значение null, чтобы модуль чтения XML не открывал какие-либо внешние ресурсы.Set XmlResolver to null to prevent the XML reader from opening any external resources.

Create(String, XmlReaderSettings, XmlParserContext)

Создает новый экземпляр XmlReader с помощью указанного URI, параметров и сведений о контексте для анализа.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

public:
 static System::Xml::XmlReader ^ Create(System::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);
static member Create : string * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parameters

inputUri
String

URI файла с XML-данными.The URI for the file containing the XML data. Объект XmlResolver в объекте XmlReaderSettings используется для преобразования пути в каноническое представление данных.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Если XmlResolver равно null, используется новый объект XmlUrlResolver.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader.The settings for the new XmlReader instance. Это значение может быть равно null.This value can be null.

inputContext
XmlParserContext

Для синтаксического анализа фрагмента XML необходимы контекстные сведения.The context information required to parse the XML fragment. Контекстные сведения могут содержать используемый класс XmlNameTable, кодировку, область пространства имен, текущие области xml:lang и xml:space, базовый код URI и определение типа документа.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

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

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Тип XmlReader не имеет достаточных разрешений для доступа к расположению XML-данных.The XmlReader does not have sufficient permissions to access the location of the XML data.

Значения присвоены как свойству NameTable, так и свойству NameTable.The NameTable and NameTable properties both contain values. (Можно задать и использовать только для одного из этих свойств NameTable).(Only one of these NameTable properties can be set and used).

Не удается найти файл, заданный с помощью URI.The file specified by the URI cannot be found.

Неправильный формат URI.The URI format is not correct.

Remarks

По умолчанию XmlUrlResolver без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Это означает, что XmlReader может получить доступ к любому расположению, которое не требует проверки подлинности.This means that the XmlReader can access any locations that does not require authentication. Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, используйте свойство XmlReaderSettings.XmlResolver, чтобы указать XmlResolver с необходимыми учетными данными.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Important

Можно ограничить ресурсы, к которым может получить доступ XmlReader, задав для свойства XmlResolver объект XmlSecureResolver.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Создает новый экземпляр XmlReader с использованием указанного средства чтения текста, параметров и сведений о контексте для анализа.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

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);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parameters

input
TextReader

Средство считывания текста, из которого следует считывать данные XML.The text reader from which to read the XML data. Средство считывания текста возвращает поток символов Юникода, и указанная в объявлении XML кодировка не используется средством считывания XML для раскодирования потока данных.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader.The settings for the new XmlReader instance. Это значение может быть равно null.This value can be null.

inputContext
XmlParserContext

Для синтаксического анализа фрагмента XML необходимы контекстные сведения.The context information required to parse the XML fragment. Контекстные сведения могут содержать используемый класс XmlNameTable, кодировку, область пространства имен, текущие области xml:lang и xml:space, базовый код URI и определение типа документа.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

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

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Значения присвоены как свойству NameTable, так и свойству NameTable.The NameTable and NameTable properties both contain values. (Можно задать и использовать только для одного из этих свойств NameTable).(Only one of these NameTable properties can be set and used).

Examples

В следующем примере создается объект XmlReader, который считывает фрагмент XML.The following example creates an XmlReader object that reads an XML fragment.

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);

Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
                                     "<item rk:ID='r2-435'>paint</item>" & _
                                     "<item rk:ID='abc-39'>saw</item>"

' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")

' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)

' Create the reader. 
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)

Remarks

По умолчанию XmlUrlResolver без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, используйте свойство XmlReaderSettings.XmlResolver, чтобы указать XmlResolver с необходимыми учетными данными.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Important

Для управления ресурсами, к которым XmlReader может быть доступ, можно использовать один из следующих методов.You can use one of the following methods to control which resources the XmlReader can access:

-или--or-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, XmlParserContext)

Создает новый экземпляр XmlReader, используя заданный поток, параметры и контекстную информацию для анализа.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

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);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * System.Xml.XmlParserContext -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Parameters

input
Stream

Поток, содержащий XML-данные.The stream that contains the XML data.

XmlReader просматривает первые байты потока в поисках метки порядка следования байтов или другого признака кодировки.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Эта кодировка после определения используется в последующем считывании потока, а процедура обработки продолжает анализировать входные данные как поток символов Юникода.When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader.The settings for the new XmlReader instance. Это значение может быть равно null.This value can be null.

inputContext
XmlParserContext

Для синтаксического анализа фрагмента XML необходимы контекстные сведения.The context information required to parse the XML fragment. Контекстные сведения могут содержать используемый класс XmlNameTable, кодировку, область пространства имен, текущие области xml:lang и xml:space, базовый код URI и определение типа документа.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

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

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Remarks

По умолчанию XmlUrlResolver без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, используйте свойство XmlReaderSettings.XmlResolver, чтобы указать XmlResolver с необходимыми учетными данными.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Important

Для управления ресурсами, к которым XmlReader может быть доступ, можно использовать один из следующих методов.You can use one of the following methods to control which resources the XmlReader can access:

-или--or-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, String)

Создает новый экземпляр XmlReader с использованием указанного потока, базового URI и параметров.Creates a new XmlReader instance using the specified stream, base URI, and settings.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);
public static System.Xml.XmlReader Create (System.IO.Stream input, System.Xml.XmlReaderSettings settings, string baseUri);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parameters

input
Stream

Поток, содержащий XML-данные.The stream that contains the XML data.

XmlReader просматривает первые байты потока в поисках метки порядка следования байтов или другого признака кодировки.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Эта кодировка после определения используется в последующем считывании потока, а процедура обработки продолжает анализировать входные данные как поток символов Юникода.When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader.The settings for the new XmlReader instance. Это значение может быть равно null.This value can be null.

baseUri
String

Базовый URI считываемой сущности или документа.The base URI for the entity or document being read. Это значение может быть равно null.This value can be null.

Примечание по безопасности. Базовый универсальный код ресурса (URI) используется для разрешения относительного URI XML-документа.Security Note The base URI is used to resolve the relative URI of the XML document. Не используйте базовый URI из непроверенного источника.Do not use a base URI from an untrusted source.

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Remarks

По умолчанию XmlUrlResolver без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, используйте свойство XmlReaderSettings.XmlResolver, чтобы указать XmlResolver с необходимыми учетными данными.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Important

Для управления ресурсами, к которым XmlReader может быть доступ, можно использовать один из следующих методов.You can use one of the following methods to control which resources the XmlReader can access:

-или--or-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(XmlReader, XmlReaderSettings)

Создает новый экземпляр XmlReader, используя заданное средство чтения XML и параметры.Creates a new XmlReader instance by using the specified XML reader and settings.

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);
static member Create : System.Xml.XmlReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReader

Parameters

reader
XmlReader

Объект, который следует использовать в качестве базового средства чтения XML.The object that you want to use as the underlying XML reader.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader.The settings for the new XmlReader instance.

Уровень согласованности объекта XmlReaderSettings должен быть равным уровню согласованности базового средства чтения или иметь значение Auto.The conformance level of the XmlReaderSettings object must either match the conformance level of the underlying reader, or it must be set to Auto.

Returns

XmlReader

Объект, являющийся оболочкой для объекта XmlReader.An object that is wrapped around the specified XmlReader object.

Exceptions

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

Если объект XmlReaderSettings задает уровень согласованности, который не соответствует уровню согласованности базового средства чтения.If the XmlReaderSettings object specifies a conformance level that is not consistent with conformance level of the underlying reader.

-или--or- Базовый XmlReader находится в состоянии Error или Closed.The underlying XmlReader is in an Error or Closed state.

Examples

В следующем примере создается объект проверки XmlReader, упакованный вокруг объекта XmlNodeReader.The following example creates a validating XmlReader object that is wrapped around an XmlNodeReader object.

// 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());

' Create the XmlNodeReader object.
Dim doc As New XmlDocument()
doc.Load("books.xml")
Dim nodeReader As New XmlNodeReader(doc)

' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:bookstore-schema", "books.xsd")
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create a validating reader that wraps the XmlNodeReader object.
Dim reader As XmlReader = XmlReader.Create(nodeReader, settings)
' Parse the XML file.
While reader.Read()
End While

Remarks

Этот метод позволяет добавлять дополнительные функции к базовому объекту XmlReader.This method allows you add additional features to an underlying XmlReader object. Базовый объект XmlReader может быть другим XmlReaderным объектом, созданным методом Create, или объектом XmlReader, созданным с помощью одной из реализаций конкретного XmlReader.The underlying XmlReader object can be another XmlReader object created by the Create method, or an XmlReader object created using one of the concrete XmlReader implementations.

Для доступа ко всем внешним ресурсам, таким как схема, используется XmlUrlResolver по умолчанию без учетных данных.A default XmlUrlResolver with no credentials is used to access any external resources such as a schema.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, укажите XmlResolver с необходимыми учетными данными, используя свойство XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Important

Для управления ресурсами, к которым XmlReader может быть доступ, можно использовать один из следующих методов.You can use one of the following methods to control which resources the XmlReader can access:

-или--or-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, String)

Создает экземпляр XmlReader с использованием указанного средства чтения текста, параметров и базового кода URI.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input, System::Xml::XmlReaderSettings ^ settings, System::String ^ baseUri);
public static System.Xml.XmlReader Create (System.IO.TextReader input, System.Xml.XmlReaderSettings settings, string baseUri);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings * string -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReader

Parameters

input
TextReader

Средство считывания текста, из которого следует считывать данные XML.The text reader from which to read the XML data. Средство считывания текста возвращает поток символов Юникода, и указанная в объявлении XML кодировка не используется XmlReader для декодирования потока данных.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XmlReader to decode the data stream.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader.The settings for the new XmlReader instance. Это значение может быть равно null.This value can be null.

baseUri
String

Базовый URI считываемой сущности или документа.The base URI for the entity or document being read. Это значение может быть равно null.This value can be null.

Примечание по безопасности. Базовый универсальный код ресурса (URI) используется для разрешения относительного URI XML-документа.Security Note The base URI is used to resolve the relative URI of the XML document. Не используйте базовый URI из непроверенного источника.Do not use a base URI from an untrusted source.

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Remarks

По умолчанию XmlUrlResolver без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, используйте свойство XmlReaderSettings.XmlResolver, чтобы указать XmlResolver с необходимыми учетными данными.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Important

Для управления ресурсами, к которым XmlReader может быть доступ, можно использовать один из следующих методов.You can use one of the following methods to control which resources the XmlReader can access:

-или--or-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings)

Создает новый экземпляр XmlReader с использованием указанного модуля чтения текста и параметров.Creates a new XmlReader instance by using the specified text reader and settings.

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);
static member Create : System.IO.TextReader * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReader

Parameters

input
TextReader

Средство считывания текста, из которого следует считывать данные XML.The text reader from which to read the XML data. Средство считывания текста возвращает поток символов Юникода, и указанная в объявлении XML кодировка не используется средством считывания XML для раскодирования потока данных.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings

Параметры для нового XmlReader.The settings for the new XmlReader. Это значение может быть равно null.This value can be null.

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Remarks

По умолчанию XmlUrlResolver без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, используйте свойство XmlReaderSettings.XmlResolver, чтобы указать XmlResolver с необходимыми учетными данными.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Important

Для управления ресурсами, к которым XmlReader может быть доступ, можно использовать один из следующих методов.You can use one of the following methods to control which resources the XmlReader can access:

-или--or-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings)

Создает экземпляр XmlReader с указанными потоком и параметрами.Creates a new XmlReader instance with the specified stream and settings.

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);
static member Create : System.IO.Stream * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReader

Parameters

input
Stream

Поток, содержащий XML-данные.The stream that contains the XML data.

XmlReader просматривает первые байты потока в поисках метки порядка следования байтов или другого признака кодировки.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Эта кодировка после определения используется в последующем считывании потока, а процедура обработки продолжает анализировать входные данные как поток символов Юникода.When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader.The settings for the new XmlReader instance. Это значение может быть равно null.This value can be null.

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Remarks

По умолчанию XmlUrlResolver без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, используйте свойство XmlReaderSettings.XmlResolver, чтобы указать XmlResolver с необходимыми учетными данными.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Important

Для управления ресурсами, к которым XmlReader может быть доступ, можно использовать один из следующих методов.You can use one of the following methods to control which resources the XmlReader can access:

-или--or-

  • Не разрешать XmlReader открывать какие-либо внешние ресурсы, установив для свойства XmlResolver значение null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String)

Создает новый экземпляр XmlReader с указанным URI.Creates a new XmlReader instance with specified URI.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri);
public static System.Xml.XmlReader Create (string inputUri);
static member Create : string -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String) As XmlReader

Parameters

inputUri
String

URI файла с XML-данными.The URI for the file that contains the XML data. Класс XmlUrlResolver используется для преобразования пути к классическому представлению данных.The XmlUrlResolver class is used to convert the path to a canonical data representation.

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Тип XmlReader не имеет достаточных разрешений для доступа к расположению XML-данных.The XmlReader does not have sufficient permissions to access the location of the XML data.

Файл, указанный в URI, не существует.The file identified by the URI does not exist.

Вместо этого в .NET для приложений Магазина Windows или в переносимой библиотеке классов перехватите исключение базового класса FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Неправильный формат URI.The URI format is not correct.

Examples

В следующем примере создается объект XmlReader, который считывает файл данных XML, заданный с помощью URI.The following example creates an XmlReader object that reads XML data file specified by the URI.

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

Remarks

Для создания модуля чтения используется объект XmlReaderSettings с параметрами по умолчанию.An XmlReaderSettings object with default settings is used to create the reader. Если вы хотите указать функции для поддержки в созданном модуле чтения, используйте перегрузку, которая принимает объект XmlReaderSettings как один из своих аргументов, и передает объект XmlReaderSettings с правильными параметрами.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

XmlUrlResolver по умолчанию без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, укажите XmlResolver с необходимыми учетными данными, используя свойство XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader)

Создает экземпляр XmlReader с использованием указанного средства чтения текста.Creates a new XmlReader instance by using the specified text reader.

public:
 static System::Xml::XmlReader ^ Create(System::IO::TextReader ^ input);
public static System.Xml.XmlReader Create (System.IO.TextReader input);
static member Create : System.IO.TextReader -> System.Xml.XmlReader
Public Shared Function Create (input As TextReader) As XmlReader

Parameters

input
TextReader

Средство считывания текста, из которого следует считывать данные XML.The text reader from which to read the XML data. Средство считывания текста возвращает поток символов Юникода, и указанная в объявлении XML кодировка не используется средством считывания XML для раскодирования потока данных.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration is not used by the XML reader to decode the data stream.

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Examples

В следующем примере класс StringReader используется для чтения XML-строки.The following example uses the StringReader class to read an XML string.

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

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(new StringReader(xmlData));
Dim xmlData As String = "<item productID='124390'>" & _ 
                                     "<price>5.95</price>" & _ 
                                     "</item>"

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlData))

Remarks

Для создания модуля чтения используется объект XmlReaderSettings с параметрами по умолчанию.An XmlReaderSettings object with default settings is used to create the reader. Если вы хотите указать функции для поддержки в созданном модуле чтения, используйте перегрузку, которая принимает объект XmlReaderSettings как один из своих аргументов, и передает объект XmlReaderSettings с правильными параметрами.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

XmlUrlResolver по умолчанию без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, укажите XmlResolver с необходимыми учетными данными, используя свойство XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream)

Создает новый экземпляр XmlReader, используя заданный поток с параметрами по умолчанию.Creates a new XmlReader instance using the specified stream with default settings.

public:
 static System::Xml::XmlReader ^ Create(System::IO::Stream ^ input);
public static System.Xml.XmlReader Create (System.IO.Stream input);
static member Create : System.IO.Stream -> System.Xml.XmlReader
Public Shared Function Create (input As Stream) As XmlReader

Parameters

input
Stream

Поток, содержащий XML-данные.The stream that contains the XML data.

XmlReader просматривает первые байты потока в поисках метки порядка следования байтов или другого признака кодировки.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Эта кодировка после определения используется в последующем считывании потока, а процедура обработки продолжает анализировать входные данные как поток символов Юникода.When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Тип XmlReader не имеет достаточных разрешений для доступа к расположению XML-данных.The XmlReader does not have sufficient permissions to access the location of the XML data.

Examples

В следующем примере создается объект XmlReader, который считывает из FileStream.The following example creates an XmlReader object that reads from a FileStream.


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

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(fs);
    Dim fs As New FileStream("C:\data\books.xml", FileMode.OpenOrCreate, FileAccess.Read, FileShare.Read)
    
    ' Create the XmlReader object.
    Dim reader As XmlReader = XmlReader.Create(fs)

End Sub

Remarks

Для создания модуля чтения используется объект XmlReaderSettings с параметрами по умолчанию.An XmlReaderSettings object with default settings is used to create the reader. Если вы хотите указать функции для поддержки в созданном модуле чтения, используйте перегрузку, которая принимает объект XmlReaderSettings как один из своих аргументов, и передает объект XmlReaderSettings с правильными параметрами.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

XmlUrlResolver по умолчанию без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, укажите XmlResolver с необходимыми учетными данными, используя свойство XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String, XmlReaderSettings)

Создает новый экземпляр XmlReader с использованием указанного URI и параметров.Creates a new XmlReader instance by using the specified URI and settings.

public:
 static System::Xml::XmlReader ^ Create(System::String ^ inputUri, System::Xml::XmlReaderSettings ^ settings);
public static System.Xml.XmlReader Create (string inputUri, System.Xml.XmlReaderSettings settings);
static member Create : string * System.Xml.XmlReaderSettings -> System.Xml.XmlReader
Public Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReader

Parameters

inputUri
String

URI файла с XML-данными.The URI for the file containing the XML data. Объект XmlResolver в объекте XmlReaderSettings используется для преобразования пути в каноническое представление данных.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Если XmlResolver равно null, используется новый объект XmlUrlResolver.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

Параметры нового экземпляра XmlReader.The settings for the new XmlReader instance. Это значение может быть равно null.This value can be null.

Returns

XmlReader

Объект, используемый для чтения данных XML в потоке.An object that is used to read the XML data in the stream.

Exceptions

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

Не удается найти файл, заданный с помощью URI.The file specified by the URI cannot be found.

Вместо этого в .NET для приложений Магазина Windows или в переносимой библиотеке классов перехватите исключение базового класса FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Неправильный формат URI.The URI format is not correct.

Examples

В следующем примере создается объект XmlReader, поддерживающий проверку определения типа документа (DTD).The following example creates an XmlReader object that supports document type definition (DTD) validation.

// 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()) {}
' Set the validation settings.
Dim settings As New XmlReaderSettings()
settings.DtdProcessing = DtdProcessing.Parse
settings.ValidationType = ValidationType.DTD
AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("itemDTD.xml", settings)

' Parse the file. 
While reader.Read()
End While

Remarks

По умолчанию XmlUrlResolver без учетных данных используется для доступа ко всем внешним ресурсам, таким как определение типа документа (DTD), сущности, схемы и т. д.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Important

Начиная с .NET Framework 4.5.2, XmlUrlResolver по умолчанию не предоставляется.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Если решение предназначено для .NET Framework 4.5.2 или более поздних версий, укажите XmlResolver с помощью свойства XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Это означает, что XmlReader может получить доступ к любому расположению, которое не требует проверки подлинности.This means that the XmlReader can access any locations that does not require authentication. Если внешний ресурс находится в сетевом ресурсе, требующем проверки подлинности, используйте свойство XmlReaderSettings.XmlResolver, чтобы указать XmlResolver с необходимыми учетными данными.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Important

Можно ограничить ресурсы, к которым может получить доступ XmlReader, задав для свойства XmlResolver объект XmlSecureResolver.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

Созданный объект XmlReader расширяет ссылки на сущности и выполняет нормализацию XML символов новой строки.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Applies to