XmlReader.Create Metoda

Definicja

Przestrzeń nazw:: System.Xml

Zestawy:: netstandard.dll, System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Zestawy:: System.Xml.dll, System.Xml.ReaderWriter.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 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ń.

Przykłady

W tym przykładzie tworzony jest czytnik XML, który usuwa nieistotne odstępy, usuwa komentarze i wykonuje sprawdzanie zgodności na poziomie fragmentu.

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

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

W poniższym przykładzie użyto elementu XmlUrlResolver z domyślnymi poświadczeniami, aby uzyskać dostęp do pliku.

// Set the reader settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true;
settings.IgnoreProcessingInstructions = true;
settings.IgnoreWhitespace = true;

' Set the reader settings.
Dim settings as XmlReaderSettings = new XmlReaderSettings()
settings.IgnoreComments = true
settings.IgnoreProcessingInstructions = true
settings.IgnoreWhitespace = true

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

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

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

' Create a resolver with default credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials

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

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

Poniższy kod opakowuje instancję czytnika w innym czytniku.

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

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

W tym przykładzie czytniki są używane do sekwencyjnego dodawania walidacji dla schematów DTD i XML.

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

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

Uwagi

Create Większość przeciążeń obejmuje settings parametr, który akceptuje XmlReaderSettings obiekt. Tego obiektu można użyć do:

Określ, które funkcje mają być obsługiwane w XmlReader obiekcie.
Aby stworzyć wielu czytników, ponownie użyj obiektu XmlReaderSettings. Możesz użyć tych samych ustawień, aby utworzyć wielu czytelników z tą samą funkcjonalnością. Możesz też zmodyfikować ustawienia w wystąpieniu XmlReaderSettings i utworzyć nowego czytnika z innym zestawem funkcji.
Dodawanie funkcji do istniejącego czytnika XML. Metoda Create może zaakceptować inny XmlReader obiekt. Obiektem bazowym XmlReader może być czytnik zdefiniowany przez użytkownika, XmlTextReader obiekt lub inne XmlReader wystąpienie, do którego chcesz dodać dodatkowe funkcje.
Korzystaj w pełni z funkcji, takich jak lepsze sprawdzanie zgodności i zgodność z zaleceniem XML 1.0 (czwarta wersja), które są dostępne tylko dla XmlReader obiektów utworzonych przez metodę statyczną Create .

Note

Mimo że platforma .NET zawiera konkretne implementacje XmlReader klasy, takie jak XmlTextReader, XmlNodeReaderi XmlValidatingReader klasy, zalecamy utworzenie XmlReader wystąpień przy użyciu Create metody .

Ustawienia domyślne

Jeśli korzystasz z przeciążenia Create, które nie przyjmuje obiektu XmlReaderSettings, zastosowane zostaną następujące domyślne ustawienia czytnika:

Setting	Default
CheckCharacters	`true`
ConformanceLevel	ConformanceLevel.Document
IgnoreComments	`false`
IgnoreProcessingInstructions	`false`
IgnoreWhitespace	`false`
LineNumberOffset	0
LinePositionOffset	0
NameTable	`null`
DtdProcessing	Prohibit
Schemas	Pusty XmlSchemaSet obiekt
ValidationFlags	ProcessIdentityConstraints Włączone
ValidationType	None
XmlResolver	`null`

Ustawienia typowych scenariuszy

Poniżej przedstawiono XmlReaderSettings właściwości, które należy ustawić dla niektórych typowych scenariuszy czytnika XML.

Requirement	Set
Dane muszą być dobrze sformułowanym dokumentem XML.	ConformanceLevel do Document.
Dane muszą być prawidłowo sformułowaną jednostką analizowaną XML.	ConformanceLevel do Fragment.
Dane muszą być weryfikowane względem DTD.	DtdProcessing do Parse ValidationType do DTD.
Dane muszą być weryfikowane względem schematu XML.	ValidationType do Schema Schemas do XmlSchemaSet do użycia przy weryfikacji. Należy pamiętać, że XmlReader nie obsługuje weryfikacji schematu XML-Data Reduced (XDR).
Dane muszą być weryfikowane względem wbudowanego schematu XML.	ValidationType do Schema ValidationFlags do ProcessInlineSchema.
Obsługa typów.	ValidationType do Schema Schemas XmlSchemaSet do użycia.

XmlReader program nie obsługuje weryfikacji schematu XML-Data Zredukowane (XDR).

Programowanie asynchroniczne

W trybie Create synchronicznym metoda odczytuje pierwszy fragment danych z buforu pliku, strumienia lub czytnika tekstu. Może to zgłosić wyjątek, jeśli operacja we/wy zakończy się niepowodzeniem. W trybie asynchronicznym pierwszą operacją we/wy jest odczyt, więc wyjątki, które się pojawią, zostaną zgłoszone podczas tej operacji.

Zagadnienia dotyczące zabezpieczeń

Domyślnie XmlReader używa obiektu XmlUrlResolver, który nie zawiera poświadczeń użytkownika do otwierania zasobów. Oznacza to, że domyślnie czytnik XML może uzyskać dostęp do dowolnej lokalizacji, która nie wymaga poświadczeń. Użyj właściwości , XmlResolver aby kontrolować dostęp do zasobów:

Użyj ThrowingResolver polecenia , aby ograniczyć zasoby, do których może uzyskiwać dostęp czytnik XML, lub...
Ustaw wartość XmlResolver na null, aby uniemożliwić czytnikowi XML otwieranie jakichkolwiek zasobów zewnętrznych.

Create(String, XmlReaderSettings, XmlParserContext)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Ź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 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 uzyskać dostęp do wszystkich 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że uzyskiwać dostęp za pomocą polecenia ThrowingResolver.

Utworzony XmlReader obiekt rozszerza odwołania do jednostek 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

Ź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 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ść 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

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 za pomocą polecenia ThrowingResolver.
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.

Dotyczy

Create(Stream, XmlReaderSettings, XmlParserContext)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

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

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

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 za pomocą polecenia ThrowingResolver.
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.

Dotyczy

Create(Stream, XmlReaderSettings, String)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

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

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 za pomocą polecenia ThrowingResolver.
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.

Dotyczy

Create(XmlReader, XmlReaderSettings)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

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

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 za pomocą polecenia ThrowingResolver.
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.

Dotyczy

Create(TextReader, XmlReaderSettings, String)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

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

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

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 za pomocą polecenia ThrowingResolver.
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.

Dotyczy

Create(TextReader, XmlReaderSettings)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Ź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ść 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

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 za pomocą polecenia ThrowingResolver.
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.

Dotyczy

Create(Stream, XmlReaderSettings)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

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

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 za pomocą polecenia ThrowingResolver.
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.

Dotyczy

Create(String)

Źródło:: XmlReader.cs

Źródło:: XmlReader.cs

Ź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 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: w .NET dla aplikacji ze sklepu Windows lub Portable Class Library przechwyć wyjątek klasy bazowej, FormatException.

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

Utworzony XmlReader obiekt rozszerza odwołania do jednostek 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

Ź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ść 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

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

Utworzony XmlReader obiekt rozszerza odwołania do jednostek 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

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

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

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

Utworzony XmlReader obiekt rozszerza odwołania do jednostek 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

Ź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

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: w .NET dla aplikacji ze sklepu Windows lub Portable Class Library przechwyć wyjątek klasy bazowej, FormatException.

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

Możesz ograniczyć zasoby, do których XmlReader może uzyskiwać dostęp za pomocą polecenia ThrowingResolver.

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

Dotyczy

Opinia

Czy ta strona była pomocna?