XmlReader.Create Méthode

Définition

Espace de noms:: System.Xml

Assemblys:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Assemblys:: System.Xml.dll, System.Xml.ReaderWriter.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Crée une nouvelle instance XmlReader.

Surcharges

Nom	Description
Create(String, XmlReaderSettings, XmlParserContext)	Crée une XmlReader instance à l’aide de l’URI, des paramètres et des informations de contexte spécifiées pour l’analyse.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Crée une XmlReader instance à l’aide du lecteur de texte, des paramètres et des informations de contexte spécifiées pour l’analyse.
Create(Stream, XmlReaderSettings, XmlParserContext)	Crée une XmlReader instance à l’aide du flux, des paramètres et des informations de contexte spécifiés pour l’analyse.
Create(Stream, XmlReaderSettings, String)	Crée une XmlReader instance à l’aide du flux, de l’URI de base et des paramètres spécifiés.
Create(XmlReader, XmlReaderSettings)	Crée une XmlReader instance à l’aide du lecteur et des paramètres XML spécifiés.
Create(TextReader, XmlReaderSettings, String)	Crée une XmlReader instance à l’aide du lecteur de texte, des paramètres et de l’URI de base spécifiés.
Create(TextReader, XmlReaderSettings)	Crée une XmlReader instance à l’aide du lecteur de texte et des paramètres spécifiés.
Create(Stream, XmlReaderSettings)	Crée une XmlReader instance avec le flux et les paramètres spécifiés.
Create(String)	Crée une XmlReader instance avec l’URI spécifié.
Create(TextReader)	Crée une XmlReader instance à l’aide du lecteur de texte spécifié.
Create(Stream)	Crée une XmlReader instance à l’aide du flux spécifié avec les paramètres par défaut.
Create(String, XmlReaderSettings)	Crée une XmlReader instance à l’aide de l’URI et des paramètres spécifiés.

Exemples

Cet exemple crée un lecteur XML qui supprime des espaces blancs non significatifs, supprime les commentaires et vérifie la conformité au niveau des fragments.

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)

L’exemple suivant utilise des informations d’identification XmlUrlResolver par défaut pour accéder à un fichier.

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

Le code suivant encapsule une instance de lecteur au sein d’un autre lecteur.

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)

Cet exemple montre comment chaîner les lecteurs pour ajouter la validation de schéma DTD et XML.

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

Remarques

La plupart des Create surcharges incluent un settings paramètre qui accepte un XmlReaderSettings objet. Vous pouvez utiliser cet objet pour :

Spécifiez les fonctionnalités que vous souhaitez prendre en charge sur l’objet XmlReader .
Réutilisez l’objet XmlReaderSettings pour créer plusieurs lecteurs. Vous pouvez utiliser les mêmes paramètres pour créer plusieurs lecteurs avec la même fonctionnalité. Vous pouvez également modifier les paramètres d’une XmlReaderSettings instance et créer un lecteur avec un ensemble différent de fonctionnalités.
Ajoutez des fonctionnalités à un lecteur XML existant. La Create méthode peut accepter un autre XmlReader objet. L’objet sous-jacent XmlReader peut être un lecteur défini par l’utilisateur, un XmlTextReader objet ou une autre XmlReader instance à laquelle vous souhaitez ajouter des fonctionnalités supplémentaires.
Tirez pleinement parti des fonctionnalités telles que la vérification de la conformité et la conformité à la recommandation XML 1.0 (quatrième édition) qui ne sont disponibles que sur XmlReader les objets créés par la méthode statique Create .

Note

Bien que .NET inclut des implémentations concrètes de la classe XmlReader, telles que les classes XmlTextReader, XmlNodeReader, et XmlValidatingReader, nous vous recommandons de créer une instance XmlReader à l’aide de la méthode Create.

Paramètres par défaut

Si vous utilisez une surcharge Create qui n’accepte pas un objet XmlReaderSettings, les paramètres de lecture par défaut suivants sont utilisés :

Setting	Default
CheckCharacters	`true`
ConformanceLevel	ConformanceLevel.Document
IgnoreComments	`false`
IgnoreProcessingInstructions	`false`
IgnoreWhitespace	`false`
LineNumberOffset	0
LinePositionOffset	0
NameTable	`null`
DtdProcessing	Prohibit
Schemas	Objet vide XmlSchemaSet
ValidationFlags	ProcessIdentityConstraints Activé
ValidationType	None
XmlResolver	`null`

Paramètres pour les scénarios courants

Voici les XmlReaderSettings propriétés que vous devez définir pour certains des scénarios de lecteur XML classiques.

Requirement	Définissez
Les données doivent être un document XML bien formé.	ConformanceLevel à Document.
Les données doivent être une entité analysée XML bien formée.	ConformanceLevel à Fragment.
Les données doivent être validées par rapport à un DTD.	De DtdProcessing à Parse. ValidationType à DTD.
Les données doivent être validées par rapport à un schéma XML.	De ValidationType à Schema. Schemas à XmlSchemaSet à utiliser pour la validation. Notez que XmlReader ne prend pas en charge la validation de schéma XML-Data Reduced (XDR).
Les données doivent être validées par rapport à un schéma XML inline.	De ValidationType à Schema. ValidationFlags à ProcessInlineSchema.
Prise en charge des types.	De ValidationType à Schema. Schemas à l’objet XmlSchemaSet à utiliser.

XmlReader ne prend pas en charge la validation du schéma XML-Data Reduced (XDR).

Programmation asynchrone

En mode synchrone, la Create méthode lit le premier segment de données à partir de la mémoire tampon du fichier, du flux ou du lecteur de texte. Cela peut générer une exception si une opération d’E/S échoue. En mode asynchrone, la première opération d’E/S se produit avec une opération de lecture, de sorte que les exceptions qui se produisent seront levées lorsque l’opération de lecture se produit.

Considérations relatives à la sécurité

Par défaut, l’objet XmlReader utilise un XmlUrlResolver objet sans informations d’identification utilisateur pour ouvrir des ressources. Cela signifie que, par défaut, le lecteur XML peut accéder à n’importe quel emplacement qui ne nécessite pas d’informations d’identification. Utilisez la propriété XmlResolver pour contrôler l’accès aux ressources :

Permet ThrowingResolver de restreindre les ressources auxquelles le lecteur XML peut accéder, ou...
Définissez XmlResolver sur null pour empêcher le lecteur XML d’ouvrir des ressources externes.

Create(String, XmlReaderSettings, XmlParserContext)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide de l’URI, des paramètres et des informations de contexte spécifiées pour l’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.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Paramètres

inputUri: String

URI du fichier contenant les données XML. L’objet XmlResolver sur l’objet XmlReaderSettings est utilisé pour convertir le chemin d’accès en représentation de données canoniques. Si XmlResolver c’est nullle cas, un nouvel XmlUrlResolver objet est utilisé.

settings: XmlReaderSettings

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

inputContext: XmlParserContext

Informations de contexte requises pour analyser le fragment XML. Les informations de contexte peuvent inclure l’utilisation, l’encodage XmlNameTable , l’étendue de l’espace de noms, l’étendue actuelle xml:lang et xml:space l’étendue, l’URI de base et la définition de type de document.

Cette valeur peut être null.

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La inputUri valeur est null.

SecurityException

Il XmlReader ne dispose pas des autorisations suffisantes pour accéder à l’emplacement des données XML.

ArgumentException

Les NameTable propriétés et NameTable les deux contiennent des valeurs. (Une seule de ces NameTable propriétés peut être définie et utilisée).

FileNotFoundException

Le fichier spécifié par l’URI est introuvable.

UriFormatException

Le format d’URI n’est pas correct.

Remarques

Par défaut, aucune XmlUrlResolver information d’identification n’est utilisée pour accéder à des ressources externes telles qu’une définition de type de document (DTD), des entités, des schémas, etc.

Important

À compter de .NET Framework 4.5.2, aucune valeur par défaut XmlUrlResolver n’est fournie. Si votre solution cible .NET Framework 4.5.2 ou versions ultérieures, spécifiez une XmlResolver propriété à l’aide de la XmlReaderSettings.XmlResolver propriété.

Cela signifie que le XmlReader serveur peut accéder à tous les emplacements qui ne nécessitent pas d’authentification. Si la ressource externe se trouve sur une ressource réseau qui nécessite une authentification, utilisez la XmlReaderSettings.XmlResolver propriété pour spécifier les XmlResolver informations d’identification nécessaires.

Important

Vous pouvez restreindre les ressources auxquelles l’accès est possible à l’aide XmlReader ThrowingResolverde .

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(TextReader, XmlReaderSettings, XmlParserContext)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide du lecteur de texte, des paramètres et des informations de contexte spécifiées pour l’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.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Paramètres

input: TextReader

Lecteur de texte à partir duquel lire les données XML. Un lecteur de texte retourne un flux de caractères Unicode, de sorte que l’encodage spécifié dans la déclaration XML n’est pas utilisé par le lecteur XML pour décoder le flux de données.

settings: XmlReaderSettings

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

inputContext: XmlParserContext

Cette valeur peut être null.

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La input valeur est null.

ArgumentException

Les NameTable propriétés et NameTable les deux contiennent des valeurs. (Une seule de ces NameTable propriétés peut être définie et utilisée.)

Exemples

L’exemple suivant crée un XmlReader objet qui lit un fragment XML.

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)

Remarques

Important

Si la ressource externe se trouve sur une ressource réseau qui nécessite une authentification, utilisez la XmlReaderSettings.XmlResolver propriété pour spécifier les XmlResolver informations d’identification nécessaires.

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles les XmlReader utilisateurs peuvent accéder :

Limitez les ressources auxquelles l’accès XmlReader peut être utilisé à l’aide ThrowingResolverde .
N'autorisez pas XmlReader d'ouvrir des ressources externes en définissant la propriété XmlResolver sur null.

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(Stream, XmlReaderSettings, XmlParserContext)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide du flux, des paramètres et des informations de contexte spécifiés pour l’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.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, inputContext As XmlParserContext) As XmlReader

Paramètres

input: Stream

Flux qui contient les données XML.

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

settings: XmlReaderSettings

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

inputContext: XmlParserContext

Cette valeur peut être null.

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La input valeur est null.

Remarques

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles les XmlReader utilisateurs peuvent accéder :

Limitez les ressources auxquelles l’accès XmlReader peut être utilisé à l’aide ThrowingResolverde .
N'autorisez pas XmlReader d'ouvrir des ressources externes en définissant la propriété XmlResolver sur null.

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(Stream, XmlReaderSettings, String)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide du flux, de l’URI de base et des paramètres spécifiés.

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.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings, baseUri As String) As XmlReader

Paramètres

input: Stream

Flux qui contient les données XML.

settings: XmlReaderSettings

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

baseUri: String

URI de base de l’entité ou du document en cours de lecture. Cette valeur peut être null.

Note de sécurité L’URI de base est utilisé pour résoudre l’URI relatif du document XML. N’utilisez pas d’URI de base à partir d’une source non approuvée.

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La input valeur est null.

Remarques

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles les XmlReader utilisateurs peuvent accéder :

Limitez les ressources auxquelles l’accès XmlReader peut être utilisé à l’aide ThrowingResolverde .
N'autorisez pas XmlReader d'ouvrir des ressources externes en définissant la propriété XmlResolver sur null.

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(XmlReader, XmlReaderSettings)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide du lecteur et des paramètres XML spécifiés.

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.XmlReader

Public Shared Function Create (reader As XmlReader, settings As XmlReaderSettings) As XmlReader

Paramètres

reader: XmlReader

Objet que vous souhaitez utiliser comme lecteur XML sous-jacent.

settings: XmlReaderSettings

Paramètres de la nouvelle XmlReader instance.

Le niveau de conformité de l’objet XmlReaderSettings doit correspondre au niveau de conformité du lecteur sous-jacent, ou il doit être défini sur Auto.

Retours

XmlReader

Objet encapsulé autour de l’objet spécifié XmlReader .

Exceptions

ArgumentNullException

La reader valeur est null.

InvalidOperationException

Si l’objet XmlReaderSettings spécifie un niveau de conformité qui n’est pas cohérent avec le niveau de conformité du lecteur sous-jacent.

- ou -

Le sous-jacent XmlReader est dans un état ou Error dans un Closed état.

Exemples

L’exemple suivant crée un objet de validation qui est encapsulé XmlReader autour d’un XmlNodeReader objet.

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

Remarques

Cette méthode vous permet d’ajouter des fonctionnalités supplémentaires à un objet sous-jacent XmlReader . L’objet sous-jacent XmlReader peut être un autre XmlReader objet créé par la Create méthode ou un XmlReader objet créé à l’aide de l’une des implémentations concrètes XmlReader .

Une valeur par défaut XmlUrlResolver sans informations d’identification n’est utilisée pour accéder à toutes les ressources externes telles qu’un schéma.

Important

Si la ressource externe se trouve sur une ressource réseau qui nécessite une authentification, spécifiez une XmlResolver avec les informations d’identification nécessaires à l’aide de la XmlReaderSettings.XmlResolver propriété.

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles les XmlReader utilisateurs peuvent accéder :

Limitez les ressources auxquelles l’accès XmlReader peut être utilisé à l’aide ThrowingResolverde .
N'autorisez pas XmlReader d'ouvrir des ressources externes en définissant la propriété XmlResolver sur null.

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(TextReader, XmlReaderSettings, String)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide du lecteur de texte, des paramètres et de l’URI de base spécifiés.

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.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings, baseUri As String) As XmlReader

Paramètres

input: TextReader

settings: XmlReaderSettings

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

baseUri: String

URI de base de l’entité ou du document en cours de lecture. Cette valeur peut être null.

Note de sécurité L’URI de base est utilisé pour résoudre l’URI relatif du document XML. N’utilisez pas d’URI de base à partir d’une source non approuvée.

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La input valeur est null.

Remarques

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles les XmlReader utilisateurs peuvent accéder :

Limitez les ressources auxquelles l’accès XmlReader peut être utilisé à l’aide ThrowingResolverde .
N'autorisez pas XmlReader d'ouvrir des ressources externes en définissant la propriété XmlResolver sur null.

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(TextReader, XmlReaderSettings)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide du lecteur de texte et des paramètres spécifiés.

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.XmlReader

Public Shared Function Create (input As TextReader, settings As XmlReaderSettings) As XmlReader

Paramètres

input: TextReader

settings: XmlReaderSettings

Paramètres du nouveau XmlReader. Cette valeur peut être null.

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La input valeur est null.

Remarques

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles les XmlReader utilisateurs peuvent accéder :

Limitez les ressources auxquelles l’accès XmlReader peut être utilisé à l’aide ThrowingResolverde .
N'autorisez pas XmlReader d'ouvrir des ressources externes en définissant la propriété XmlResolver sur null.

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(Stream, XmlReaderSettings)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance avec le flux et les paramètres spécifiés.

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.XmlReader

Public Shared Function Create (input As Stream, settings As XmlReaderSettings) As XmlReader

Paramètres

input: Stream

Flux qui contient les données XML.

settings: XmlReaderSettings

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

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La input valeur est null.

Remarques

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles les XmlReader utilisateurs peuvent accéder :

Limitez les ressources auxquelles l’accès XmlReader peut être utilisé à l’aide ThrowingResolverde .
N'autorisez pas XmlReader d'ouvrir des ressources externes en définissant la propriété XmlResolver sur null.

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(String)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance avec l’URI spécifié.

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

Paramètres

inputUri: String

URI du fichier qui contient les données XML. La XmlUrlResolver classe est utilisée pour convertir le chemin d’accès en représentation de données canoniques.

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La inputUri valeur est null.

SecurityException

Il XmlReader ne dispose pas des autorisations suffisantes pour accéder à l’emplacement des données XML.

FileNotFoundException

Le fichier identifié par l’URI n’existe pas.

UriFormatException

Le format d’URI n’est pas correct.

Remarque : Dans .NET pour les applications Windows Store ou la bibliothèque de classes Portable, interceptez l’exception de classe de base, FormatException, à la place.

Exemples

L’exemple suivant crée un XmlReader objet qui lit le fichier de données XML spécifié par l’URI.

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("books.xml");

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create("books.xml")

Remarques

Un XmlReaderSettings objet avec les paramètres par défaut est utilisé pour créer le lecteur. Si vous souhaitez spécifier les fonctionnalités à prendre en charge sur le lecteur créé, utilisez la surcharge qui prend un XmlReaderSettings objet en tant qu’un de ses arguments et transmettez un XmlReaderSettings objet avec les paramètres appropriés.

Une valeur par défaut XmlUrlResolver sans informations d’identification est utilisée pour accéder à des ressources externes telles qu’une définition de type de document (DTD), des entités, des schémas, etc.

Important

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(TextReader)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide du lecteur de texte spécifié.

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

Paramètres

input: TextReader

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La input valeur est null.

Exemples

L’exemple suivant utilise la StringReader classe pour lire une chaîne XML.

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

Remarques

Important

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(Stream)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide du flux spécifié avec les paramètres par défaut.

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

Paramètres

input: Stream

Flux qui contient les données XML.

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La input valeur est null.

SecurityException

Il XmlReader ne dispose pas des autorisations suffisantes pour accéder à l’emplacement des données XML.

Exemples

L’exemple suivant crée un XmlReader objet qui lit à partir d’un 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

Remarques

Important

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Create(String, XmlReaderSettings)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

Crée une XmlReader instance à l’aide de l’URI et des paramètres spécifiés.

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.XmlReader

Public Shared Function Create (inputUri As String, settings As XmlReaderSettings) As XmlReader

Paramètres

inputUri: String

settings: XmlReaderSettings

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

Retours

XmlReader

Objet utilisé pour lire les données XML dans le flux.

Exceptions

ArgumentNullException

La inputUri valeur est null.

FileNotFoundException

Le fichier spécifié par l’URI est introuvable.

UriFormatException

Le format d’URI n’est pas correct.

Remarque : Dans .NET pour les applications Windows Store ou la bibliothèque de classes Portable, interceptez l’exception de classe de base, FormatException, à la place.

Exemples

L’exemple suivant crée un XmlReader objet qui prend en charge la validation de définition de type de document (DTD).

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

Remarques

Important

Vous pouvez restreindre les ressources auxquelles l’accès est possible à l’aide XmlReader ThrowingResolverde .

L’objet créé XmlReader développe les références d’entité et effectue la normalisation XML de nouveaux caractères de ligne.

S’applique à

Commentaires

Cette page a-t-elle été utile ?