Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

XmlReader.Create méthode (Stream, XmlReaderSettings, XmlParserContext)

 

Date de publication : novembre 2016

Crée une instance de XmlReader à l’aide du flux, des paramètres et des informations de contexte d’analyse spécifiés.

Espace de noms:   System.Xml
Assembly:  System.Xml (dans System.Xml.dll)

public static XmlReader Create(
	Stream input,
	XmlReaderSettings settings,
	XmlParserContext inputContext
)

Paramètres

input
Type: System.IO.Stream

Flux contenant les données XML.

XmlReader analyse les premiers octets du flux à la recherche d’une marque d’ordre des octets ou d’un autre signe de codage. Quand l'encodage est déterminé, il est utilisé pour continuer à lire le flux, et le traitement continue à analyser l'entrée en tant que flux de caractères (Unicode).

settings
Type: System.Xml.XmlReaderSettings

Paramètres de la nouvelle instance de XmlReader. Cette valeur peut être null.

inputContext
Type: System.Xml.XmlParserContext

Les informations de contexte nécessaires à l'analyse du fragment XML. Les informations de contexte peuvent inclure le XmlNameTable à utiliser, l’encodage, la portée d’espace de noms, la portée xml:lang et xml:space actuelle, l’URI de base et la définition de type de document.

Cette valeur peut être null.

Valeur de retour

Type: System.Xml.XmlReader

Objet permettant de lire les données XML contenues dans le flux de données.

Exception Condition
ArgumentNullException

La valeur de input est null.

By default an T:System.Xml.XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

System_CAPS_importantImportant

Starting with the .NET Framework 4.5.2, no default T:System.Xml.XmlUrlResolver is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an T:System.Xml.XmlResolver using the P:System.Xml.XmlReaderSettings.XmlResolver property.

If the external resource is located on a network resource that requires authentication, use the P:System.Xml.XmlReaderSettings.XmlResolver property to specify an T:System.Xml.XmlResolver with the necessary credentials.

System_CAPS_security Sécurité Remarque

You can use one of the following methods to control which resources the T:System.Xml.XmlReader can access:

  • Restrict the resources that the T:System.Xml.XmlReader can access by setting the P:System.Xml.XmlReaderSettings.XmlResolver property to an T:System.Xml.XmlSecureResolver object.

-or-

  • Do not allow the T:System.Xml.XmlReader to open any external resources by setting the P:System.Xml.XmlReaderSettings.XmlResolver property to null.

The created T:System.Xml.XmlReader object expands entity references and performs XML normalization of new line characters.

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 2.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: