XmlReader.Create Methode

Definition

Namespace:: System.Xml

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

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Assemblys:: System.Xml.dll, System.Xml.ReaderWriter.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt eine neue XmlReader-Instanz.

Überlädt

Name	Beschreibung
Create(String, XmlReaderSettings, XmlParserContext)	Erstellt eine neue XmlReader Instanz mithilfe der angegebenen URI, Einstellungen und Kontextinformationen für die Analyse.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Erstellt eine neue XmlReader Instanz mithilfe der angegebenen Textleser-, Einstellungs- und Kontextinformationen für die Analyse.
Create(Stream, XmlReaderSettings, XmlParserContext)	Erstellt eine neue XmlReader Instanz mithilfe der angegebenen Datenstrom-, Einstellungs- und Kontextinformationen für die Analyse.
Create(Stream, XmlReaderSettings, String)	Erstellt eine neue XmlReader Instanz mithilfe des angegebenen Datenstroms, des Basis-URI und der Einstellungen.
Create(XmlReader, XmlReaderSettings)	Erstellt eine neue XmlReader Instanz mithilfe des angegebenen XML-Readers und der angegebenen Einstellungen.
Create(TextReader, XmlReaderSettings, String)	Erstellt eine neue XmlReader Instanz mithilfe des angegebenen Textlesers, der Einstellungen und des Basis-URI.
Create(TextReader, XmlReaderSettings)	Erstellt eine neue XmlReader Instanz mithilfe der angegebenen Textsprachausgabe und -einstellungen.
Create(Stream, XmlReaderSettings)	Erstellt eine neue XmlReader Instanz mit dem angegebenen Datenstrom und den angegebenen Einstellungen.
Create(String)	Erstellt eine neue XmlReader Instanz mit angegebenem URI.
Create(TextReader)	Erstellt eine neue XmlReader Instanz mithilfe des angegebenen Textlesers.
Create(Stream)	Erstellt eine neue XmlReader Instanz mithilfe des angegebenen Datenstroms mit Standardeinstellungen.
Create(String, XmlReaderSettings)	Erstellt eine neue XmlReader Instanz mithilfe des angegebenen URI und der angegebenen Einstellungen.

Beispiele

In diesem Beispiel wird ein XML-Reader erstellt, der unbedeutende Leerzeichen entfernt, Kommentare entfernt und die Konformitätsüberprüfung auf Fragmentebene durchführt.

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)

Im folgenden Beispiel wird ein XmlUrlResolver mit Standardanmeldeinformationen für den Zugriff auf eine Datei verwendet.

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

Der folgende Code umschließt eine Reader-Instanz innerhalb eines anderen Readers.

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)

Dieses Beispiel verkettet Reader, um DTD- und XML-Schema-Validierung hinzuzufügen.

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

Hinweise

Create Die meisten Überladungen enthalten einen settings Parameter, der ein XmlReaderSettings Objekt akzeptiert. Sie können dieses Objekt verwenden, um:

Geben Sie an, welche Features für das XmlReader Objekt unterstützt werden sollen.
Verwenden Sie das XmlReaderSettings Objekt wieder, um mehrere Leser zu erstellen. Sie können dieselben Einstellungen verwenden, um mehrere Leser mit derselben Funktionalität zu erstellen. Oder Sie können die Einstellungen für eine XmlReaderSettings Instanz ändern und einen neuen Reader mit einem anderen Satz von Features erstellen.
Hinzufügen von Features zu einem vorhandenen XML-Reader. Die Create Methode kann ein anderes XmlReader Objekt akzeptieren. Das zugrunde liegende XmlReader Objekt kann ein benutzerdefinierter Reader, ein XmlTextReader Objekt oder eine andere XmlReader Instanz sein, der Sie zusätzliche Features hinzufügen möchten.
Nutzen Sie die Vorteile von Funktionen wie einer besseren Konformitätsprüfung und Einhaltung der XML 1.0-Empfehlung (vierte Edition), die nur für XmlReader Objekte verfügbar sind, die von der statischen Create Methode erstellt wurden.

Note

Obwohl .NET konkrete Implementierungen der XmlReader Klasse enthält, z. B. das XmlTextReader, XmlNodeReaderund die XmlValidatingReader Klassen, empfehlen wir, Instanzen mithilfe der XmlReader Methode zu erstellenCreate.

