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


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

Параметры

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 новых символов строки.

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

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

Параметры

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

Комментарии

По умолчанию 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 новых символов строки.

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

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

Параметры

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 новых символов строки.

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

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, System::String ^ baseUri);
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);
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

Параметры

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 новых символов строк.

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

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

Параметры

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

Комментарии

Этот метод позволяет добавлять дополнительные функции в базовый 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 новых символов строк.

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

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, System::String ^ baseUri);
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);
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

Параметры

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 новых символов строк.

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

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

Параметры

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 новых символов строк.

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

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

Параметры

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 новых символов строк.

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

Create(String)

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

Создает новый экземпляр XmlReader с указанным 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

Параметры

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");
' Create the XmlReader object.
Dim reader As XmlReader = 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 новых символов строк.

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

Create(TextReader)

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

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

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

Параметры

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

Комментарии

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

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

Важно!

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

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

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

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

Create(Stream)

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

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

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

Параметры

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

Комментарии

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

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

Важно!

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

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

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

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

Create(String, XmlReaderSettings)

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

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

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

Параметры

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()) {}
' 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

Комментарии

По умолчанию 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 новых символов строк.

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