XmlReader.Create Methode

Definition

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.

Hinweise

Weitere Informationen zu dieser API finden Sie unter Zusätzliche API-Hinweise für XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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-Bereich, den aktuellen xml:space-Bereich, den Basis-URI und die Dokumenttypdefinition enthalten.

Dieser Wert kann null sein.

Gibt zurück

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

Ausnahmen

Der inputUri-Wert ist null.

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

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

Die durch den URI angegebene Datei kann nicht gefunden werden.

Das URI-Format ist falsch.

Hinweise

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen ausgerichtet ist, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine anXmlResolver.

Dies bedeutet, dass der XmlReader auf alle Speicherorte zugreifen kann, 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 der XmlReader zugreifen kann, 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 durch.

Gilt für:

Create(TextReader, XmlReaderSettings, XmlParserContext)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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

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-Bereich, den aktuellen xml:space-Bereich, den Basis-URI und die Dokumenttypdefinition enthalten.

Dieser Wert kann null sein.

Gibt zurück

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

Ausnahmen

Der input-Wert ist null.

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 ein XmlUrlResolver ohne Anmeldeinformationen verwendet, um auf externe Ressourcen wie eine Dokumenttypdefinition (DTD), Entitäten, Schemas usw. zuzugreifen.

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen ausgerichtet ist, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine anXmlResolver.

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 der XmlReader zugreifen kann:

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

Gilt für:

Create(Stream, XmlReaderSettings, XmlParserContext)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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

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-Bereich, den aktuellen xml:space-Bereich, den Basis-URI und die Dokumenttypdefinition enthalten.

Dieser Wert kann null sein.

Gibt zurück

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

Ausnahmen

Der input-Wert ist null.

Hinweise

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen ausgerichtet ist, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine anXmlResolver.

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 der XmlReader zugreifen kann:

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

Gilt für:

Create(Stream, XmlReaderSettings, String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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.

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.

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 aufzulösen. Verwenden Sie keinen Basis-URI von einer nicht vertrauenswürdigen Quelle.

Gibt zurück

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

Ausnahmen

Der input-Wert ist null.

Hinweise

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen abzielt, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine XmlResolver an.

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

Wichtig

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

- 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 eine XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(XmlReader, XmlReaderSettings)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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

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

Ausnahmen

Der reader-Wert ist null.

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 Validierungsobjekt XmlReader erstellt, das um ein XmlNodeReader Objekt umschlossen 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 Standard XmlUrlResolver ohne Anmeldeinformationen wird verwendet, um auf externe Ressourcen wie ein Schema zuzugreifen.

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen abzielt, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine XmlResolver an.

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

Wichtig

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

- 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 eine XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(TextReader, XmlReaderSettings, String)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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 aufzulösen. Verwenden Sie keinen Basis-URI von einer nicht vertrauenswürdigen Quelle.

Gibt zurück

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

Ausnahmen

Der input-Wert ist null.

Hinweise

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen abzielt, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine XmlResolver an.

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

Wichtig

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

- 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 eine XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(TextReader, XmlReaderSettings)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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

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

Gibt zurück

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

Ausnahmen

Der input-Wert ist null.

Hinweise

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen abzielt, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine XmlResolver an.

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

Wichtig

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

- 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 eine XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(Stream, XmlReaderSettings)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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.

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.

Gibt zurück

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

Ausnahmen

Der input-Wert ist null.

Hinweise

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen abzielt, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine XmlResolver an.

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

Wichtig

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

- 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 eine XML-Normalisierung neuer Zeilenzeichen durch.

Gilt für:

Create(String)

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

Gibt zurück

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

Ausnahmen

Der inputUri-Wert ist null.

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

Die durch den URI bezeichnete Datei ist nicht vorhanden.

Das URI-Format ist falsch.

Hinweis: Erfassen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassen-Ausnahme FormatException.

Beispiele

Im folgenden Beispiel wird ein XmlReader Objekt erstellt, das die vom 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 ihrer Argumente akzeptiert, und übergeben Sie ein XmlReaderSettings Objekt mit den richtigen Einstellungen.

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen abzielt, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine XmlResolver an.

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

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

Gilt für:

Create(TextReader)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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

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.

Gibt zurück

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

Ausnahmen

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

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 ihrer Argumente akzeptiert, und übergeben Sie ein XmlReaderSettings Objekt mit den richtigen Einstellungen.

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen abzielt, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine XmlResolver an.

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

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

Gilt für:

Create(Stream)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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.

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.

Gibt zurück

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

Ausnahmen

Der input-Wert ist null.

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 einem FileStreamliest.


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 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 ihrer Argumente akzeptiert, und übergeben Sie ein XmlReaderSettings Objekt mit den richtigen Einstellungen.

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen abzielt, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine XmlResolver an.

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

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

Gilt für:

Create(String, XmlReaderSettings)

Quelle:
XmlReader.cs
Quelle:
XmlReader.cs
Quelle:
XmlReader.cs

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

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.

Gibt zurück

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

Ausnahmen

Der inputUri-Wert ist null.

Die durch den URI angegebene Datei kann nicht gefunden werden.

Das URI-Format ist falsch.

Hinweis: Erfassen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassen-Ausnahme FormatException.

Beispiele

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

Wichtig

Ab .NET Framework 4.5.2 wird kein Standardwert XmlUrlResolver bereitgestellt. Wenn Ihre Lösung auf .NET Framework 4.5.2 oder höhere Versionen abzielt, geben Sie mithilfe der XmlReaderSettings.XmlResolver -Eigenschaft eine XmlResolver an.

Dies bedeutet, dass der XmlReader auf alle Speicherorte zugreifen kann, die keine Authentifizierung erfordern. Wenn sich die externe Ressource in einer Netzwerkressource befindet, die eine Authentifizierung erfordert, verwenden Sie die XmlReaderSettings.XmlResolver -Eigenschaft, um ein XmlResolver mit den erforderlichen Anmeldeinformationen anzugeben.

Wichtig

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

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

Gilt für: