XmlReader.Create Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Tworzy nowe wystąpienie klasy XmlReader.

Przeciążenia

Create(String, XmlReaderSettings, XmlParserContext)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego identyfikatora URI, ustawień i informacji kontekstowych na potrzeby analizowania.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu, ustawień i informacji kontekstowych na potrzeby analizowania.
Create(Stream, XmlReaderSettings, XmlParserContext)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia, ustawień i informacji kontekstowych na potrzeby analizowania.
Create(Stream, XmlReaderSettings, String)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia, podstawowego identyfikatora URI i ustawień.
Create(XmlReader, XmlReaderSettings)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika i ustawień XML.
Create(TextReader, XmlReaderSettings, String)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu, ustawień i podstawowego identyfikatora URI.
Create(TextReader, XmlReaderSettings)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu i ustawień.
Create(Stream, XmlReaderSettings)	Tworzy nowe XmlReader wystąpienie z określonym strumieniem i ustawieniami.
Create(String)	Tworzy nowe XmlReader wystąpienie z określonym identyfikatorem URI.
Create(TextReader)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu.
Create(Stream)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia z ustawieniami domyślnymi.
Create(String, XmlReaderSettings)	Tworzy nowe XmlReader wystąpienie przy użyciu określonego identyfikatora URI i ustawień.

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Uwagi dotyczące dodatkowego interfejsu API dla elementu XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego identyfikatora URI, ustawień i informacji kontekstowych na potrzeby analizowania.

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

Parametry

inputUri: String

Identyfikator URI pliku zawierającego dane XML. Obiekt XmlResolver w XmlReaderSettings obiekcie służy do konwertowania ścieżki na reprezentację danych kanonicznych. Jeśli XmlResolver parametr ma nullwartość , zostanie użyty nowy XmlUrlResolver obiekt.

settings: XmlReaderSettings

Ustawienia dla nowego XmlReader wystąpienia. Ta wartość może mieć wartość null.

inputContext: XmlParserContext

Informacje kontekstowe wymagane do analizowania fragmentu XML. Informacje kontekstowe mogą obejmować XmlNameTable użycie, kodowanie, zakres przestrzeni nazw, bieżący xml:lang i xml:space zakres, podstawowy identyfikator URI i definicję typu dokumentu.

Ta wartość może mieć wartość null.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu inputUri to null.

SecurityException

Element XmlReader nie ma wystarczających uprawnień dostępu do lokalizacji danych XML.

ArgumentException

Właściwości NameTable i NameTable zawierają wartości. (Można ustawić i użyć tylko jednej z tych NameTable właściwości).

FileNotFoundException

Nie można odnaleźć pliku określonego przez identyfikator URI.

UriFormatException

Format identyfikatora URI jest niepoprawny.

Uwagi

Domyślnie element XmlUrlResolver bez poświadczeń jest używany do uzyskiwania dostępu do dowolnych zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od .NET Framework 4.5.2, nie podano wartości domyślnejXmlUrlResolver. Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość przy użyciu XmlReaderSettings.XmlResolver właściwości .

Oznacza to, że program XmlReader może uzyskiwać dostęp do dowolnych lokalizacji, które nie wymagają uwierzytelniania. Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Możesz ograniczyć zasoby, do których XmlReader może uzyskiwać dostęp, ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(TextReader, XmlReaderSettings, XmlParserContext)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu, ustawień i informacji kontekstowych na potrzeby analizowania.

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

Parametry

input: TextReader

Czytnik tekstu, z którego mają być odczytywane dane XML. Czytnik tekstu zwraca strumień znaków Unicode, więc kodowanie określone w deklaracji XML nie jest używane przez czytnik XML do dekodowania strumienia danych.

settings: XmlReaderSettings

Ustawienia dla nowego XmlReader wystąpienia. Ta wartość może mieć wartość null.

inputContext: XmlParserContext

Ta wartość może mieć wartość null.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

ArgumentException

Właściwości NameTable i NameTable zawierają wartości. (Można ustawić i użyć tylko jednej z tych NameTable właściwości).

Przykłady

Poniższy przykład tworzy XmlReader obiekt, który odczytuje fragment 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)

Uwagi

Domyślnie element XmlUrlResolver bez poświadczeń jest używany do uzyskiwania dostępu do dowolnych zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Za pomocą jednej z następujących metod można kontrolować, do których zasobów XmlReader może uzyskiwać dostęp:

Ogranicz zasoby, do których XmlReader może uzyskiwać dostęp, ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

-lub-

Nie zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(Stream, XmlReaderSettings, XmlParserContext)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia, ustawień i informacji kontekstowych na potrzeby analizowania.

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

Parametry

input: Stream

