XmlReader.Create Methode

Referenz

Definition

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.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

Create(String, XmlReaderSettings, XmlParserContext)	Erstellt mit dem angegebenen URI, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Erstellt mit dem angegebenen Text-Reader, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.
Create(Stream, XmlReaderSettings, XmlParserContext)	Erstellt mit dem angegebenen Stream, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.
Create(Stream, XmlReaderSettings, String)	Erstellt mit dem angegebenen Stream, dem Basis-URI und den Einstellungen eine neue XmlReader-Instanz.
Create(XmlReader, XmlReaderSettings)	Erstellt mit dem angegebenen XML-Reader und den angegebenen Einstellungen eine neue XmlReader-Instanz.
Create(TextReader, XmlReaderSettings, String)	Erstellt mit dem angegebenen Text-Reader, den angegebenen Einstellungen und dem angegebenen Basis-URI eine neue XmlReader-Instanz.
Create(TextReader, XmlReaderSettings)	Erstellt mit dem angegebenen Text-Reader und den angegebenen Einstellungen eine neue XmlReader-Instanz.
Create(Stream, XmlReaderSettings)	Erstellt eine neue XmlReader-Instanz mit dem angegebenen Stream und den angegebenen Einstellungen.
Create(String)	Erstellt eine neue XmlReader-Instanz mit angegebenem URI.
Create(TextReader)	Erstellt mit dem angegebenen Text-Reader eine neue XmlReader-Instanz.
Create(Stream)	Erstellt mit dem angegebenen Stream mit den Standardeinstellungen eine neue XmlReader-Instanz.
Create(String, XmlReaderSettings)	Erstellt mit dem angegebenen URI und den angegebenen Einstellungen eine neue XmlReader-Instanz.

Beispiele

In diesem Beispiel wird ein XML-Reader erstellt, der unbedeutende Leerzeichen, Kommentare streifen und die Ü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 Standardanmeldeinformationen verwendet, um auf eine Datei zuzugreifen.

// Set the reader settings.
XmlReaderSettings^ settings = gcnew XmlReaderSettings;
settings->IgnoreComments = true;
settings->IgnoreProcessingInstructions = true;
settings->IgnoreWhitespace = true;

// 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 = gcnew 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( L"http://ServerName/data/books.xml", settings );

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

In diesem Beispiel werden Leser zum Hinzufügen von DTD- und XML-Schemaüberprüfungen verkettet.

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

Die meisten Überladungen enthalten einen settings Parameter, der Create 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, um mehrere Leser zu erstellen. Sie können dieselben Einstellungen verwenden, um mehrere Reader mit denselben Funktionen zu erstellen. Alternativ können Sie die Einstellungen für eine XmlReaderSettings Instanz ändern und einen neuen Reader mit einer anderen Reihe von Features erstellen.
Hinzufügen von Features zu einem vorhandenen XML-Reader. Die Create-Methode kann ein anderes XmlReader-Objekt annehmen. 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 vollständige Vorteile von Features wie einer besseren Konformitätsüberprüfung und -compliance an die EMPFEHLUNG der XML 1.0 (vierten Edition), die nur für XmlReader Objekte verfügbar sind, die von der statischen Create Methode erstellt wurden.

Hinweis

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

Standardeinstellungen

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

Einstellung	Standard
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	Ein neues XmlUrlResolver-Objekt. Ab der .NET Framework-Version 4.5.2 hat diese Einstellung den Standardwert `null`.

Einstellungen für häufige Szenarios

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

Anforderung	Set
Daten müssen ein gut gebildetes XML-Dokument sein.	ConformanceLevel in Document.
Daten müssen eine gut gebildete XML-Analysierte Entität sein.	ConformanceLevel in Fragment.
Daten müssen anhand einer DTD überprüft werden.	DtdProcessing in Parse ValidationType in DTD.
Daten müssen anhand eines XML-Schemas überprüft werden.	ValidationType in Schema Schemas zur Verwendung für die XmlSchemaSet Überprüfung. Beachten Sie, dass XmlReader XML-Data Eingeschränkte (XDR)-Schemaüberprüfung nicht unterstützt wird.
Daten müssen anhand eines Inline-XML-Schemas überprüft werden.	ValidationType in Schema ValidationFlags in ProcessInlineSchema.
Geben Sie unterstützung ein.	ValidationType in Schema Schemas zu verwenden XmlSchemaSet .

XmlReader unterstützt keine XML-Data Reduzierten (XDR)-Schemaüberprüfung.

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 I/O-Vorgang fehlschlägt. Im asynchronen Modus tritt der erste E/A-Vorgang mit einem Lesevorgang auf, sodass Ausnahmen ausgelöst werden, wenn der Lesevorgang auftritt.

Sicherheitshinweise

Standardmäßig verwendet XmlUrlResolver das XmlReader Objekt ohne Benutzeranmeldeinformationen zum Öffnen von Ressourcen. Dies bedeutet, dass der XML-Reader standardmäßig auf einen beliebigen Speicherort zugreifen kann, der keine Anmeldeinformationen erfordert. Verwenden Sie die XmlResolver Eigenschaft, um den Zugriff auf Ressourcen zu steuern:

Legen Sie XmlResolver auf ein XmlSecureResolver Objekt fest, um die Ressourcen einzuschränken, auf die der XML-Reader zugreifen kann.

- oder -

Legen Sie XmlResolver fest, um zu null verhindern, dass der XML-Reader externe Ressourcen öffnet.

Create(String, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen URI, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.

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 der Datei, die die XML-Daten enthält. Das XmlResolver-Objekt für das XmlReaderSettings-Objekt wird zum Konvertieren des Pfads in eine kanonische Datendarstellung verwendet. Wenn XmlResolvernull ist, wird ein neues XmlUrlResolver-Objekt verwendet.

settings: XmlReaderSettings

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

inputContext: XmlParserContext

Die Kontextinformationen, die zum Analysieren des XML-Fragments erforderlich sind. Die Kontextinformationen können die zu verwendende XmlNameTable, die Codierung, den Namespacebereich, den aktuellen xml:lang- und xml:space-Bereich, Basis-URI und Dokumenttypdefinition enthalten.

Dieser Wert kann null sein.

Gibt zurück

XmlReader

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der inputUri-Wert ist null.

SecurityException

Der XmlReader besitzt keine ausreichenden Berechtigungen für den Zugriff auf den Speicherort der XML-Daten.

ArgumentException

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

FileNotFoundException

Die durch den URI angegebene Datei kann nicht gefunden werden.

UriFormatException

Das URI-Format ist falsch.

Hinweise

Standardmäßig wird für XmlUrlResolver den Zugriff auf externe Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. verwendet.

Wichtig

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

Dies bedeutet, dass der XmlReader Zugriff auf alle Speicherorte möglich ist, die keine Authentifizierung erfordern. 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.

Wichtig

Sie können die Ressourcen einschränken, auf die die XmlReader zugreifen können, indem Sie die XmlResolver Eigenschaft auf ein XmlSecureResolver Objekt festlegen.

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

Gilt für:

Create(TextReader, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen Text-Reader, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.

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 Text-Reader, aus dem die XML-Daten gelesen werden sollen. Ein Text-Reader gibt einen Stream von Unicode-Zeichen zurück, sodass die in der XML-Deklaration angegebene Codierung nicht vom XML-Reader zum Decodieren des Datenstreams 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, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der input-Wert ist null.

ArgumentException

Die NameTable und die 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 für XmlUrlResolver den Zugriff auf externe Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. verwendet.

Wichtig

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.

Wichtig

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen sie XmlReader zugreifen können:

Beschränken Sie die Ressourcen, auf die der XmlReader zugreifen kann, indem Sie die XmlResolver-Eigenschaft auf ein XmlSecureResolver-Objekt festlegen.

- oder -

Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.

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

Gilt für:

Create(Stream, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen Stream, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.

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 Stream, der die XML-Daten enthält.

Der XmlReader überprüft die ersten Bytes des Streams und durchsucht sie nach einer Bytereihenfolgemarkierung oder einem anderen Codierungszeichen. Nachdem die Codierung bestimmt wurde, wird sie zum weiteren Lesen des Streams verwendet, und die Eingabe wird weiterhin als Stream von (Unicode-)Zeichen analysiert.

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, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der input-Wert ist null.

Hinweise

Standardmäßig wird für XmlUrlResolver den Zugriff auf externe Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. verwendet.

Wichtig

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen sie XmlReader zugreifen können:

Beschränken Sie die Ressourcen, auf die der XmlReader zugreifen kann, indem Sie die XmlResolver-Eigenschaft auf ein XmlSecureResolver-Objekt festlegen.

- oder -

Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.

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

Gilt für:

Create(Stream, XmlReaderSettings, String)

Erstellt mit dem angegebenen Stream, dem Basis-URI und den Einstellungen eine neue XmlReader-Instanz.

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 Stream, 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 der gelesenen Entität oder des gelesenen Dokuments. Dieser Wert kann null sein.

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

Gibt zurück

XmlReader

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der input-Wert ist null.

Hinweise

Standardmäßig wird für XmlUrlResolver den Zugriff auf externe Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. verwendet.

Wichtig

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen sie XmlReader zugreifen können:

Beschränken Sie die Ressourcen, auf die der XmlReader zugreifen kann, indem Sie die XmlResolver-Eigenschaft auf ein XmlSecureResolver-Objekt festlegen.

- oder -

Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.

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

Gilt für:

Create(XmlReader, XmlReaderSettings)

Erstellt mit dem angegebenen XML-Reader und den angegebenen Einstellungen eine neue XmlReader-Instanz.

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, dass Sie als zugrunde liegenden XML-Reader verwenden möchten.

settings: XmlReaderSettings

Die Einstellungen für die neue XmlReader-Instanz.

Der Konformitätsgrad des XmlReaderSettings-Objekts muss mit dem Konformitätsgrad des zugrunde liegenden Readers übereinstimmen oder auf Auto festgelegt werden.

Gibt zurück

XmlReader

Ein Objekt, das das angegebene XmlReader-Objekt umschließt.

Ausnahmen

ArgumentNullException

Der reader-Wert ist null.

InvalidOperationException

Wenn das XmlReaderSettings-Objekt einen Konformitätsgrad angibt, der mit dem Konformitätsgrad des zugrunde liegenden Readers nicht übereinstimmt.

- oder -

Der zugrunde liegende XmlReader befindet im Zustand Error oder Closed.

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 XmlReader liegende Objekt kann ein anderes XmlReader Objekt sein, das von der Create Methode erstellt wird, oder ein Objekt, das mithilfe einer XmlReader der konkreten XmlReader Implementierungen erstellt wurde.

Eine Standardeinstellung XmlUrlResolver ohne Anmeldeinformationen wird verwendet, um auf externe Ressourcen wie ein Schema zuzugreifen.

Wichtig

Ab dem .NET Framework 4.5.2 wird keine Standardeinstellung XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf die .NET Framework 4.5.2 oder höherer Versionen ausgerichtet ist, geben Sie eine XmlResolver Verwendung der XmlReaderSettings.XmlResolver Eigenschaft an.

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.

Wichtig

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen XmlReader die zugreifen können:

Beschränken Sie die Ressourcen, auf die der XmlReader zugreifen kann, indem Sie die XmlResolver-Eigenschaft auf ein XmlSecureResolver-Objekt festlegen.

- oder -

Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.

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

Gilt für:

Create(TextReader, XmlReaderSettings, String)

Erstellt mit dem angegebenen Text-Reader, den angegebenen Einstellungen und dem angegebenen Basis-URI eine neue XmlReader-Instanz.

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 Text-Reader, aus dem die XML-Daten gelesen werden sollen. Ein Text-Reader gibt einen Stream von Unicode-Zeichen zurück, sodass die in der XML-Deklaration angegebene Codierung nicht vom XmlReader zum Decodieren des Datenstreams verwendet wird.

settings: XmlReaderSettings

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

baseUri: String

Der Basis-URI der gelesenen Entität oder des gelesenen Dokuments. Dieser Wert kann null sein.

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

Gibt zurück

XmlReader

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der input-Wert ist null.

Hinweise

Standardmäßig wird für XmlUrlResolver den Zugriff auf externe Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. verwendet.

Wichtig

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen sie XmlReader zugreifen können:

Beschränken Sie die Ressourcen, auf die der XmlReader zugreifen kann, indem Sie die XmlResolver-Eigenschaft auf ein XmlSecureResolver-Objekt festlegen.

- oder -

Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.

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

Gilt für:

Create(TextReader, XmlReaderSettings)

Erstellt mit dem angegebenen Text-Reader und den angegebenen Einstellungen eine neue XmlReader-Instanz.

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 den neuen XmlReader. Dieser Wert kann null sein.

Gibt zurück

XmlReader

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der input-Wert ist null.

Hinweise

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

Wichtig

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen XmlReader die zugreifen können:

Beschränken Sie die Ressourcen, auf die der XmlReader zugreifen kann, indem Sie die XmlResolver-Eigenschaft auf ein XmlSecureResolver-Objekt festlegen.

- oder -

Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.

Das erstellte XmlReader Objekt erweitert Entitätsbezüge und führt die XML-Normalisierung neuer Zeilenzeichen aus.

Gilt für:

Create(Stream, XmlReaderSettings)

Erstellt eine neue XmlReader-Instanz mit dem angegebenen Stream 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 Stream, 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, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der input-Wert ist null.

Hinweise

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

Wichtig

Sie können eine der folgenden Methoden verwenden, um zu steuern, auf welche Ressourcen XmlReader die zugreifen können:

Beschränken Sie die Ressourcen, auf die der XmlReader zugreifen kann, indem Sie die XmlResolver-Eigenschaft auf ein XmlSecureResolver-Objekt festlegen.

- oder -

Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.

Das erstellte XmlReader Objekt erweitert Entitätsbezüge und führt die XML-Normalisierung neuer Zeilenzeichen aus.

Gilt für:

Create(String)

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 der Datei, die die XML-Daten enthält. Mit der XmlUrlResolver-Klasse wird der Pfad in eine kanonische Datendarstellung konvertiert.

Gibt zurück

XmlReader

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der inputUri-Wert ist null.

SecurityException

Der XmlReader besitzt keine ausreichenden Berechtigungen für den Zugriff auf den Speicherort der XML-Daten.

FileNotFoundException

Die durch den URI bezeichnete Datei ist nicht vorhanden.

UriFormatException

Das URI-Format ist falsch.

Hinweis: In .NET für Windows Store Apps oder die Portable Class Library fangen Sie stattdessen die Basisklasse-Ausnahme ab. FormatException

Beispiele

Im folgenden Beispiel wird ein XmlReader Objekt erstellt, das xml-Datendatei liest, die vom URI angegeben wird.

// 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 Leser zu erstellen. Wenn Sie die Features angeben möchten, die für den erstellten Leser 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.

Eine Standardeinstellung XmlUrlResolver ohne Anmeldeinformationen wird verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Wichtig

Das erstellte XmlReader Objekt erweitert Entitätsbezüge und führt die XML-Normalisierung neuer Zeilenzeichen aus.

Gilt für:

Create(TextReader)

Erstellt mit dem angegebenen Text-Reader eine neue XmlReader-Instanz.

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, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der input-Wert ist null.

Beispiele

Im folgenden Beispiel wird die StringReader Klasse verwendet, um eine XML-Zeichenfolge zu lesen.

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

Eine Standardeinstellung XmlUrlResolver ohne Anmeldeinformationen wird verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Wichtig

Das erstellte XmlReader Objekt erweitert Entitätsbezüge und führt die XML-Normalisierung neuer Zeilenzeichen aus.

Gilt für:

Create(Stream)

Erstellt mit dem angegebenen Stream mit den Standardeinstellungen eine neue XmlReader-Instanz.

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 Stream, der die XML-Daten enthält.

Gibt zurück

XmlReader

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der input-Wert ist null.

SecurityException

Der XmlReader besitzt keine ausreichenden Berechtigungen für den Zugriff auf den Speicherort der XML-Daten.

Beispiele

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

Ein XmlReaderSettings Objekt mit Standardeinstellungen wird verwendet, um den Leser 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 Objekt als eines XmlReaderSettings 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 (DTD), Entitäten, Schemas usw. zuzugreifen.

Wichtig

Das erstellte XmlReader Objekt erweitert Entitätsbezüge und führt die XML-Normalisierung neuer Zeilenzeichen aus.

Gilt für:

Create(String, XmlReaderSettings)

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

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, mit dem die im Stream enthaltenen XML-Daten gelesen werden.

Ausnahmen

ArgumentNullException

Der inputUri-Wert ist null.

FileNotFoundException

Die durch den URI angegebene Datei kann nicht gefunden werden.

UriFormatException

Das URI-Format ist falsch.

Hinweis: In .NET für Windows Store Apps oder die Portable Class Library fangen Sie stattdessen die Basisklasse-Ausnahme ab. FormatException

Beispiele

Im folgenden Beispiel wird ein Objekt erstellt, das die XmlReader Überprüfung der Dokumenttypdefinition (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 Anmeldeinformationen ohne Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Wichtig

Dies bedeutet, dass die XmlReader Speicherorte zugreifen können, die keine Authentifizierung erfordern. 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.

Wichtig

Sie können die Ressourcen einschränken, auf die die XmlReader Eigenschaft zugreifen kann, indem Sie die XmlResolver Eigenschaft auf ein XmlSecureResolver Objekt festlegen.

Das erstellte XmlReader Objekt erweitert Entitätsbezüge und führt die XML-Normalisierung neuer Zeilenzeichen aus.

Gilt für: