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.

Remarques

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

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 XmlReader peut être possible 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 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 l'accès aux ressources que le XmlReader peut consulter en configurant la propriété XmlResolver sur un objet XmlSecureResolver.

- ou -

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 l'accès aux ressources que le XmlReader peut consulter en configurant la propriété XmlResolver sur un objet XmlSecureResolver.

- ou -

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 l'accès aux ressources que le XmlReader peut consulter en configurant la propriété XmlResolver sur un objet XmlSecureResolver.

- ou -

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 Closed dans un Error é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 l'accès aux ressources que le XmlReader peut consulter en configurant la propriété XmlResolver sur un objet XmlSecureResolver.

- ou -

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 l'accès aux ressources que le XmlReader peut consulter en configurant la propriété XmlResolver sur un objet XmlSecureResolver.

- ou -

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 l'accès aux ressources que le XmlReader peut consulter en configurant la propriété XmlResolver sur un objet XmlSecureResolver.

- ou -

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 l'accès aux ressources que le XmlReader peut consulter en configurant la propriété XmlResolver sur un objet XmlSecureResolver.

- ou -

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 du Windows Store ou la bibliothèque de classes portables, interceptez l’exception de classe de base, à FormatExceptionla 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 du Windows Store ou la bibliothèque de classes portables, interceptez l’exception de classe de base, à FormatExceptionla 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 XmlReader peut être possible 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 de nouveaux caractères de ligne.

S’applique à

Commentaires

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

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