XmlReader.Create Метод

Определение

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

Сборки:: netstandard.dll, System.Xml.ReaderWriter.dll

Сборка:: System.Xml.ReaderWriter.dll

Сборка:: System.Xml.dll

Сборка:: netstandard.dll

Сборки:: System.Xml.dll, System.Xml.ReaderWriter.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Create(String, XmlReaderSettings, XmlParserContext)

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

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

Исходный код:: 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.

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

XmlReader

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

Исключения

ArgumentNullException

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

SecurityException

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

ArgumentException

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

FileNotFoundException

Не удается найти файл, указанный URI.

UriFormatException

Формат универсального кода ресурса (URI) не является правильным.

Начиная с .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.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

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

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

XmlReader

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

Исключения

ArgumentNullException

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

ArgumentException

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)

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

Это важно

Для управления доступом к ресурсам XmlReader можно использовать один из следующих методов:

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

–или–

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

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

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

Create(Stream, XmlReaderSettings, XmlParserContext)

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

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

Исходный код:: 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

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

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

XmlReader

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

Исключения

ArgumentNullException

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

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

Create(Stream, XmlReaderSettings, String)

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

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

Исходный код:: 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-данные.

settings: XmlReaderSettings

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

baseUri: String

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

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

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

XmlReader

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

Исключения

ArgumentNullException

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

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

Create(XmlReader, XmlReaderSettings)

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

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

Исходный код:: 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

Объект, который упакован вокруг указанного XmlReader объекта.

Исключения

ArgumentNullException

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

InvalidOperationException

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

Это важно

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

Это важно

Для управления доступом к ресурсам XmlReader можно использовать один из следующих методов:

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

–или–

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

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

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

Create(TextReader, XmlReaderSettings, String)

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

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

Исходный код:: 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

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

XmlReader

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

Исключения

ArgumentNullException

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

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

Create(TextReader, XmlReaderSettings)

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

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

Исходный код:: 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

settings: XmlReaderSettings

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

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

XmlReader

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

Исключения

ArgumentNullException

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

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

Create(Stream, XmlReaderSettings)

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

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

Исходный код:: 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-данные.

settings: XmlReaderSettings

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

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

XmlReader

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

Исключения

ArgumentNullException

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

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

Create(String)

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

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

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

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

XmlReader

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

Исключения

ArgumentNullException

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

SecurityException

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

FileNotFoundException

Файл, идентифицированный URI, не существует.

UriFormatException

Формат универсального кода ресурса (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), сущности, схемы и т. д.

Это важно

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

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

Create(TextReader)

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

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

Исходный код:: 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

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

XmlReader

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

Исключения

ArgumentNullException

Значение 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))

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

Create(Stream)

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

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

Исходный код:: 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-данных в потоке.

Исключения

ArgumentNullException

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

SecurityException

У 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

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

Create(String, XmlReaderSettings)

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

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

Исходный код:: 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

settings: XmlReaderSettings

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

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

XmlReader

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

Исключения

ArgumentNullException

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

FileNotFoundException

Не удается найти файл, указанный URI.

UriFormatException

Формат универсального кода ресурса (URI) не является правильным.

Примеры

В следующем примере создается 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

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

Обратная связь

Были ли сведения на этой странице полезными?

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

XmlReader.Create Метод

Определение

Перегрузки

Комментарии

Create(String, XmlReaderSettings, XmlParserContext)

Параметры

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

Исключения

Комментарии

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

Create(TextReader, XmlReaderSettings, XmlParserContext)

Параметры

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

Исключения

Примеры

Комментарии

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

Create(Stream, XmlReaderSettings, XmlParserContext)

Параметры

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

Исключения

Комментарии

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

Create(Stream, XmlReaderSettings, String)

Параметры

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

Исключения

Комментарии

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

Create(XmlReader, XmlReaderSettings)

Параметры

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

Исключения

Примеры

Комментарии

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

Create(TextReader, XmlReaderSettings, String)

Параметры

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

Исключения

Комментарии

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

Create(TextReader, XmlReaderSettings)

Параметры

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

Исключения

Комментарии

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

Create(Stream, XmlReaderSettings)

Параметры

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

Исключения

Комментарии

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

Create(String)

Параметры

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

Исключения

Примеры

Комментарии

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

Create(TextReader)

Параметры

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

Исключения

Примеры

Комментарии

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

Create(Stream)

Параметры

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

Исключения

Примеры

Комментарии

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

Create(String, XmlReaderSettings)

Параметры

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

Исключения