Strumień zawierający dane XML.

Skanowanie XmlReader pierwszych bajtów strumienia w poszukiwaniu znaku kolejności bajtów lub innego znaku kodowania. Po określeniu kodowania kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).

settings: XmlReaderSettings

Ustawienia dla nowego XmlReader wystąpienia. Ta wartość może mieć wartość null.

inputContext: XmlParserContext

Ta wartość może mieć wartość null.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie element XmlUrlResolver bez poświadczeń jest używany do uzyskiwania dostępu do dowolnych zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Za pomocą jednej z następujących metod można kontrolować, do których zasobów XmlReader może uzyskiwać dostęp:

Ogranicz zasoby, do których XmlReader może uzyskiwać dostęp, ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

-lub-

Nie zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(Stream, XmlReaderSettings, String)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia, podstawowego identyfikatora URI i ustawień.

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

Parametry

input: Stream

Strumień zawierający dane XML.

settings: XmlReaderSettings

Ustawienia dla nowego XmlReader wystąpienia. Ta wartość może mieć wartość null.

baseUri: String

Podstawowy identyfikator URI dla odczytywanej jednostki lub dokumentu. Ta wartość może mieć wartość null.

Uwaga dotycząca zabezpieczeń Podstawowy identyfikator URI służy do rozpoznawania względnego identyfikatora URI dokumentu XML. Nie używaj podstawowego identyfikatora URI z niezaufanego źródła.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie element XmlUrlResolver bez poświadczeń jest używany do uzyskiwania dostępu do dowolnych zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Za pomocą jednej z następujących metod można kontrolować, do których zasobów XmlReader może uzyskiwać dostęp:

Ogranicz zasoby, do których XmlReader może uzyskiwać dostęp, ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

-lub-

Nie zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(XmlReader, XmlReaderSettings)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika i ustawień 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

Parametry

reader: XmlReader

Obiekt, którego chcesz użyć jako podstawowego czytnika XML.

settings: XmlReaderSettings

Ustawienia dla nowego XmlReader wystąpienia.

Poziom XmlReaderSettings zgodności obiektu musi być zgodny z poziomem zgodności bazowego czytnika lub musi być ustawiony na Autowartość .

Zwraca

XmlReader

Obiekt, który jest owinięty wokół określonego XmlReader obiektu.

Wyjątki

ArgumentNullException

Wartość elementu reader to null.

InvalidOperationException

XmlReaderSettings Jeśli obiekt określa poziom zgodności, który nie jest zgodny z poziomem zgodności podstawowego czytnika.

-lub-

Element bazowy XmlReader znajduje się w Error stanie lub Closed .

Przykłady

Poniższy przykład tworzy obiekt sprawdzania poprawności XmlReader , który jest owinięty wokół XmlNodeReader obiektu.

// 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

Uwagi

Ta metoda umożliwia dodawanie dodatkowych funkcji do obiektu bazowego XmlReader . Obiekt źródłowy XmlReader może być innym XmlReader obiektem utworzonym przez metodę Create lub obiektem utworzonym XmlReader przy użyciu jednej z konkretnych XmlReader implementacji.

Ustawienie domyślne XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do dowolnych zasobów zewnętrznych, takich jak schemat.

Ważne

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, określ element XmlResolver z wymaganymi poświadczeniami przy użyciu XmlReaderSettings.XmlResolver właściwości .

Ważne

Za pomocą jednej z następujących metod można kontrolować, do których zasobów XmlReader może uzyskiwać dostęp:

Ogranicz zasoby, do których XmlReader może uzyskiwać dostęp, ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

-lub-

Nie zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(TextReader, XmlReaderSettings, String)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu, ustawień i podstawowego identyfikatora 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

Parametry

input: TextReader

Czytnik tekstu, z którego mają być odczytywane dane XML. Czytnik tekstu zwraca strumień znaków Unicode, więc kodowanie określone w deklaracji XML nie jest używane przez XmlReader element do dekodowania strumienia danych.

settings: XmlReaderSettings

Ustawienia dla nowego XmlReader wystąpienia. Ta wartość może mieć wartość null.

baseUri: String

Podstawowy identyfikator URI dla odczytywanej jednostki lub dokumentu. Ta wartość może mieć wartość null.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie element XmlUrlResolver bez poświadczeń jest używany do uzyskiwania dostępu do dowolnych zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Za pomocą jednej z następujących metod można kontrolować, do których zasobów XmlReader może uzyskiwać dostęp:

Ogranicz zasoby, do których XmlReader może uzyskiwać dostęp, ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

-lub-

Nie zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(TextReader, XmlReaderSettings)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu i ustawień.

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

Parametry

input: TextReader

