XmlReader.Create XmlReader.Create XmlReader.Create XmlReader.Create Method

Definition

Erstellt eine neue XmlReader-Instanz.Creates a new XmlReader instance.

Überlädt

Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen URI, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen Text-Reader, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen Stream, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String)

Erstellt mit dem angegebenen Stream, dem Basis-URI und den Einstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance using the specified stream, base URI, and settings.

Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings)

Erstellt mit dem angegebenen XML-Reader und den angegebenen Einstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified XML reader and settings.

Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String)

Erstellt mit dem angegebenen Text-Reader, den angegebenen Einstellungen und dem angegebenen Basis-URI eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings)

Erstellt mit dem angegebenen Text-Reader und den angegebenen Einstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified text reader and settings.

Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings)

Erstellt eine neue XmlReader-Instanz mit dem angegebenen Stream und den angegebenen Einstellungen.Creates a new XmlReader instance with the specified stream and settings.

Create(String) Create(String) Create(String) Create(String)

Erstellt eine neue XmlReader-Instanz mit angegebenem URI.Creates a new XmlReader instance with specified URI.

Create(TextReader) Create(TextReader) Create(TextReader) Create(TextReader)

Erstellt mit dem angegebenen Text-Reader eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified text reader.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Erstellt mit dem angegebenen Stream mit den Standardeinstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance using the specified stream with default settings.

Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings)

Erstellt mit dem angegebenen URI und den angegebenen Einstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified URI and settings.

Beispiele

Dieses Beispiel erstellt einen XML-Reader, der nicht signifikanten Leerraum entfernt, werden Kommentare entfernt und führt auf Konformität überprüft.This example creates an XML reader that strips insignificant white space, strips comments, and performs fragment-level conformance checking.

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

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

Im folgenden Beispiel wird ein XmlUrlResolver mit Standardanmeldeinformationen für den Zugriff auf eine Datei.The following example uses an XmlUrlResolver with default credentials to access a file.

// 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 dient als Wrapper für eine Readerinstanz in einem anderen Reader.The following code wraps a reader instance within another reader.

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 verkettet Leser zum Hinzufügen einer DTD und XML-Schema-Validierung.This example chains readers to add DTD and XML schema validation.

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 der Create -Überladungen enthalten eine settings von akzeptierten Parameter ein XmlReaderSettings Objekt.Most of the Create overloads include a settings parameter that accepts an XmlReaderSettings object. Sie können dieses Objekt zu verwenden:You can use this object to:

  • Angeben, welche Funktionen unterstützt werden soll die XmlReader Objekt.Specify which features you want supported on the XmlReader object.

  • Wiederverwenden der XmlReaderSettings Objekt, das mehrere Leser zu erstellen.Reuse the XmlReaderSettings object to create multiple readers. Sie können dieselben Einstellungen verwenden, um mehrere Reader mit denselben Funktionen zu erstellen.You can use the same settings to create multiple readers with the same functionality. Oder Sie können die Einstellungen ändern, auf eine XmlReaderSettings -Instanz, und erstellen Sie einen neuen Reader mit einem anderen Satz von Features.Or, you can modify the settings on an XmlReaderSettings instance and create a new reader with a different set of features.

  • Hinzufügen von Funktionen zu einer vorhandenen XML-Reader.Add features to an existing XML reader. Die Create-Methode kann ein anderes XmlReader-Objekt annehmen.The Create method can accept another XmlReader object. Die zugrunde liegende XmlReader Objekt kann es sich um einen benutzerdefinierten Reader, ein XmlTextReader Objekt oder einen anderen XmlReader -Instanz, die Sie zusätzliche Funktionen hinzufügen möchten.The underlying XmlReader object can be a user-defined reader, a XmlTextReader object, or another XmlReader instance that you want to add additional features to.

  • Features wie z. B. verbesserte übereinstimmungsprüfung und Übereinstimmung mit voll ausnutzen der XML 1.0 (fourth Edition) Empfehlungen, die nur auf verfügbaren XmlReader Objekte, die von der statischen erstellt Create Methode.Take full advantage of features such as better conformance checking and compliance to the XML 1.0 (fourth edition) recommendation that are available only on XmlReader objects created by the static Create method.

Hinweis

Zwar .NET Framework konkrete Implementierungen der enthält die XmlReader Klasse, z. B. die XmlTextReader, XmlNodeReader, und die XmlValidatingReader Klassen, es wird empfohlen, die Sie erstellen XmlReader Instanzen mit der Create -Methode.Although the .NET Framework includes concrete implementations of the XmlReader class, such as the XmlTextReader, XmlNodeReader, and the XmlValidatingReader classes, we recommend that you create XmlReader instances by using the Create method.

StandardeinstellungenDefault settings

Bei Verwendung einer Create Überladung, die akzeptiert eine XmlReaderSettings Objekt ist, werden die folgenden Standardeinstellungen Reader verwendet:If you use a Create overload that doesn't accept a XmlReaderSettings object, the following default reader settings are used:

EinstellungSetting StandardDefault
CheckCharacters true
ConformanceLevel ConformanceLevel.Document
IgnoreComments false
IgnoreProcessingInstructions false
IgnoreWhitespace false
LineNumberOffset 00
LinePositionOffset 00
NameTable null
DtdProcessing Prohibit
Schemas Ein leeres XmlSchemaSet-Objekt.An empty XmlSchemaSet object
ValidationFlags ProcessIdentityConstraints aktiviertProcessIdentityConstraints enabled
ValidationType None
XmlResolver Ein neues XmlUrlResolver-Objekt.A new XmlUrlResolver object. Ab der .NET Framework-Version 4.5.2 hat diese Einstellung den Standardwert null.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Einstellungen für allgemeine SzenarienSettings for common scenarios

Hier sind die XmlReaderSettings Eigenschaften Sie, für einige typische Szenarien, XML-Reader festlegen sollten.Here are the XmlReaderSettings properties you should set for some of the typical XML reader scenarios.

AnforderungRequirement SetSet
Daten müssen es sich um ein wohlgeformtes XML-Dokument sein.Data must be a well-formed XML document. ConformanceLevel um Document.ConformanceLevel to Document.
Daten müssen eine wohlgeformte analysierte XML-Entität sein.Data must be a well-formed XML parsed entity. ConformanceLevel um Fragment.ConformanceLevel to Fragment.
Daten müssen anhand einer DTD validiert werden.Data must be validated against a DTD. DtdProcessing bis ParseDtdProcessing to Parse
ValidationType um DTD.ValidationType to DTD.
Daten müssen anhand eines XML-Schemas überprüft werden.Data must be validated against an XML schema. ValidationType bis SchemaValidationType to Schema
Schemas um die XmlSchemaSet zur Validierung verwendet.Schemas to the XmlSchemaSet to use for validation. Beachten Sie, dass XmlReader unterstützt keine XML-Data Reduced (XDR)-Schema-Validierung.Note that XmlReader doesn't support XML-Data Reduced (XDR) schema validation.
Daten müssen anhand eines XML-Inlineschemas überprüft werden.Data must be validated against an inline XML schema. ValidationType bis SchemaValidationType to Schema
ValidationFlags um ProcessInlineSchema.ValidationFlags to ProcessInlineSchema.
Geben Sie die Unterstützung.Type support. ValidationType bis SchemaValidationType to Schema
Schemas um die XmlSchemaSet verwenden.Schemas to the XmlSchemaSet to use.

XmlReader Schema-Validierung von XML-Data Reduced (XDR) nicht unterstützt werden.XmlReader doesn't support XML-Data Reduced (XDR) schema validation.

Asynchrone ProgrammierungAsynchronous programming

Im synchronen Modus die Create Methode liest den ersten Datenblock aus dem Puffer für die Datei, diesen Stream oder Text-Reader.In synchronous mode, the Create method reads the first chunk of data from the buffer of the file, stream, or text reader. Dies kann eine Ausnahme auslösen, wenn ein e/a-Vorgang fehlschlägt.This may throw an exception if an I/O operation fails. Im asynchronen Modus tritt auf, der erste e/a-Vorgang mit einem Lesevorgang, damit auftretenden Ausnahmen ausgelöst werden, wenn der Lesevorgang auftritt.In asynchronous mode, the first I/O operation occurs with a read operation, so exceptions that arise will be thrown when the read operation occurs.

SicherheitsüberlegungenSecurity considerations

In der Standardeinstellung die XmlReader verwendet eine XmlUrlResolver Objekt ohne Benutzeranmeldeinformationen, um Ressourcen zu öffnen.By default, the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. Dies bedeutet, dass standardmäßig der XML-Reader einen beliebigen Speicherort zugreifen kann, die keine Anmeldeinformationen erfordert.This means that, by default, the XML reader can access any location that doesn't require credentials. Verwenden der XmlResolver Eigenschaft, um den Zugriff auf Ressourcen zu steuern:Use the XmlResolver property to control access to resources:

- oder - -or-

  • Legen Sie XmlResolver zu null um zu verhindern, dass den XML-Reader keine externen Ressourcen öffnen.Set XmlResolver to null to prevent the XML reader from opening any external resources.

Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen URI, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

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

Der URI der Datei, die die XML-Daten enthält.The URI for the file containing the XML data. Das XmlResolver-Objekt für das XmlReaderSettings-Objekt wird zum Konvertieren des Pfads in eine kanonische Datendarstellung verwendet.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Wenn XmlResolver null ist, wird ein neues XmlUrlResolver-Objekt verwendet.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Die Einstellungen für die neue XmlReader-Instanz.The settings for the new XmlReader instance. Dieser Wert kann null sein.This value can be null.

inputContext
XmlParserContext XmlParserContext XmlParserContext XmlParserContext

Die Kontextinformationen, die zum Analysieren des XML-Fragments erforderlich sind.The context information required to parse the XML fragment. 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.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Dieser Wert kann null sein.This value can be null.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Der inputUri-Wert ist null.The inputUri value is null.

Der XmlReader besitzt keine ausreichenden Berechtigungen für den Zugriff auf den Speicherort der XML-Daten.The XmlReader does not have sufficient permissions to access the location of the XML data.

Die NameTable und NameTable Eigenschaften beide Werte enthalten.The NameTable and NameTable properties both contain values. (Nur eine dieser NameTable-Eigenschaften kann festgelegt sein und verwendet werden.)(Only one of these NameTable properties can be set and used).

Die durch den URI angegebene Datei kann nicht gefunden werden.The file specified by the URI cannot be found.

Das URI-Format ist falsch.The URI format is not correct.

Hinweise

Wird standardmäßig ein XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Dies bedeutet, dass die XmlReader stehen für alle Standorte, die keine Authentifizierung erforderlich ist.This means that the XmlReader can access any locations that does not require authentication. Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erforderlich ist gespeichert ist, verwenden Sie die XmlReaderSettings.XmlResolver -Eigenschaft an eine XmlResolver mit den erforderlichen Anmeldeinformationen.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Wichtig

Sie können die Ressourcen einschränken, die die XmlReader zugreifen können, indem Sie festlegen der XmlResolver Eigenschaft, um eine XmlSecureResolver Objekt.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen Text-Reader, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

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

Der Text-Reader, aus dem die XML-Daten gelesen werden sollen.The text reader from which to read the XML data. 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Die Einstellungen für die neue XmlReader-Instanz.The settings for the new XmlReader instance. Dieser Wert kann null sein.This value can be null.

inputContext
XmlParserContext XmlParserContext XmlParserContext XmlParserContext

Die Kontextinformationen, die zum Analysieren des XML-Fragments erforderlich sind.The context information required to parse the XML fragment. 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.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Dieser Wert kann null sein.This value can be null.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Die NameTable und NameTable Eigenschaften beide Werte enthalten.The NameTable and NameTable properties both contain values. (Nur eine dieser NameTable-Eigenschaften kann festgelegt sein und verwendet werden.)(Only one of these NameTable properties can be set and used).

Beispiele

Das folgende Beispiel erstellt eine XmlReader -Objekt, das Lesen eines XML-Fragments.The following example creates an XmlReader object that reads an XML fragment.

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

Wird standardmäßig ein XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erforderlich ist gespeichert ist, verwenden Sie die XmlReaderSettings.XmlResolver -Eigenschaft an eine XmlResolver mit den erforderlichen Anmeldeinformationen.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Wichtig

Sie können eine der folgenden Methoden steuern, welche Ressourcen die XmlReader zugreifen können:You can use one of the following methods to control which resources the XmlReader can access:

- oder - -or-

  • Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen Stream, den Einstellungen und den Kontextinformationen für Analysezwecke eine neue XmlReader-Instanz.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

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

Der Stream, der die XML-Daten enthält.The stream that contains the XML data.

Der XmlReader überprüft die ersten Bytes des Streams und durchsucht sie nach einer Bytereihenfolgemarkierung oder einem anderen Codierungszeichen.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Nachdem die Codierung bestimmt wurde, wird sie zum weiteren Lesen des Streams verwendet, und die Eingabe wird weiterhin als Stream von (Unicode-)Zeichen analysiert.When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Die Einstellungen für die neue XmlReader-Instanz.The settings for the new XmlReader instance. Dieser Wert kann null sein.This value can be null.

inputContext
XmlParserContext XmlParserContext XmlParserContext XmlParserContext

Die Kontextinformationen, die zum Analysieren des XML-Fragments erforderlich sind.The context information required to parse the XML fragment. 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.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Dieser Wert kann null sein.This value can be null.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Hinweise

Wird standardmäßig ein XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erforderlich ist gespeichert ist, verwenden Sie die XmlReaderSettings.XmlResolver -Eigenschaft an eine XmlResolver mit den erforderlichen Anmeldeinformationen.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Wichtig

Sie können eine der folgenden Methoden steuern, welche Ressourcen die XmlReader zugreifen können:You can use one of the following methods to control which resources the XmlReader can access:

- oder - -or-

  • Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String)

Erstellt mit dem angegebenen Stream, dem Basis-URI und den Einstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance using the specified stream, base URI, and settings.

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

Der Stream, der die XML-Daten enthält.The stream that contains the XML data.

Der XmlReader überprüft die ersten Bytes des Streams und durchsucht sie nach einer Bytereihenfolgemarkierung oder einem anderen Codierungszeichen.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Nachdem die Codierung bestimmt wurde, wird sie zum weiteren Lesen des Streams verwendet, und die Eingabe wird weiterhin als Stream von (Unicode-)Zeichen analysiert.When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Die Einstellungen für die neue XmlReader-Instanz.The settings for the new XmlReader instance. Dieser Wert kann null sein.This value can be null.

baseUri
String String String String

Der Basis-URI der gelesenen Entität oder des gelesenen Dokuments.The base URI for the entity or document being read. Dieser Wert kann null sein.This value can be null.

Sicherheitshinweis Der Basis-URI wird verwendet, um den relativen URI des XML-Dokuments aufzulösen.Security Note The base URI is used to resolve the relative URI of the XML document. Verwenden Sie keinen Basis-URI von einer nicht vertrauenswürdigen Quelle.Do not use a base URI from an untrusted source.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Hinweise

Wird standardmäßig ein XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erforderlich ist gespeichert ist, verwenden Sie die XmlReaderSettings.XmlResolver -Eigenschaft an eine XmlResolver mit den erforderlichen Anmeldeinformationen.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Wichtig

Sie können eine der folgenden Methoden steuern, welche Ressourcen die XmlReader zugreifen können:You can use one of the following methods to control which resources the XmlReader can access:

- oder - -or-

  • Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings)

Erstellt mit dem angegebenen XML-Reader und den angegebenen Einstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified XML reader and 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 XmlReader XmlReader XmlReader

Das Objekt, dass Sie als zugrunde liegenden XML-Reader verwenden möchten.The object that you want to use as the underlying XML reader.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Die Einstellungen für die neue XmlReader-Instanz.The settings for the new XmlReader instance.

Der Konformitätsgrad des XmlReaderSettings-Objekts muss mit dem Konformitätsgrad des zugrunde liegenden Readers übereinstimmen oder auf Auto festgelegt werden.The conformance level of the XmlReaderSettings object must either match the conformance level of the underlying reader, or it must be set to Auto.

Gibt zurück

Ein Objekt, das das angegebene XmlReader-Objekt umschließt.An object that is wrapped around the specified XmlReader object.

Ausnahmen

Der reader-Wert ist null.The reader value is null.

Wenn das XmlReaderSettings-Objekt einen Konformitätsgrad angibt, der mit dem Konformitätsgrad des zugrunde liegenden Readers nicht übereinstimmt.If the XmlReaderSettings object specifies a conformance level that is not consistent with conformance level of the underlying reader.

