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.

XmlReaderSettings-Klasse

Gibt einen Satz von Features an, die für das von der Create-Methode erstellte XmlReader-Objekt unterstützt werden sollen.

System.Object
  System.Xml.XmlReaderSettings

Namespace:  System.Xml
Assembly:  System.Xml (in System.Xml.dll)
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public sealed class XmlReaderSettings

Der XmlReaderSettings-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsXmlReaderSettings()Initialisiert eine neue Instanz der XmlReaderSettings-Klasse.
Öffentliche MethodeXmlReaderSettings(XmlResolver) Veraltet. Initialisiert eine neue Instanz der XmlReaderSettings-Klasse.
Zum Seitenanfang
  NameBeschreibung
Öffentliche EigenschaftUnterstützt in .NET für Windows Store-AppsAsyncRuft ab oder legt fest, ob asynchrone Methoden XmlReader für eine bestimmte XmlReader-Instanz verwendet werden können.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCheckCharactersRuft einen Wert ab, der angibt, ob Zeichen überprüft werden sollen, oder legt diesen fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCloseInputRuft einen Wert ab, der angibt, ob der zugrunde liegende Stream oder TextReader geschlossen werden soll, nachdem der Reader geschlossen wurde, oder legt diesen Wert fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsConformanceLevelRuft den Konformitätsgrad ab, dem der XmlReader entspricht, oder legt diesen fest.
Öffentliche EigenschaftUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsDtdProcessingRuft einen Wert ab oder legt einen Wert fest, der die Verarbeitung von DTDs bestimmt.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsIgnoreCommentsRuft einen Wert ab, der angibt, ob Kommentare ignoriert werden sollen, oder legt diesen fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsIgnoreProcessingInstructionsRuft einen Wert ab, der angibt, ob Verarbeitungsanweisungen ignoriert werden sollen, oder legt diesen fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsIgnoreWhitespaceRuft einen Wert ab, der angibt, ob signifikanter Leerraum ignoriert werden soll, oder legt diesen Wert fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsLineNumberOffsetRuft das Zeilennummernoffset des XmlReader-Objekts ab oder legt dieses fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsLinePositionOffsetRuft das Zeilenpositionsoffset des XmlReader-Objekts ab oder legt dieses fest.
Öffentliche EigenschaftUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMaxCharactersFromEntitiesRuft einen Wert ab, der die maximal zulässige Anzahl von Zeichen in einem Dokument angibt, die aus dem Erweitern von Entitäten resultieren, oder legt diesen fest.
Öffentliche EigenschaftUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMaxCharactersInDocumentRuft einen Wert ab, der die maximale zulässige Anzahl von Zeichen in einem XML-Dokument angibt, oder legt diesen fest. Der Wert 0 (null) gibt an, dass die Größe des XML-Dokuments nicht beschränkt ist. Ein Wert ungleich 0 (null) gibt die maximale Größe in Zeichen an.
Öffentliche EigenschaftUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsNameTableRuft die für Vergleiche von atomisierten Zeichenfolgen verwendete XmlNameTable ab oder legt diese fest.
Öffentliche EigenschaftProhibitDtd Veraltet. Ruft einen Wert ab, der angibt, ob eine DTD-Verarbeitung (Document Type Definition, Dokumenttypdefinition) verhindert werden soll, oder legt diesen fest. Diese Eigenschaft ist veraltet. Verwenden Sie stattdessen DtdProcessing.
Öffentliche EigenschaftUnterstützt von XNA FrameworkSchemasRuft das XmlSchemaSet ab, das beim Ausführen einer Schemavalidierung verwendet werden soll, oder legt dieses fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkValidationFlagsRuft einen Wert ab, der die Schemavalidierungseinstellungen angibt, oder legt diesen fest. Diese Einstellung wird für XmlReader-Objekte zur Schemavalidierung angewendet (die ValidationType-Eigenschaft ist auf ValidationType.Schema festgelegt).
Öffentliche EigenschaftUnterstützt von XNA FrameworkValidationTypeRuft einen Wert fest, der angibt, ob der XmlReader beim Lesen eine Validierung oder Typzuweisung ausführt, oder legt diesen Wert fest.
Öffentliche EigenschaftUnterstützt von XNA FrameworkXmlResolverLegt den XmlResolver fest, der für den Zugriff auf externe Dokumente verwendet wird.
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCloneErstellt eine Kopie der XmlReaderSettings-Instanz.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetHashCodeFungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsResetSetzt die Member der settings-Klasse auf ihre Standardwerte zurück.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang
  NameBeschreibung
Öffentliches EreignisUnterstützt von XNA FrameworkValidationEventHandlerTritt ein, wenn der Reader Validierungsfehler feststellt.
Zum Seitenanfang

In der Version .NET Framework 2.0 stellt die Create-Methode den bevorzugten Mechanismus zum Abrufen von XmlReader-Instanzen dar. Die Create-Methode gibt mithilfe der XmlReaderSettings-Klasse an, welche Features im erstellten XmlReader-Objekt implementiert werden sollen.

