XmlReader.Create Méthode

Référence

Définition

Espace de noms:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.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 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)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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

XmlReader

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

Exceptions

ArgumentNullException

inputUri a la valeur null.

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UriFormatException

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 peut XmlReader 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 le XmlReader 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)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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

Cette valeur peut être null.

Retours

XmlReader

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

Exceptions

ArgumentNullException

input a la valeur null.

ArgumentException

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

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 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 le XmlReader peut accéder :

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

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

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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

Cette valeur peut être null.

Retours

XmlReader

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

Exceptions

ArgumentNullException

input a la valeur null.

Remarques

Important

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

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

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

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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.

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

XmlReader

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

Exceptions

ArgumentNullException

input a la valeur null.

Remarques

Important

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

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

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

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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

XmlReader

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

Exceptions

ArgumentNullException

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

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 :

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

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

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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

XmlReader

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

Exceptions

ArgumentNullException

input a la valeur null.

Remarques

Important

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

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

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

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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

settings: XmlReaderSettings

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

Retours

XmlReader

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

Exceptions

ArgumentNullException

input a la valeur null.

Remarques

Important

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

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

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

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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.

settings: XmlReaderSettings

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

Retours

XmlReader

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

Exceptions

ArgumentNullException

input a la valeur null.

Remarques

Important

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

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

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

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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

XmlReader

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

Exceptions

ArgumentNullException

inputUri a la valeur null.

SecurityException

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

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)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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

Retours

XmlReader

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

Exceptions

ArgumentNullException

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

Important

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)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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.

Retours

XmlReader

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

Exceptions

ArgumentNullException

input a la valeur null.

SecurityException

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

Important

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)

Source:: XmlReader.cs

Source:: XmlReader.cs

Source:: XmlReader.cs

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

settings: XmlReaderSettings

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

Retours

XmlReader

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

Exceptions

ArgumentNullException

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

Important

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 à

Partager via

XmlReader.Create Méthode

Définition

Surcharges

Remarques

Create(String, XmlReaderSettings, XmlParserContext)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Create(TextReader, XmlReaderSettings, XmlParserContext)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

Create(Stream, XmlReaderSettings, XmlParserContext)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Create(Stream, XmlReaderSettings, String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Create(XmlReader, XmlReaderSettings)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

Create(TextReader, XmlReaderSettings, String)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Create(TextReader, XmlReaderSettings)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Create(Stream, XmlReaderSettings)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Create(String)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

Create(TextReader)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

Create(Stream)

Paramètres

Retours

Exceptions

Exemples

Remarques

S’applique à

Create(String, XmlReaderSettings)

Paramètres

Retours

Exceptions