XmlReader.Create Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

Tworzy nowy obiekt XmlReader.

Przeciążenia

Nazwa	Opis
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 Dodatkowe uwagi dotyczące interfejsu API dla elementu XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

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

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 na XmlReaderSettings obiekcie służy do konwertowania ścieżki na reprezentację danych kanonicznych. Jeśli XmlResolver element to null, zostanie użyty nowy XmlUrlResolver obiekt.

settings

XmlReaderSettings

Ustawienia 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ść 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 bez XmlUrlResolver 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żna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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 uwierzytelnienia, użyj XmlReaderSettings.XmlResolver właściwości , aby określić XmlResolver element z wymaganymi poświadczeniami.

Ważna

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

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

Create(TextReader, XmlReaderSettings, XmlParserContext)

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

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 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ść 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 bez XmlUrlResolver 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żna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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

Ważna

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 właściwość XmlResolver jako XmlSecureResolver obiekt.

— lub —

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

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

Create(Stream, XmlReaderSettings, XmlParserContext)

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

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. Podczas określania kodowania kodowanie jest używane do dalszego odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).

settings

XmlReaderSettings

Ustawienia 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ść input to null.

Uwagi

Domyślnie bez XmlUrlResolver 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żna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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

Ważna

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 właściwość XmlResolver jako XmlSecureResolver obiekt.

— lub —

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

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

Create(Stream, XmlReaderSettings, String)

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

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.

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

settings

XmlReaderSettings

Ustawienia 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 ze źródła niezaufanego.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość input to null.

Uwagi

Domyślnie bez XmlUrlResolver 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żna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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

Ważna

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 właściwość XmlResolver jako XmlSecureResolver obiekt.

— lub —

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

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

Create(XmlReader, XmlReaderSettings)

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

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 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ść 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 jakichkolwiek zasobów zewnętrznych, takich jak schemat.

Ważna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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żna

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 właściwość XmlResolver jako XmlSecureResolver obiekt.

— lub —

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

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

Create(TextReader, XmlReaderSettings, String)

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

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 element do XmlReader dekodowania strumienia danych.

settings

XmlReaderSettings

Ustawienia 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 ze źródła niezaufanego.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość input to null.

Uwagi

Domyślnie bez XmlUrlResolver 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żna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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

Ważna

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 właściwość XmlResolver jako XmlSecureResolver obiekt.

— lub —

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

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

Create(TextReader, XmlReaderSettings)

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

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

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 XmlReaderelementu . Ta wartość może mieć wartość null.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość input to null.

Uwagi

Domyślnie bez XmlUrlResolver 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żna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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

Ważna

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 właściwość XmlResolver jako XmlSecureResolver obiekt.

— lub —

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

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

Create(Stream, XmlReaderSettings)

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

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.

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

settings

XmlReaderSettings

Ustawienia 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ść input to null.

Uwagi

Domyślnie bez XmlUrlResolver 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żna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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

Ważna

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 właściwość XmlResolver jako XmlSecureResolver obiekt.

— lub —

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

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

Create(String)

Ź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 kanoniczną reprezentację danych.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość 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 jest niepoprawny.

Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub w bibliotece klas przenośnych 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 poprawnymi ustawieniami.

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

Ważna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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 .

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

Create(TextReader)

Ź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

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.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość input to null.

Przykłady

W poniższym przykładzie użyto StringReader 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

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 poprawnymi ustawieniami.

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

Ważna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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 .

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

Create(Stream)

Ź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.

Skanowanie XmlReader pierwszych bajtów strumienia w poszukiwaniu znaku kolejności bajtów lub innego znaku kodowania. Podczas określania kodowania kodowanie jest używane do dalszego 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ść 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

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 poprawnymi ustawieniami.

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

Ważna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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 .

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

Create(String, XmlReaderSettings)

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

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 element to null, zostanie użyty nowy XmlUrlResolver obiekt.

settings

XmlReaderSettings

Ustawienia 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ść inputUri to null.

FileNotFoundException

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

UriFormatException

Format identyfikatora URI jest niepoprawny.

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

Przykłady

Poniższy przykład tworzy obiekt, który obsługuje weryfikację 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ń służy do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważna

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla programu .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

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 uwierzytelnienia, użyj XmlReaderSettings.XmlResolver właściwości , aby określić XmlResolver element z wymaganymi poświadczeniami.

Ważna

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

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