Standardeinstellungen

Wenn Sie eine Create Überladung verwenden, die kein XmlReaderSettings Objekt akzeptiert, werden die folgenden Standardeinstellungen des Readers verwendet:

Setting	Vorgabe
CheckCharacters	`true`
ConformanceLevel	ConformanceLevel.Document
IgnoreComments	`false`
IgnoreProcessingInstructions	`false`
IgnoreWhitespace	`false`
LineNumberOffset	0
LinePositionOffset	0
NameTable	`null`
DtdProcessing	Prohibit
Schemas	Ein leeres XmlSchemaSet Objekt
ValidationFlags	ProcessIdentityConstraints aktiviert
ValidationType	None
XmlResolver	`null`

Einstellungen für häufige Szenarios

Hier sind die XmlReaderSettings-Eigenschaften, die Sie für einige der typischen XML-Leser-Szenarien festlegen sollten.

Anforderung	Festlegen
Daten müssen ein wohlgeformtes XML-Dokument sein.	ConformanceLevel auf Document.
Daten müssen eine wohlgeformte XML-analysierte Entität sein.	ConformanceLevel auf Fragment.
Daten müssen anhand einer DTD überprüft werden.	DtdProcessing bis Parse ValidationType auf DTD.
Daten müssen anhand eines XML-Schemas überprüft werden.	ValidationType bis Schema Schemas zum XmlSchemaSet für die Validierung zu verwenden. Beachten Sie, dass XmlReader keine XML-Data reduzierte XDR-Schemaüberprüfung unterstützt.
Daten müssen anhand eines Inline-XML-Schemas überprüft werden.	ValidationType bis Schema ValidationFlags auf ProcessInlineSchema.
Typ-Support.	ValidationType bis Schema Schemas zu den XmlSchemaSet zu verwenden.

XmlReader unterstützt nicht die XML-Data Reduced (XDR) Schema-Validierung.

Asynchrone Programmierung

Im synchronen Modus liest die Create Methode den ersten Datenabschnitt aus dem Puffer der Datei, des Datenstroms oder des Textlesers. Dies kann eine Ausnahme auslösen, wenn ein E/A-Vorgang fehlschlägt. Im asynchronen Modus erfolgt der erste E/A-Vorgang mit einem Lesevorgang, so dass auftretende Ausnahmen ausgelöst werden, wenn der Lesevorgang erfolgt.

Sicherheitsüberlegungen

Standardmäßig verwendet das XmlReader-Objekt das XmlUrlResolver-Objekt ohne Benutzeranmeldeinformationen, um Ressourcen zu öffnen. Dies bedeutet, dass der XML-Reader standardmäßig auf jeden Speicherort zugreifen kann, an dem keine Anmeldeinformationen erforderlich sind. Verwenden Sie die XmlResolver Eigenschaft, um den Zugriff auf Ressourcen zu steuern:

Wird verwendet ThrowingResolver , um die Ressourcen einzuschränken, auf die der XML-Reader zugreifen kann, oder...
Setzen Sie XmlResolver auf null, um zu verhindern, dass der XML-Reader externe Ressourcen öffnet.

Create(String, XmlReaderSettings, XmlParserContext)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe der angegebenen URI, Einstellungen und Kontextinformationen für die Analyse.

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

Parameter

inputUri: String

Der URI für die Datei, die die XML-Daten enthält. Das XmlResolver Objekt für das XmlReaderSettings Objekt wird verwendet, um den Pfad in eine kanonische Datendarstellung zu konvertieren. Wenn XmlResolver ja null, wird ein neues XmlUrlResolver Objekt verwendet.

settings: XmlReaderSettings

Die Einstellungen für die neue XmlReader Instanz. Dieser Wert kann null sein.

inputContext: XmlParserContext

Die zum Analysieren des XML-Fragments erforderlichen Kontextinformationen. Die Kontextinformationen können die XmlNameTable zu verwendende, Codierung, Namespacebereich, aktuelle xml:lang und xml:space Bereichsdefinition, Basis-URI und Dokumenttypdefinition enthalten.

Dieser Wert kann null sein.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert inputUri ist null.

SecurityException

Die XmlReader Berechtigung für den Zugriff auf den Speicherort der XML-Daten ist nicht ausreichend.

ArgumentException

Die NameTable Beiden NameTable Eigenschaften enthalten Werte. (Nur eine dieser NameTable Eigenschaften kann festgelegt und verwendet werden).

FileNotFoundException

Die durch den URI angegebene Datei wurde nicht gefunden.

UriFormatException

Das URI-Format ist nicht korrekt.

Hinweise

Standardmäßig wird ein XmlUrlResolver Nicht-Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Important

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver Verwendung der XmlReaderSettings.XmlResolver Eigenschaft an.

Dies bedeutet, dass der Zugriff auf alle Speicherorte möglich ist, für die XmlReader keine Authentifizierung erforderlich ist. Wenn sich die externe Ressource in einer Netzwerkressource befindet, die eine Authentifizierung erfordert, verwenden Sie die XmlReaderSettings.XmlResolver Eigenschaft, um eine XmlResolver mit den erforderlichen Anmeldeinformationen anzugeben.

Important

Sie können die Ressourcen einschränken, auf die sie XmlReader zugreifen können.ThrowingResolver

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(TextReader, XmlReaderSettings, XmlParserContext)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe der angegebenen Textleser-, Einstellungs- und Kontextinformationen für die Analyse.

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

Parameter

input: TextReader

Der Textleser, aus dem die XML-Daten gelesen werden sollen. Ein Textleser gibt einen Unicode-Datenstrom zurück, sodass die in der XML-Deklaration angegebene Codierung nicht vom XML-Reader zum Decodieren des Datenstroms verwendet wird.

settings: XmlReaderSettings

Die Einstellungen für die neue XmlReader Instanz. Dieser Wert kann null sein.

inputContext: XmlParserContext

Dieser Wert kann null sein.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert input ist null.

ArgumentException

Die NameTable Beiden NameTable Eigenschaften enthalten Werte. (Nur eine dieser NameTable Eigenschaften kann festgelegt und verwendet werden.)

Beispiele

Im folgenden Beispiel wird ein XmlReader Objekt erstellt, das ein XML-Fragment liest.

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)

Hinweise

Standardmäßig wird ein XmlUrlResolver Nicht-Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Important

Wenn sich die externe Ressource in einer Netzwerkressource befindet, die eine Authentifizierung erfordert, verwenden Sie die XmlReaderSettings.XmlResolver Eigenschaft, um eine XmlResolver mit den erforderlichen Anmeldeinformationen anzugeben.

Important

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen zugegriffen XmlReader werden kann:

Beschränken Sie die Ressourcen, auf die der XmlReader Benutzer zugreifen ThrowingResolverkann.
Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf null festlegen.

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(Stream, XmlReaderSettings, XmlParserContext)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe der angegebenen Datenstrom-, Einstellungs- und Kontextinformationen für die Analyse.

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

Parameter

input: Stream

Der Datenstrom, der die XML-Daten enthält.

Die XmlReader ersten Bytes des Datenstroms werden durchsucht, die nach einem Bytereihenfolgezeichen oder einem anderen Zeichen der Codierung suchen. Wenn die Codierung bestimmt wird, wird die Codierung verwendet, um mit dem Lesen des Datenstroms fortzufahren, und die Verarbeitung analysiert die Eingabe weiterhin als Datenstrom von (Unicode)-Zeichen.

settings: XmlReaderSettings

Die Einstellungen für die neue XmlReader Instanz. Dieser Wert kann null sein.

inputContext: XmlParserContext

Dieser Wert kann null sein.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert input ist null.

Hinweise

Standardmäßig wird ein XmlUrlResolver Nicht-Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Important

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen zugegriffen XmlReader werden kann:

Beschränken Sie die Ressourcen, auf die der XmlReader Benutzer zugreifen ThrowingResolverkann.
Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf null festlegen.

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(Stream, XmlReaderSettings, String)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe des angegebenen Datenstroms, des Basis-URI und der Einstellungen.

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

Parameter

input: Stream

Der Datenstrom, der die XML-Daten enthält.

settings: XmlReaderSettings

Die Einstellungen für die neue XmlReader Instanz. Dieser Wert kann null sein.

baseUri: String

Der Basis-URI für die Entität oder das Dokument, die gelesen wird. Dieser Wert kann null sein.

Sicherheitshinweis Der Basis-URI wird verwendet, um den relativen URI des XML-Dokuments aufzulösen. Verwenden Sie keinen Basis-URI aus einer nicht vertrauenswürdigen Quelle.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert input ist null.

Hinweise

Standardmäßig wird ein XmlUrlResolver Nicht-Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Important

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen zugegriffen XmlReader werden kann:

Beschränken Sie die Ressourcen, auf die der XmlReader Benutzer zugreifen ThrowingResolverkann.
Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf null festlegen.

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(XmlReader, XmlReaderSettings)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe des angegebenen XML-Readers und der angegebenen Einstellungen.

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

Parameter

reader: XmlReader

Das Objekt, das Sie als zugrunde liegenden XML-Reader verwenden möchten.

settings: XmlReaderSettings

Die Einstellungen für die neue XmlReader Instanz.

Die Konformitätsstufe des XmlReaderSettings Objekts muss entweder mit der Konformitätsstufe des zugrunde liegenden Lesers übereinstimmen, oder sie muss auf . Auto festgelegt werden.

Gibt zurück

XmlReader

Ein Objekt, das um das angegebene XmlReader Objekt herum umbrochen wird.

Ausnahmen

ArgumentNullException

Der wert reader ist null.

InvalidOperationException

Wenn das XmlReaderSettings Objekt eine Konformitätsstufe angibt, die nicht mit der Konformitätsstufe des zugrunde liegenden Readers konsistent ist.

-oder-

Der zugrunde liegende XmlReader Zustand befindet sich in einem Error oder Closed einem Zustand.

Beispiele

Im folgenden Beispiel wird ein validierendes XmlReader Objekt erstellt, das um ein XmlNodeReader Objekt umbrochen wird.

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

Hinweise

Mit dieser Methode können Sie einem zugrunde liegenden XmlReader Objekt zusätzliche Features hinzufügen. Das zugrunde liegende XmlReader Objekt kann ein anderes XmlReader Objekt sein, das von der Create Methode erstellt wurde, oder ein XmlReader Objekt, das mit einer der konkreten XmlReader Implementierungen erstellt wurde.

Ein Standardwert XmlUrlResolver ohne Anmeldeinformationen wird verwendet, um auf externe Ressourcen wie ein Schema zuzugreifen.

Important

Wenn sich die externe Ressource in einer Netzwerkressource befindet, die eine Authentifizierung erfordert, geben Sie eine XmlResolver mit den erforderlichen Anmeldeinformationen mithilfe der XmlReaderSettings.XmlResolver Eigenschaft an.

Important

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen zugegriffen XmlReader werden kann:

Beschränken Sie die Ressourcen, auf die der XmlReader Benutzer zugreifen ThrowingResolverkann.
Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf null festlegen.

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(TextReader, XmlReaderSettings, String)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe des angegebenen Textlesers, der Einstellungen und des Basis-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

Parameter

input: TextReader

Der Textleser, aus dem die XML-Daten gelesen werden sollen. Ein Textleser gibt einen Datenstrom von Unicode-Zeichen zurück, sodass die in der XML-Deklaration angegebene Codierung nicht von der XmlReader Decodierung des Datenstroms verwendet wird.

settings: XmlReaderSettings

Die Einstellungen für die neue XmlReader Instanz. Dieser Wert kann null sein.

baseUri: String

Der Basis-URI für die Entität oder das Dokument, die gelesen wird. Dieser Wert kann null sein.

Sicherheitshinweis Der Basis-URI wird verwendet, um den relativen URI des XML-Dokuments aufzulösen. Verwenden Sie keinen Basis-URI aus einer nicht vertrauenswürdigen Quelle.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert input ist null.

Hinweise

Standardmäßig wird ein XmlUrlResolver Nicht-Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Important

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen zugegriffen XmlReader werden kann:

Beschränken Sie die Ressourcen, auf die der XmlReader Benutzer zugreifen ThrowingResolverkann.
Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf null festlegen.

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(TextReader, XmlReaderSettings)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe der angegebenen Textsprachausgabe und -einstellungen.

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

Parameter

input: TextReader

settings: XmlReaderSettings

Die Einstellungen für das neue XmlReader. Dieser Wert kann null sein.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert input ist null.

Hinweise

Standardmäßig wird ein XmlUrlResolver Nicht-Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Important

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen zugegriffen XmlReader werden kann:

Beschränken Sie die Ressourcen, auf die der XmlReader Benutzer zugreifen ThrowingResolverkann.
Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf null festlegen.

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(Stream, XmlReaderSettings)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mit dem angegebenen Datenstrom und den angegebenen Einstellungen.

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

Parameter

input: Stream

Der Datenstrom, der die XML-Daten enthält.

settings: XmlReaderSettings

Die Einstellungen für die neue XmlReader Instanz. Dieser Wert kann null sein.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert input ist null.

Hinweise

Standardmäßig wird ein XmlUrlResolver Nicht-Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Important

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen zugegriffen XmlReader werden kann:

Beschränken Sie die Ressourcen, auf die der XmlReader Benutzer zugreifen ThrowingResolverkann.
Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf null festlegen.

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(String)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mit angegebenem 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

Parameter

inputUri: String

Der URI für die Datei, die die XML-Daten enthält. Die XmlUrlResolver Klasse wird verwendet, um den Pfad in eine kanonische Datendarstellung zu konvertieren.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert inputUri ist null.

SecurityException

Die XmlReader Berechtigung für den Zugriff auf den Speicherort der XML-Daten ist nicht ausreichend.

FileNotFoundException

Die durch den URI identifizierte Datei ist nicht vorhanden.

UriFormatException

Das URI-Format ist nicht korrekt.

Hinweis: Erfassen Sie in .NET für Windows Store-Apps oder die Portable Class Library stattdessen die Ausnahme der Basisklasse FormatException.

Beispiele

Im folgenden Beispiel wird ein XmlReader Objekt erstellt, das die durch den URI angegebene XML-Datendatei liest.

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

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

Hinweise

Ein XmlReaderSettings Objekt mit Standardeinstellungen wird verwendet, um den Reader zu erstellen. Wenn Sie die Features angeben möchten, die für den erstellten Reader unterstützt werden sollen, verwenden Sie die Überladung, die ein XmlReaderSettings Objekt als eines seiner Argumente verwendet, und übergeben Sie ein XmlReaderSettings Objekt mit den richtigen Einstellungen.

Ein Standardwert XmlUrlResolver ohne Anmeldeinformationen wird verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DOCUMENT Type Definition, DTD), Entitäten, Schemas usw. zuzugreifen.

Important

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(TextReader)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe des angegebenen Textlesers.

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

Parameter

input: TextReader

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert input ist null.

Beispiele

Im folgenden Beispiel wird die StringReader Klasse zum Lesen einer XML-Zeichenfolge verwendet.

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

Hinweise

Important

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(Stream)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe des angegebenen Datenstroms mit Standardeinstellungen.

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

Parameter

input: Stream

Der Datenstrom, der die XML-Daten enthält.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert input ist null.

SecurityException

Die XmlReader Berechtigung für den Zugriff auf den Speicherort der XML-Daten ist nicht ausreichend.

Beispiele

Im folgenden Beispiel wird ein XmlReader Objekt erstellt, das aus einem 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

Hinweise

Important

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(String, XmlReaderSettings)

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Quelle:: XmlReader.cs

Erstellt eine neue XmlReader Instanz mithilfe des angegebenen URI und der angegebenen Einstellungen.

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

Parameter

inputUri: String

settings: XmlReaderSettings

Die Einstellungen für die neue XmlReader Instanz. Dieser Wert kann null sein.

Gibt zurück

XmlReader

Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.

Ausnahmen

ArgumentNullException

Der wert inputUri ist null.

FileNotFoundException

Die durch den URI angegebene Datei wurde nicht gefunden.

UriFormatException

Das URI-Format ist nicht korrekt.

Hinweis: Erfassen Sie in .NET für Windows Store-Apps oder die Portable Class Library stattdessen die Ausnahme der Basisklasse FormatException.

Beispiele

Im folgenden Beispiel wird ein Objekt erstellt, das die XmlReader Dokumenttypdefinitionsüberprüfung (DTD) unterstützt.

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

Hinweise

Standardmäßig wird ein XmlUrlResolver Nicht-Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Important

Sie können die Ressourcen einschränken, auf die sie XmlReader zugreifen können.ThrowingResolver

Das erstellte XmlReader Objekt erweitert Entitätsverweise und führt die XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Feedback

War diese Seite hilfreich?