- oder - -or- Der zugrunde liegende XmlReader befindet im Zustand Error oder Closed.The underlying XmlReader is in an Error or Closed state.

Beispiele

Das folgende Beispiel erstellt ein validierendes XmlReader Objekt, das umschließt ein XmlNodeReader Objekt.The following example creates a validating XmlReader object that is wrapped around an XmlNodeReader object.

// 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 zusätzliche Funktionen hinzufügen, auf ein zugrundeliegendes XmlReader Objekt.This method allows you add additional features to an underlying XmlReader object. Die zugrunde liegende XmlReader Objekt kann es sich um einen anderen XmlReader Objekt erstellt wurde, indem Sie die Create -Methode oder ein XmlReader Objekt erstellt wurde, verwenden eine der konkreten XmlReader Implementierungen.The underlying XmlReader object can be another XmlReader object created by the Create method, or an XmlReader object created using one of the concrete XmlReader implementations.

Eine standardmäßige XmlUrlResolver wird ohne Anmeldeinformationen Zugriff auf externe Ressourcen, z. B. ein Schema verwendet.A default XmlUrlResolver with no credentials is used to access any external resources such as a schema.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erfordert gespeichert ist, geben Sie eine XmlResolver mit den erforderlichen Anmeldeinformationen, die mit der XmlReaderSettings.XmlResolver Eigenschaft.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Wichtig

Sie können eine der folgenden Methoden steuern, welche Ressourcen die XmlReader zugreifen können:You can use one of the following methods to control which resources the XmlReader can access:

- oder - -or-

  • Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String)

Erstellt mit dem angegebenen Text-Reader, den angegebenen Einstellungen und dem angegebenen Basis-URI eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified text reader, settings, and base 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);
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 TextReader TextReader TextReader

Der Text-Reader, aus dem die XML-Daten gelesen werden sollen.The text reader from which to read the XML data. 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XmlReader to decode the data stream.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Die Einstellungen für die neue XmlReader-Instanz.The settings for the new XmlReader instance. Dieser Wert kann null sein.This value can be null.

baseUri
String String String String

Der Basis-URI der gelesenen Entität oder des gelesenen Dokuments.The base URI for the entity or document being read. Dieser Wert kann null sein.This value can be null.

Sicherheitshinweis Der Basis-URI wird verwendet, um den relativen URI des XML-Dokuments aufzulösen.Security Note The base URI is used to resolve the relative URI of the XML document. Verwenden Sie keinen Basis-URI von einer nicht vertrauenswürdigen Quelle.Do not use a base URI from an untrusted source.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Hinweise

Wird standardmäßig ein XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erforderlich ist gespeichert ist, verwenden Sie die XmlReaderSettings.XmlResolver -Eigenschaft an eine XmlResolver mit den erforderlichen Anmeldeinformationen.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Wichtig

Sie können eine der folgenden Methoden steuern, welche Ressourcen die XmlReader zugreifen können:You can use one of the following methods to control which resources the XmlReader can access:

- oder - -or-

  • Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings)

Erstellt mit dem angegebenen Text-Reader und den angegebenen Einstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified text reader and 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 TextReader TextReader TextReader

Der Text-Reader, aus dem die XML-Daten gelesen werden sollen.The text reader from which to read the XML data. 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Die Einstellungen für den neuen XmlReader.The settings for the new XmlReader. Dieser Wert kann null sein.This value can be null.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Hinweise

Wird standardmäßig ein XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erforderlich ist gespeichert ist, verwenden Sie die XmlReaderSettings.XmlResolver -Eigenschaft an eine XmlResolver mit den erforderlichen Anmeldeinformationen.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Wichtig

Sie können eine der folgenden Methoden steuern, welche Ressourcen die XmlReader zugreifen können:You can use one of the following methods to control which resources the XmlReader can access:

- oder - -or-

  • Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings)

Erstellt eine neue XmlReader-Instanz mit dem angegebenen Stream und den angegebenen Einstellungen.Creates a new XmlReader instance with the specified stream and 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 Stream Stream Stream

Der Stream, der die XML-Daten enthält.The stream that contains the XML data.