Weitere Informationen finden Sie unter Creating XML Readers.

Sicherheitsüberlegungen

Berücksichtigen Sie die folgenden Aspekte beim Verwenden der XmlReaderSettings-Klasse.

  • Das ProcessInlineSchema-Validierungsflag und das ProcessSchemaLocation-Validierungsflag eines XmlReaderSettings-Objekts sind in der Standardeinstellung nicht festgelegt. Wenn diese Flags festgelegt werden, wird der XmlResolver des XmlReaderSettings-Objekts zum Auflösen von im Instanzendokument angegebenen Schemaspeicherorten im XmlReader verwendet. Wenn das XmlResolver-Objekt null ist, werden Schemaspeicherorte auch dann nicht aufgelöst, wenn das ProcessInlineSchema-Validierungsflag und das ProcessSchemaLocation-Validierungsflag festgelegt wurden.

  • Durch während der Validierung hinzugefügte Schemas werden neue Typen hinzugefügt, sodass das Validierungsergebnis des überprüften Dokuments möglicherweise geändert wird. Deshalb sollten externe Schemas nur von vertrauenswürdigen Quellen aufgelöst werden.

  • Validierungsfehlermeldungen machen möglicherweise vertrauliche Inhaltsmodellinformationen verfügbar. Validierungsfehlermeldungen und Warnmeldungen werden mit dem ValidationEventHandler-Delegaten behandelt oder als XmlSchemaValidationException verfügbar gemacht, wenn für das XmlReaderSettings-Objekt kein Ereignishandler bereitgestellt wird (durch Validierungswarnungen wird keine XmlSchemaValidationException ausgelöst). Diese Inhaltsmodellinformationen dürfen in nicht vertrauenswürdigen Szenarios nicht verfügbar gemacht werden. Validierungswarnmeldungen werden standardmäßig unterdrückt und können gemeldet werden, indem das ReportValidationWarnings-Flag festgelegt wird.

  • Die SourceUri-Eigenschaft einer XmlSchemaValidationException gibt den URI-Pfad der Schemadatei zurück, die die Ausnahme verursacht hat. Die SourceUri-Eigenschaft darf in nicht vertrauenswürdigen Szenarios nicht verfügbar gemacht werden.

  • Beim Überprüfen nicht vertrauenswürdiger großer XML-Dokumente in Szenarios mit hoher Verfügbarkeit anhand eines Schemas mit Identitätseinschränkungen in einem großen Teil des Dokuments wird das Deaktivieren des ProcessIdentityConstraints-Flags (standardmäßig aktiviert) empfohlen.

  • XmlReaderSettings -Objekte können vertrauliche Informationen enthalten, z. B. Benutzeranmeldeinformationen. Gehen Sie beim Zwischenspeichern von XmlReaderSettings-Objekten oder beim Übergeben des XmlReaderSettings-Objekts von einer Komponente an eine andere vorsichtig vor.

  • Die DTD-Verarbeitung ist standardmäßig deaktiviert. Wenn Sie die DTD-Verarbeitung aktivieren, müssen Sie auf einschließende DTDs aus nicht vertrauenswürdigen Quellen und eventuelle Denial-of-Service-Angriffe achten. Beschränken Sie mithilfe des XmlSecureResolver die Ressourcen, auf die der XmlReader zugreifen kann.

  • Akzeptieren Sie von einer nicht vertrauenswürdigen Quelle keine Hilfskomponenten, z. B. die Objekte NameTable, XmlNamespaceManager und XmlResolver.

  • Zwischen der Speicherauslastung einer Anwendung, die XmlReader verwendet, und der Größe des analysierten XML-Dokuments besteht möglicherweise eine Wechselbeziehung. Eine Form des Denial-of-Service-Angriff liegt vor, wenn übermäßig große XML-Dokumente zur Analyse übermittelt werden. Sie können die Größe des analysierten Dokuments beshcränken, indem Sie die MaxCharactersInDocument-Eigenschaft festlegen und anschließend durch Festlegen der MaxCharactersFromEntities-Eigenschaft die Anzahl der Zeichen beschränken, die beim Erweitern von Entitäten entstehen.

Im folgenden Beispiel wird ein XmlReader erstellt, der einen XmlUrlResolver mit den erforderlichen Anmeldeinformationen verwendet.


// Create an XmlUrlResolver with the credentials necessary to access the Web server.
XmlUrlResolver resolver = new XmlUrlResolver();
System.Net.NetworkCredential myCred;
myCred  = new System.Net.NetworkCredential(UserName,SecurelyStoredPassword,Domain);  
resolver.Credentials = myCred;

XmlReaderSettings settings = new XmlReaderSettings();
settings.XmlResolver = resolver;

// Create the reader.
XmlReader reader = XmlReader.Create("http://serverName/data/books.xml", settings);


.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.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.