settings: XmlReaderSettings

Ustawienia dla nowego XmlReaderelementu . Ta wartość może mieć wartość null.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie element XmlUrlResolver bez poświadczeń jest używany do uzyskiwania dostępu do dowolnych zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Za pomocą jednej z następujących metod można kontrolować, do których zasobów XmlReader może uzyskiwać dostęp:

Ogranicz zasoby, do których XmlReader może uzyskiwać dostęp, ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

-lub-

Nie zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(Stream, XmlReaderSettings)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie z określonym strumieniem i ustawieniami.

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

Parametry

input: Stream

Strumień zawierający dane XML.

settings: XmlReaderSettings

Ustawienia dla nowego XmlReader wystąpienia. Ta wartość może mieć wartość null.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie element XmlUrlResolver bez poświadczeń jest używany do uzyskiwania dostępu do dowolnych zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Za pomocą jednej z następujących metod można kontrolować, do których zasobów XmlReader może uzyskiwać dostęp:

Ogranicz zasoby, do których XmlReader może uzyskiwać dostęp, ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

-lub-

Nie zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(String)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie z określonym identyfikatorem 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

Parametry

inputUri: String

Identyfikator URI pliku, który zawiera dane XML. Klasa XmlUrlResolver służy do konwertowania ścieżki na reprezentację danych kanonicznych.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu inputUri to null.

SecurityException

Element XmlReader nie ma wystarczających uprawnień dostępu do lokalizacji danych XML.

FileNotFoundException

Plik zidentyfikowany przez identyfikator URI nie istnieje.

UriFormatException

Format identyfikatora URI nie jest poprawny.

Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klas przechwyć wyjątek klasy bazowej , FormatExceptionzamiast tego.

Przykłady

Poniższy przykład tworzy XmlReader obiekt, który odczytuje plik danych XML określony przez identyfikator URI.

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

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

Uwagi

Obiekt XmlReaderSettings z ustawieniami domyślnymi służy do tworzenia czytnika. Jeśli chcesz określić funkcje do obsługi utworzonego czytnika, użyj przeciążenia, które przyjmuje XmlReaderSettings obiekt jako jeden z jego argumentów, i przekaż XmlReaderSettings obiekt z odpowiednimi ustawieniami.

Ustawienie domyślne XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od .NET Framework 4.5.2, nie podano wartości domyślnejXmlUrlResolver. Jeśli rozwiązanie jest przeznaczone dla .NET Framework wersji 4.5.2 lub nowszejXmlReaderSettings.XmlResolver, określ XmlResolver użycie właściwości .

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, określ XmlResolver element z wymaganymi poświadczeniami przy użyciu XmlReaderSettings.XmlResolver właściwości .

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(TextReader)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu.

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

Parametry

input: TextReader

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Przykłady

W poniższym przykładzie StringReader użyto klasy do odczytania ciągu 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))

Uwagi

Ustawienie domyślne XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(Stream)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia z ustawieniami domyślnymi.

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

Parametry

input: Stream

Strumień zawierający dane XML.

Funkcja XmlReader skanuje pierwsze bajty strumienia, wyszukując znacznik kolejności bajtów lub inny znak kodowania. Po określeniu kodowania kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

SecurityException

Element XmlReader nie ma wystarczających uprawnień dostępu do lokalizacji danych XML.

Przykłady

Poniższy przykład tworzy XmlReader obiekt, który odczytuje z obiektu 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

Uwagi

Ustawienie domyślne XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(String, XmlReaderSettings)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego identyfikatora URI i ustawień.

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

Parametry

inputUri: String

Identyfikator URI pliku zawierającego dane XML. Obiekt XmlResolver na XmlReaderSettings obiekcie służy do konwertowania ścieżki na reprezentację danych kanonicznych. Jeśli XmlResolver jest to null, jest używany nowy XmlUrlResolver obiekt.

settings: XmlReaderSettings

Ustawienia nowego XmlReader wystąpienia. Ta wartość może być następująca null: .

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu inputUri to null.

FileNotFoundException

Nie można odnaleźć pliku określonego przez identyfikator URI.

UriFormatException

Format identyfikatora URI nie jest poprawny.

Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klas przechwyć wyjątek klasy bazowej , FormatExceptionzamiast tego.

Przykłady

Poniższy przykład tworzy obiekt, który obsługuje walidację XmlReader definicji typu dokumentu (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

Uwagi

Domyślnie bez XmlUrlResolver poświadczeń jest używany do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Oznacza to, że program XmlReader może uzyskiwać dostęp do wszystkich lokalizacji, które nie wymagają uwierzytelniania. Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Możesz ograniczyć zasoby, do których może uzyskiwać dostęp, XmlReader ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy