XmlReader.Create Methode
Definition
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. |
Hinweise
Weitere Informationen zu dieser API finden Sie in den ergänzenden API-Hinweisen für XmlReader.Close.
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.XmlReaderPublic Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReaderParameter
- 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
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
Der wert inputUri ist null.
Die XmlReader Berechtigung für den Zugriff auf den Speicherort der XML-Daten ist nicht ausreichend.
Die NameTable Beiden NameTable Eigenschaften enthalten Werte. (Nur eine dieser NameTable Eigenschaften kann festgelegt und verwendet werden).
Die durch den URI angegebene Datei wurde nicht gefunden.
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.
Von Bedeutung
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.
Von Bedeutung
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 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.XmlReaderPublic Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReaderParameter
- 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
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
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
Der wert input ist null.
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.
Von Bedeutung
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.
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.
Von Bedeutung
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 die XmlReader Zugreifen können, indem Sie die XmlResolver Eigenschaft auf ein XmlSecureResolver Objekt festlegen.
- oder -
- Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf
nullfestlegen.
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.XmlReaderPublic Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReaderParameter
- 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
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
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
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.
Von Bedeutung
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.
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.
Von Bedeutung
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 die XmlReader Zugreifen können, indem Sie die XmlResolver Eigenschaft auf ein XmlSecureResolver Objekt festlegen.
- oder -
- Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf
nullfestlegen.
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.XmlReaderPublic Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReaderParameter
- 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.
- 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
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
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.
Von Bedeutung
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.
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.
Von Bedeutung
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 die XmlReader Zugreifen können, indem Sie die XmlResolver Eigenschaft auf ein XmlSecureResolver Objekt festlegen.
- oder -
- Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf
nullfestlegen.
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.XmlReaderPublic Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReaderParameter
- 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
Ein Objekt, das um das angegebene XmlReader Objekt herum umbrochen wird.
Ausnahmen
Der wert reader ist null.
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.
Von Bedeutung
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.
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.
Von Bedeutung
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 die XmlReader Zugreifen können, indem Sie die XmlResolver Eigenschaft auf ein XmlSecureResolver Objekt festlegen.
- oder -
- Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf
nullfestlegen.
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.XmlReaderPublic Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReaderParameter
- 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
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
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.
Von Bedeutung
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.
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.
Von Bedeutung
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 die XmlReader Zugreifen können, indem Sie die XmlResolver Eigenschaft auf ein XmlSecureResolver Objekt festlegen.
- oder -
- Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf
nullfestlegen.
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.XmlReaderPublic Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReaderParameter
- 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 das neue XmlReader. Dieser Wert kann null sein.
Gibt zurück
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
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.
Von Bedeutung
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.
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.
Von Bedeutung
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 die XmlReader Zugreifen können, indem Sie die XmlResolver Eigenschaft auf ein XmlSecureResolver Objekt festlegen.
- oder -
- Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf
nullfestlegen.
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.XmlReaderPublic Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReaderParameter
- 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.
Gibt zurück
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
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.
Von Bedeutung
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.
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.
Von Bedeutung
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 die XmlReader Zugreifen können, indem Sie die XmlResolver Eigenschaft auf ein XmlSecureResolver Objekt festlegen.
- oder -
- Lassen Sie nicht zu, dass XmlReader externe Ressourcen öffnet, indem Sie die XmlResolver-Eigenschaft auf
nullfestlegen.
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.XmlReaderPublic Shared Function Create (inputUri As String) As XmlReaderParameter
- 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
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
Der wert inputUri ist null.
Die XmlReader Berechtigung für den Zugriff auf den Speicherort der XML-Daten ist nicht ausreichend.
Die durch den URI identifizierte Datei ist nicht vorhanden.
Das URI-Format ist nicht korrekt.
Hinweis: In .NET für Windows Store-Apps oder der portablen Klassenbibliothek erfassen Sie stattdessen die Basisklassen-Ausnahme. 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.
Von Bedeutung
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.
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.
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.XmlReaderPublic Shared Function Create (input As TextReader) As XmlReaderParameter
- 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.
Gibt zurück
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
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
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.
Von Bedeutung
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.
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.
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.XmlReaderPublic Shared Function Create (input As Stream) As XmlReaderParameter
- 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.
Gibt zurück
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
Der wert input ist null.
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
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.
Von Bedeutung
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.
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.
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.XmlReaderPublic Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReaderParameter
- 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.
Gibt zurück
Ein Objekt, das zum Lesen der XML-Daten im Datenstrom verwendet wird.
Ausnahmen
Der wert inputUri ist null.
Die durch den URI angegebene Datei wurde nicht gefunden.
Das URI-Format ist nicht korrekt.
Hinweis: In .NET für Windows Store-Apps oder der portablen Klassenbibliothek erfassen Sie stattdessen die Basisklassen-Ausnahme. 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.
Von Bedeutung
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.
Von Bedeutung
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 durch.
