XmlReader.Create Méthode

Définition

Crée une instance XmlReader.

Surcharges

Create(String, XmlReaderSettings, XmlParserContext)

Crée une instance de XmlReader en utilisant l’URI, les paramètres et les informations de contexte spécifiés pour l’analyse.

Create(TextReader, XmlReaderSettings, XmlParserContext)

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

Create(Stream, XmlReaderSettings, XmlParserContext)

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

Create(Stream, XmlReaderSettings, String)

Crée une instance de XmlReader en utilisant le flux, l’URI de base et les paramètres spécifiés.

Create(XmlReader, XmlReaderSettings)

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

Create(TextReader, XmlReaderSettings, String)

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

Create(TextReader, XmlReaderSettings)

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

Create(Stream, XmlReaderSettings)

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

Create(String)

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

Create(TextReader)

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

Create(Stream)

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

Create(String, XmlReaderSettings)

Crée une instance de XmlReader en utilisant l’URI et les paramètres spécifiés.

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Crée une instance de XmlReader en utilisant l’URI, les paramètres et les informations de contexte spécifiés 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 de l’objet XmlReaderSettings permet de convertir le chemin en représentation de données canonique. Si XmlResolver a la valeur null, un nouvel objet XmlUrlResolver est utilisé.

settings
XmlReaderSettings

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

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

Retours

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

Exceptions

inputUri a la valeur null.

XmlReader n’a pas d’autorisations suffisantes pour accéder à l’emplacement des données XML.

Les propriétés NameTable et NameTable contiennent toutes deux des valeurs. (Vous ne pouvez définir et utiliser qu’une seule de ces propriétés NameTable).

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

Le format d’URI n’est pas correct.

Remarques

Par défaut, un sans informations d’identification XmlUrlResolver est utilisé 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

Cela signifie que le XmlReader 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 un avec les informations d’identification XmlResolver nécessaires.

Important

Vous pouvez restreindre les ressources auxquelles XmlReader le peut accéder en définissant la XmlResolver propriété sur un XmlSecureResolver objet.

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

S’applique à

Create(TextReader, XmlReaderSettings, XmlParserContext)

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

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. Comme un lecteur de texte retourne un flux de caractères Unicode, 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 instance de XmlReader. Cette valeur peut être null.

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

Retours

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

Exceptions

input a la valeur null.

Les propriétés NameTable et NameTable contiennent toutes deux 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

Par défaut, un sans informations d’identification XmlUrlResolver est utilisé 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

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 un avec les informations d’identification XmlResolver nécessaires.

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles l’accès XmlReader est possible :

- ou -

  • Empêchez l'objet 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 des nouveaux caractères de ligne.

S’applique à

Create(Stream, XmlReaderSettings, XmlParserContext)

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

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

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

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

Retours

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

Exceptions

input a la valeur null.

Remarques

Par défaut, un sans informations d’identification XmlUrlResolver est utilisé 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

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 un avec les informations d’identification XmlResolver nécessaires.

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles l’accès XmlReader est possible :

- ou -

  • Empêchez l'objet 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 des nouveaux caractères de ligne.

S’applique à

Create(Stream, XmlReaderSettings, String)

Crée une instance de XmlReader en utilisant le flux, l’URI de base et les 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 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
XmlReaderSettings

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

baseUri
String

URI de base pour l'entité ou le document en cours de lecture. Cette valeur peut être null.

Note sur la sécurité L’URI de base est utilisé pour résoudre l’URI relatif du document XML. N'utilisez pas un URI de base provenant d'une source non fiable.

Retours

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

Exceptions

input a la valeur null.

Remarques

Par défaut, un sans informations d’identification XmlUrlResolver est utilisé 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

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 un avec les informations d’identification XmlResolver nécessaires.

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles l’accès XmlReader est possible :

- ou -

  • Empêchez l'objet 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 des nouveaux caractères de ligne.

S’applique à

Create(XmlReader, XmlReaderSettings)

Crée une instance de XmlReader à l’aide des paramètres et du lecteur 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

L'objet à utiliser comme lecteur XML sous-jacent.

settings
XmlReaderSettings

Paramètres de la nouvelle instance de XmlReader.

Le niveau de conformité de l’objet XmlReaderSettings doit soit correspondre au niveau de conformité du lecteur sous-jacent, soit avoir la valeur Auto.

Retours

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

Exceptions

reader a la valeur null.

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 XmlReader sous-jacent se trouve dans un état Error ou Closed.

Exemples

L’exemple suivant crée un objet de XmlReader validation qui est encapsulé 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 est utilisée pour accéder à des ressources externes telles qu’un schéma.

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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

Si la ressource externe se trouve sur une ressource réseau qui nécessite une authentification, spécifiez un avec les informations d’identification XmlResolver 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 l’accès XmlReader est possible :

- ou -

  • Empêchez l'objet 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 des nouveaux caractères de ligne.

S’applique à

Create(TextReader, XmlReaderSettings, String)

Crée une instance de XmlReader à 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

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

settings
XmlReaderSettings

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

baseUri
String

URI de base pour l'entité ou le document en cours de lecture. Cette valeur peut être null.

Note sur la sécurité L’URI de base est utilisé pour résoudre l’URI relatif du document XML. N'utilisez pas un URI de base provenant d'une source non fiable.

Retours

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

Exceptions

input a la valeur null.

Remarques

Par défaut, un sans informations d’identification XmlUrlResolver est utilisé 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

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 un avec les informations d’identification XmlResolver nécessaires.

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles l’accès XmlReader est possible :

- ou -

  • Empêchez l'objet 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 des nouveaux caractères de ligne.

S’applique à

Create(TextReader, XmlReaderSettings)

Crée une instance de XmlReader à 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

Lecteur de texte à partir duquel lire les données XML. Comme un lecteur de texte retourne un flux de caractères Unicode, 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 du nouveau XmlReader. Cette valeur peut être null.

Retours

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

Exceptions

input a la valeur null.

Remarques

Par défaut, un sans informations d’identification XmlUrlResolver est utilisé 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

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 un avec les informations d’identification XmlResolver nécessaires.

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles l’accès XmlReader est possible :

- ou -

  • Empêchez l'objet 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 des nouveaux caractères de ligne.

S’applique à

Create(Stream, XmlReaderSettings)

Crée une instance de XmlReader 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 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
XmlReaderSettings

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

Retours

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

Exceptions

input a la valeur null.

Remarques

Par défaut, un sans informations d’identification XmlUrlResolver est utilisé 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

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 un avec les informations d’identification XmlResolver nécessaires.

Important

Vous pouvez utiliser l’une des méthodes suivantes pour contrôler les ressources auxquelles l’accès XmlReader est possible :

- ou -

  • Empêchez l'objet 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 des nouveaux caractères de ligne.

S’applique à

Create(String)

Crée une instance de XmlReader 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 classe XmlUrlResolver permet de convertir le chemin en représentation de données canonique.

Retours

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

Exceptions

inputUri a la valeur null.

XmlReader n’a pas d’autorisations suffisantes pour accéder à l’emplacement des données XML.

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

Le format d’URI n’est pas correct.

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable, interceptez l’exception de la 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 comme l’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

À 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

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

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

S’applique à

Create(TextReader)

Crée une instance de XmlReader à 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

Lecteur de texte à partir duquel lire les données XML. Comme un lecteur de texte retourne un flux de caractères Unicode, 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.

Retours

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

Exceptions

input a la valeur 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

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 comme l’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

À 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

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

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

S’applique à

Create(Stream)

Crée une instance de XmlReader à 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 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).

Retours

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

Exceptions

input a la valeur null.

XmlReader n’a pas d’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

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 comme l’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

À 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

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

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

S’applique à

Create(String, XmlReaderSettings)

Crée une instance de XmlReader en utilisant l’URI et les 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

URI du fichier contenant les données XML. L’objet XmlResolver de l’objet XmlReaderSettings permet de convertir le chemin en représentation de données canonique. Si XmlResolver a la valeur null, un nouvel objet XmlUrlResolver est utilisé.

settings
XmlReaderSettings

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

Retours

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

Exceptions

inputUri a la valeur null.

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

Le format d’URI n’est pas correct.

Remarque : Dans .NET pour les applications du Windows Store ou la bibliothèque de classes portable, interceptez l’exception de la 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

Par défaut, un sans informations d’identification XmlUrlResolver est utilisé 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 un à l’aide de XmlResolver la XmlReaderSettings.XmlResolver propriété .

Cela signifie que le XmlReader 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 un avec les informations d’identification XmlResolver nécessaires.

Important

Vous pouvez restreindre les ressources auxquelles XmlReader le peut accéder en définissant la XmlResolver propriété sur un XmlSecureResolver objet.

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

S’applique à