Der XmlReader überprüft die ersten Bytes des Streams und durchsucht sie nach einer Bytereihenfolgemarkierung oder einem anderen Codierungszeichen.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Nachdem die Codierung bestimmt wurde, wird sie zum weiteren Lesen des Streams verwendet, und die Eingabe wird weiterhin als Stream von (Unicode-)Zeichen analysiert.When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Die Einstellungen für die neue XmlReader-Instanz.The settings for the new XmlReader instance. Dieser Wert kann null sein.This value can be null.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Hinweise

Wird standardmäßig ein XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erforderlich ist gespeichert ist, verwenden Sie die XmlReaderSettings.XmlResolver -Eigenschaft an eine XmlResolver mit den erforderlichen Anmeldeinformationen.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Wichtig

Sie können eine der folgenden Methoden steuern, welche Ressourcen die XmlReader zugreifen können:You can use one of the following methods to control which resources the XmlReader can access:

- oder - -or-

  • Wenn Sie die XmlReader-Eigenschaft auf XmlResolver festlegen, kann der null keine externen Ressourcen öffnen.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String) Create(String) Create(String) Create(String)

Erstellt eine neue XmlReader-Instanz mit angegebenem URI.Creates a new XmlReader instance with specified 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 String String String

Der URI der Datei, die die XML-Daten enthält.The URI for the file that contains the XML data. Mit der XmlUrlResolver-Klasse wird der Pfad in eine kanonische Datendarstellung konvertiert.The XmlUrlResolver class is used to convert the path to a canonical data representation.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Der inputUri-Wert ist null.The inputUri value is null.

Der XmlReader besitzt keine ausreichenden Berechtigungen für den Zugriff auf den Speicherort der XML-Daten.The XmlReader does not have sufficient permissions to access the location of the XML data.

Die durch den URI bezeichnete Datei ist nicht vorhanden.The file identified by the URI does not exist.

Fangen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassenausnahme FormatException ab.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Das URI-Format ist falsch.The URI format is not correct.

Beispiele

Das folgende Beispiel erstellt eine XmlReader -Objekt, das vom URI angegebenen XML-Datendatei liest.The following example creates an XmlReader object that reads XML data file specified by the URI.

// 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 den Standardeinstellungen wird verwendet, um den Reader zu erstellen.An XmlReaderSettings object with default settings is used to create the reader. Wenn Sie die Features zur Unterstützung des erstellten Readers angeben möchten, verwenden Sie die Überladung, die akzeptiert eine XmlReaderSettings -Objekt als eines ihrer Argumente aus, und übergeben ein XmlReaderSettings Objekt mit den richtigen Einstellungen.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Eine standardmäßige XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erfordert gespeichert ist, geben Sie eine XmlResolver mit den erforderlichen Anmeldeinformationen, die mit der XmlReaderSettings.XmlResolver Eigenschaft.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader) Create(TextReader) Create(TextReader) Create(TextReader)

Erstellt mit dem angegebenen Text-Reader eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified text reader.

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

Der Text-Reader, aus dem die XML-Daten gelesen werden sollen.The text reader from which to read the XML data. 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration is not used by the XML reader to decode the data stream.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Beispiele

Im folgenden Beispiel wird die StringReader Klasse, um eine XML-Zeichenfolge zu lesen.The following example uses the StringReader class to read an XML string.

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 den Standardeinstellungen wird verwendet, um den Reader zu erstellen.An XmlReaderSettings object with default settings is used to create the reader. Wenn Sie die Features zur Unterstützung des erstellten Readers angeben möchten, verwenden Sie die Überladung, die akzeptiert eine XmlReaderSettings -Objekt als eines ihrer Argumente aus, und übergeben ein XmlReaderSettings Objekt mit den richtigen Einstellungen.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Eine standardmäßige XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erfordert gespeichert ist, geben Sie eine XmlResolver mit den erforderlichen Anmeldeinformationen, die mit der XmlReaderSettings.XmlResolver Eigenschaft.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

Erstellt mit dem angegebenen Stream mit den Standardeinstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance using the specified stream with default settings.

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

Der Stream, der die XML-Daten enthält.The stream that contains the XML data.

