Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

XmlReader.Create-Methode (TextReader, XmlReaderSettings, XmlParserContext)

Erstellt mit dem angegebenen Objekten TextReader, XmlReaderSettings und XmlParserContext eine neue XmlReader-Instanz.

Namespace:  System.Xml
Assembly:  System.Xml (in System.Xml.dll)
public static XmlReader Create(
	TextReader input,
	XmlReaderSettings settings,
	XmlParserContext inputContext
)

Parameter

input
Typ: System.IO.TextReader
Der TextReader, aus dem die XML-Daten gelesen werden sollen. Da ein TextReader einen Stream von Unicode-Zeichen zurückgibt, decodiert der XmlReader den Datenstream nicht anhand der in der XML-Deklaration angegebenen Codierung.
settings
Typ: System.Xml.XmlReaderSettings
Das XmlReaderSettings-Objekt zum Konfigurieren der neuen XmlReader-Instanz. Dieser Wert kann null sein.
inputContext
Typ: System.Xml.XmlParserContext
Das XmlParserContext-Objekt, das die zum Analysieren des XML-Fragments erforderlichen Kontextinformationen bereitstellt. Die Kontextinformationen können die zu verwendende XmlNameTable, die Codierung, den Namespacebereich, den aktuellen xml:lang-Bereich, den aktuellen xml:space-Bereich, den Basis-URI und die Dokumenttypdefinition enthalten.
Dieser Wert kann null sein.

Rückgabewert

Typ: System.Xml.XmlReader
Ein XmlReader-Objekt zum Lesen von XML-Daten.
AusnahmeBedingung
ArgumentNullException

Der input-Wert ist null.

ArgumentException

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

Standardmäßig wird ein XmlUrlResolver ohne Anmeldeinformationen verwendet, um auf externe Ressourcen zuzugreifen, z. B. Dokumenttypdefinitionen (DTD), Entitäten, Schemas usw. Wenn die externe Ressource auf einer Netzwerkressource gespeichert ist, für die eine Authentifizierung erforderlich ist, geben Sie mit der XmlReaderSettings.XmlResolver-Eigenschaft einen XmlResolver mit den erforderlichen Anmeldeinformationen an.

SicherheitshinweisSicherheitshinweis

Sie können mit einer der folgenden Methoden steuern, auf welche Ressourcen der XmlReader zugreifen kann:

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

- oder -

Lassen Sie nicht zu, dass der XmlReader durch Festlegen der XmlResolver-Eigenschaft auf null beliebige externe Ressourcen öffnen kann.

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

Im folgenden Beispiel wird ein XmlReader-Objekt zum Lesen eines XML-Fragments erstellt.


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



.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.