Der XmlReader überprüft die ersten Bytes des Streams und durchsucht sie nach einer Bytereihenfolgemarkierung oder einem anderen Codierungszeichen.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Nachdem die Codierung bestimmt wurde, wird sie zum weiteren Lesen des Streams verwendet, und die Eingabe wird weiterhin als Stream von (Unicode-)Zeichen analysiert.When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Der XmlReader besitzt keine ausreichenden Berechtigungen für den Zugriff auf den Speicherort der XML-Daten.The XmlReader does not have sufficient permissions to access the location of the XML data.

Beispiele

Das folgende Beispiel erstellt eine XmlReader -Objekt, das aus dem liest eine FileStream.The following example creates an XmlReader object that reads from a 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 'FileStream

Hinweise

Ein XmlReaderSettings Objekt mit den Standardeinstellungen wird verwendet, um den Reader zu erstellen.An XmlReaderSettings object with default settings is used to create the reader. Wenn Sie die Features zur Unterstützung des erstellten Readers angeben möchten, verwenden Sie die Überladung, die akzeptiert eine XmlReaderSettings -Objekt als eines ihrer Argumente aus, und übergeben ein XmlReaderSettings Objekt mit den richtigen Einstellungen.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Eine standardmäßige XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erfordert gespeichert ist, geben Sie eine XmlResolver mit den erforderlichen Anmeldeinformationen, die mit der XmlReaderSettings.XmlResolver Eigenschaft.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings)

Erstellt mit dem angegebenen URI und den angegebenen Einstellungen eine neue XmlReader-Instanz.Creates a new XmlReader instance by using the specified URI and settings.

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

Der URI der Datei, die die XML-Daten enthält.The URI for the file containing the XML data. Das XmlResolver-Objekt für das XmlReaderSettings-Objekt wird zum Konvertieren des Pfads in eine kanonische Datendarstellung verwendet.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Wenn XmlResolver null ist, wird ein neues XmlUrlResolver-Objekt verwendet.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

Die Einstellungen für die neue XmlReader-Instanz.The settings for the new XmlReader instance. Dieser Wert kann null sein.This value can be null.

Gibt zurück

Ein Objekt, mit dem die im Stream enthaltenen XML-Daten gelesen werden.An object that is used to read the XML data in the stream.

Ausnahmen

Der inputUri-Wert ist null.The inputUri value is null.

Die durch den URI angegebene Datei kann nicht gefunden werden.The file specified by the URI cannot be found.

Fangen Sie in .NET für Windows Store-Apps oder der portablen Klassenbibliothek stattdessen die Basisklassenausnahme FormatException ab.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Das URI-Format ist falsch.The URI format is not correct.

Beispiele

Das folgende Beispiel erstellt eine XmlReader -Objekt, das Validierung Document Type Definition (DTD) unterstützt.The following example creates an XmlReader object that supports document type definition (DTD) validation.

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

Wird standardmäßig ein XmlUrlResolver ohne Anmeldeinformationen greift auf externen Ressourcen wie z. B. eine Dokumenttypdefinition (DTD), Entitäten, Schemas und So weiter.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Wichtig

Ab .NET Framework 4.5.2 keinen Standardwert XmlUrlResolver wird bereitgestellt.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Wenn Ihre Lösung die .NET Framework 4.5.2 oder höher ausgerichtet ist, geben Sie eine XmlResolver mithilfe der XmlReaderSettings.XmlResolver Eigenschaft.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Dies bedeutet, dass die XmlReader stehen für alle Standorte, die keine Authentifizierung erforderlich ist.This means that the XmlReader can access any locations that does not require authentication. Wenn die externe Ressource auf einer Netzwerkressource, die eine Authentifizierung erforderlich ist gespeichert ist, verwenden Sie die XmlReaderSettings.XmlResolver -Eigenschaft an eine XmlResolver mit den erforderlichen Anmeldeinformationen.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Wichtig

Sie können die Ressourcen einschränken, die die XmlReader zugreifen können, indem Sie festlegen der XmlResolver Eigenschaft, um eine XmlSecureResolver Objekt.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

Das erstellte XmlReader -Objekt Entitätsverweise erweitert, und führt die XML-Normalisierung neue-Zeile-Zeichen.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Gilt für: