XmlReader.Create Metoda

Definice

Vytvoří novou instanci sloupce XmlReader.

Přetížení

Create(String, XmlReaderSettings, XmlParserContext)

Vytvoří novou XmlReader instanci pomocí zadaného identifikátoru URI, nastavení a kontextových informací pro parsování.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Vytvoří novou XmlReader instanci pomocí zadaného čtečky textu, nastavení a kontextové informace pro parsování.

Create(Stream, XmlReaderSettings, XmlParserContext)

Vytvoří novou XmlReader instanci pomocí zadaného datového proudu, nastavení a kontextové informace pro parsování.

Create(Stream, XmlReaderSettings, String)

Vytvoří novou XmlReader instanci pomocí zadaného datového proudu, základního identifikátoru URI a nastavení.

Create(XmlReader, XmlReaderSettings)

Vytvoří novou XmlReader instanci pomocí zadané čtečky XML a nastavení.

Create(TextReader, XmlReaderSettings, String)

Vytvoří novou XmlReader instanci pomocí zadané čtečky textu, nastavení a základního identifikátoru URI.

Create(TextReader, XmlReaderSettings)

Vytvoří novou XmlReader instanci pomocí zadané čtečky textu a nastavení.

Create(Stream, XmlReaderSettings)

Vytvoří novou XmlReader instanci se zadaným datovým proudem a nastavením.

Create(String)

Vytvoří novou XmlReader instanci se zadaným identifikátorem URI.

Create(TextReader)

Vytvoří novou XmlReader instanci pomocí zadaného čtečky textu.

Create(Stream)

Vytvoří novou XmlReader instanci pomocí zadaného datového proudu s výchozím nastavením.

Create(String, XmlReaderSettings)

Vytvoří novou XmlReader instanci pomocí zadaného identifikátoru URI a nastavení.

Poznámky

Další informace o tomto rozhraní API najdete v tématu Doplňkové poznámky k rozhraní API pro XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Vytvoří novou XmlReader instanci pomocí zadaného identifikátoru URI, nastavení a kontextových informací pro parsování.

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

Parametry

inputUri
String

Identifikátor URI souboru obsahujícího data XML. Objekt XmlResolver na objektu XmlReaderSettings se používá k převodu cesty na reprezentaci kanonických dat. Pokud XmlResolver je null, použije se nový XmlUrlResolver objekt.

settings
XmlReaderSettings

Nastavení pro novou XmlReader instanci. Tato hodnota může být null.

inputContext
XmlParserContext

Kontextové informace potřebné k parsování fragmentu XML. Mezi kontextové informace může patřit XmlNameTable použití, kódování, obor názvů, aktuální xml:lang a xml:space obor, základní identifikátor URI a definice typu dokumentu.

Tato hodnota může být null.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota inputUri je null.

Objekt XmlReader nemá dostatečná oprávnění pro přístup k umístění dat XML.

Vlastnosti NameTable a NameTable obsahují hodnoty. (Je možné nastavit a použít pouze jednu z těchto NameTable vlastností.)

Soubor určený identifikátorem URI nebyl nalezen.

Formát identifikátoru URI není správný.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd., používá bez přihlašovacích údajů.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí hodnota XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte pomocí XmlResolverXmlReaderSettings.XmlResolver vlastnosti .

To znamená, že XmlReader má přístup ke všem umístěním, která nevyžadují ověření. Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, použijte XmlReaderSettings.XmlResolver vlastnost k zadání XmlResolver s potřebnými přihlašovacími údaji.

Důležité

Prostředky, ke kterým má objekt přístup, XmlReader můžete omezit nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML znaků nového řádku.

Platí pro

Create(TextReader, XmlReaderSettings, XmlParserContext)

Vytvoří novou XmlReader instanci pomocí zadaného čtečky textu, nastavení a kontextové informace pro parsování.

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

Parametry

input
TextReader

Čtečka textu, ze které se mají číst data XML. Čtečka textu vrátí datový proud znaků Unicode, takže kódování zadané v deklaraci XML není použito čtečkou XML k dekódování datového proudu.

settings
XmlReaderSettings

Nastavení pro novou XmlReader instanci. Tato hodnota může být null.

inputContext
XmlParserContext

Kontextové informace potřebné k parsování fragmentu XML. Mezi kontextové informace může patřit XmlNameTable použití, kódování, obor názvů, aktuální xml:lang a xml:space obor, základní identifikátor URI a definice typu dokumentu.

Tato hodnota může být null.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota input je null.

Vlastnosti NameTable a NameTable obsahují hodnoty. (Je možné nastavit a použít pouze jednu z těchto NameTable vlastností.)

Příklady

Následující příklad vytvoří XmlReader objekt, který čte 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)

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd., používá bez přihlašovacích údajů.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí hodnota XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte pomocí XmlResolverXmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, použijte XmlReaderSettings.XmlResolver vlastnost k zadání XmlResolver s potřebnými přihlašovacími údaji.

Důležité

Pomocí jedné z následujících metod můžete řídit, ke kterým prostředkům XmlReader bude mít přístup:

-nebo-

  • Nepovolte XmlReader otevírání externích prostředků nastavením XmlResolver vlastnosti na null.

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML znaků nového řádku.

Platí pro

Create(Stream, XmlReaderSettings, XmlParserContext)

Vytvoří novou XmlReader instanci pomocí zadaného datového proudu, nastavení a kontextové informace pro parsování.

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

Parametry

input
Stream

Datový proud, který obsahuje data XML.

Prohledá XmlReader první bajty datového proudu a hledá značku pořadí bajtů nebo jiný znak kódování. Při určení kódování se kódování použije k pokračování ve čtení datového proudu a zpracování pokračuje parsováním vstupu jako streamu znaků (Unicode).

settings
XmlReaderSettings

Nastavení pro novou XmlReader instanci. Tato hodnota může být null.

inputContext
XmlParserContext

Kontextové informace potřebné k parsování fragmentu XML. Mezi kontextové informace může patřit XmlNameTable použití, kódování, obor názvů, aktuální xml:lang a xml:space obor, základní identifikátor URI a definice typu dokumentu.

Tato hodnota může být null.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd., používá bez přihlašovacích údajů.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí hodnota XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte pomocí XmlResolverXmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, použijte XmlReaderSettings.XmlResolver vlastnost k zadání XmlResolver s potřebnými přihlašovacími údaji.

Důležité

Pomocí jedné z následujících metod můžete řídit, ke kterým prostředkům XmlReader bude mít přístup:

-nebo-

  • Nepovolte XmlReader otevírání externích prostředků nastavením XmlResolver vlastnosti na null.

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML znaků nového řádku.

Platí pro

Create(Stream, XmlReaderSettings, String)

Vytvoří novou XmlReader instanci pomocí zadaného datového proudu, základního identifikátoru URI a nastavení.

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

Parametry

input
Stream

Datový proud, který obsahuje data XML.

Prohledá XmlReader první bajty streamu a hledá značku pořadí bajtů nebo jiný znak kódování. Při určení kódování se kódování použije k pokračování ve čtení streamu a zpracování pokračuje v parsování vstupu jako streamu znaků (Unicode).

settings
XmlReaderSettings

Nastavení nové XmlReader instance. Tato hodnota může být null.

baseUri
String

Základní identifikátor URI pro čtenou entitu nebo dokument. Tato hodnota může být null.

Poznámka k zabezpečení Základní identifikátor URI se používá k překladu relativního identifikátoru URI dokumentu XML. Nepoužívejte základní identifikátor URI z nedůvěryhodného zdroje.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd. používá objekt bez přihlašovacích údajů.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí XmlUrlResolver hodnota. Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver vlastnost pomocí XmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, použijte XmlReaderSettings.XmlResolver vlastnost k zadání XmlResolver s potřebnými přihlašovacími údaji.

Důležité

K řízení, ke kterým prostředkům XmlReader má přístup, můžete použít jednu z následujících metod:

-nebo-

  • Nepovolte XmlReader otevření externích prostředků nastavením XmlResolver vlastnosti na null.

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML nových znaků řádku.

Platí pro

Create(XmlReader, XmlReaderSettings)

Vytvoří novou XmlReader instanci pomocí zadané čtečky XML a nastavení.

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

Parametry

reader
XmlReader

Objekt, který chcete použít jako podkladovou čtečku XML.

settings
XmlReaderSettings

Nastavení nové XmlReader instance.

Úroveň shody objektu XmlReaderSettings musí buď odpovídat úrovni shody podkladového čtenáře, nebo musí být nastavená na Auto.

Návraty

Objekt, který je obtočený kolem zadaného XmlReader objektu.

Výjimky

Hodnota reader je null.

XmlReaderSettings Pokud objekt určuje úroveň shody, která není konzistentní s úrovní shody podkladového čtenáře.

-nebo-

Podkladová položka XmlReader je ve Error stavu nebo Closed .

Příklady

Následující příklad vytvoří ověřovací XmlReader objekt, který je obtočený kolem objektu XmlNodeReader .

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

Poznámky

Tato metoda umožňuje přidat další funkce do podkladového XmlReader objektu. Podkladový XmlReader objekt může být jiný XmlReader objekt vytvořený Create metodou XmlReader nebo objekt vytvořený pomocí jedné z konkrétních XmlReader implementací.

Výchozí hodnota XmlUrlResolver bez přihlašovacích údajů se používá pro přístup k externím prostředkům, jako je schéma.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí XmlUrlResolver hodnota. Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver vlastnost pomocí XmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, pomocí vlastnosti zadejte XmlResolver parametr s potřebnými přihlašovacími údaji XmlReaderSettings.XmlResolver .

Důležité

K řízení, ke kterým prostředkům XmlReader má přístup, můžete použít jednu z následujících metod:

-nebo-

  • Nepovolte XmlReader otevření externích prostředků nastavením XmlResolver vlastnosti na null.

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML nových znaků řádku.

Platí pro

Create(TextReader, XmlReaderSettings, String)

Vytvoří novou XmlReader instanci pomocí zadané čtečky textu, nastavení a základního identifikátoru URI.

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

Parametry

input
TextReader

Čtečka textu, ze které se mají číst data XML. Čtečka textu vrátí datový proud znaků Unicode, takže kódování zadané v deklaraci XML se nepoužívá XmlReader k dekódování datového proudu.

settings
XmlReaderSettings

Nastavení nové XmlReader instance. Tato hodnota může být null.

baseUri
String

Základní identifikátor URI pro čtenou entitu nebo dokument. Tato hodnota může být null.

Poznámka k zabezpečení Základní identifikátor URI se používá k překladu relativního identifikátoru URI dokumentu XML. Nepoužívejte základní identifikátor URI z nedůvěryhodného zdroje.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd. používá objekt bez přihlašovacích údajů.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí XmlUrlResolver hodnota. Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver vlastnost pomocí XmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, použijte XmlReaderSettings.XmlResolver vlastnost k zadání XmlResolver s potřebnými přihlašovacími údaji.

Důležité

K řízení, ke kterým prostředkům XmlReader má přístup, můžete použít jednu z následujících metod:

-nebo-

  • Nepovolte XmlReader otevření externích prostředků nastavením XmlResolver vlastnosti na null.

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML nových znaků řádku.

Platí pro

Create(TextReader, XmlReaderSettings)

Vytvoří novou XmlReader instanci pomocí zadané čtečky textu a nastavení.

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

Parametry

input
TextReader

Čtečka textu, ze které se mají číst data XML. Čtečka textu vrátí datový proud znaků Unicode, takže kódování zadané v deklaraci XML není používáno čtečkou XML k dekódování datového proudu.

settings
XmlReaderSettings

Nastavení pro nový XmlReader. Tato hodnota může být null.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd. používá objekt bez přihlašovacích údajů.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí XmlUrlResolver hodnota. Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver vlastnost pomocí XmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, použijte XmlReaderSettings.XmlResolver vlastnost k zadání XmlResolver s potřebnými přihlašovacími údaji.

Důležité

K řízení, ke kterým prostředkům XmlReader má přístup, můžete použít jednu z následujících metod:

-nebo-

  • Nepovolte XmlReader otevření externích prostředků nastavením XmlResolver vlastnosti na null.

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML nových znaků řádku.

Platí pro

Create(Stream, XmlReaderSettings)

Vytvoří novou XmlReader instanci se zadaným streamem a nastavením.

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

Parametry

input
Stream

Datový proud, který obsahuje data XML.

Prohledá XmlReader první bajty streamu a hledá značku pořadí bajtů nebo jiný znak kódování. Při určení kódování se kódování použije k pokračování ve čtení streamu a zpracování pokračuje v parsování vstupu jako streamu znaků (Unicode).

settings
XmlReaderSettings

Nastavení nové XmlReader instance. Tato hodnota může být null.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd. používá objekt bez přihlašovacích údajů.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí XmlUrlResolver hodnota. Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver vlastnost pomocí XmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, použijte XmlReaderSettings.XmlResolver vlastnost k zadání XmlResolver s potřebnými přihlašovacími údaji.

Důležité

K řízení, ke kterým prostředkům XmlReader má přístup, můžete použít jednu z následujících metod:

-nebo-

  • Nepovolte XmlReader otevření externích prostředků nastavením XmlResolver vlastnosti na null.

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML nových znaků řádku.

Platí pro

Create(String)

Vytvoří novou XmlReader instanci se zadaným identifikátorem URI.

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

Parametry

inputUri
String

Identifikátor URI souboru, který obsahuje data XML. Třída XmlUrlResolver se používá k převodu cesty na kanonickou reprezentaci dat.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota inputUri je null.

Objekt XmlReader nemá dostatečná oprávnění pro přístup k umístění dat XML.

Soubor identifikovaný identifikátorem URI neexistuje.

Formát identifikátoru URI není správný.

Poznámka: V .NET pro aplikace pro Windows Store nebo v přenosné knihovně tříd místo toho zachyťte výjimku FormatExceptionzákladní třídy.

Příklady

Následující příklad vytvoří XmlReader objekt, který čte datový soubor XML určený identifikátorem URI.

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

Poznámky

Objekt XmlReaderSettings s výchozím nastavením se použije k vytvoření čtečky. Chcete-li určit funkce, které mají být podporovány ve vytvořeném čtenáři, použijte přetížení, které přebírá XmlReaderSettings objekt jako jeden ze svých argumentů, a předejte XmlReaderSettings objekt se správným nastavením.

Výchozí hodnota XmlUrlResolver bez přihlašovacích údajů se používá pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí XmlUrlResolver hodnota. Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver vlastnost pomocí XmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, pomocí vlastnosti zadejte XmlResolver parametr s potřebnými přihlašovacími údaji XmlReaderSettings.XmlResolver .

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML nových znaků řádku.

Platí pro

Create(TextReader)

Vytvoří novou XmlReader instanci pomocí zadané čtečky textu.

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

Parametry

input
TextReader

Čtečka textu, ze které se mají číst data XML. Čtečka textu vrátí datový proud znaků Unicode, takže kódování zadané v deklaraci XML není používáno čtečkou XML k dekódování datového proudu.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota input je null.

Příklady

Následující příklad používá StringReader třídu ke čtení řetězce 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))

Poznámky

Objekt XmlReaderSettings s výchozím nastavením se použije k vytvoření čtečky. Chcete-li určit funkce, které mají být podporovány ve vytvořeném čtenáři, použijte přetížení, které přebírá XmlReaderSettings objekt jako jeden ze svých argumentů, a předejte XmlReaderSettings objekt se správným nastavením.

Výchozí hodnota XmlUrlResolver bez přihlašovacích údajů se používá pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí XmlUrlResolver hodnota. Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver vlastnost pomocí XmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, pomocí vlastnosti zadejte XmlResolver parametr s potřebnými přihlašovacími údaji XmlReaderSettings.XmlResolver .

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML nových znaků řádku.

Platí pro

Create(Stream)

Vytvoří novou XmlReader instanci pomocí zadaného datového proudu s výchozím nastavením.

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

Parametry

input
Stream

Datový proud, který obsahuje data XML.

Prohledá XmlReader první bajty streamu a hledá značku pořadí bajtů nebo jiný znak kódování. Při určení kódování se kódování použije k pokračování ve čtení streamu a zpracování pokračuje v parsování vstupu jako streamu znaků (Unicode).

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota input je null.

Objekt XmlReader nemá dostatečná oprávnění pro přístup k umístění dat XML.

Příklady

Následující příklad vytvoří XmlReader objekt, který čte z objektu 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

Poznámky

Objekt XmlReaderSettings s výchozím nastavením se použije k vytvoření čtečky. Chcete-li určit funkce, které mají být podporovány ve vytvořeném čtenáři, použijte přetížení, které přebírá XmlReaderSettings objekt jako jeden ze svých argumentů, a předejte XmlReaderSettings objekt se správným nastavením.

Výchozí hodnota XmlUrlResolver bez přihlašovacích údajů se používá pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí XmlUrlResolver hodnota. Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver vlastnost pomocí XmlReaderSettings.XmlResolver vlastnosti .

Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, pomocí vlastnosti zadejte XmlResolver parametr s potřebnými přihlašovacími údaji XmlReaderSettings.XmlResolver .

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML nových znaků řádku.

Platí pro

Create(String, XmlReaderSettings)

Vytvoří novou XmlReader instanci pomocí zadaného identifikátoru URI a nastavení.

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

Parametry

inputUri
String

Identifikátor URI souboru obsahujícího data XML. Objekt XmlResolver na objektu XmlReaderSettings se používá k převodu cesty na kanonickou reprezentaci dat. Pokud XmlResolver je null, použije se nový XmlUrlResolver objekt.

settings
XmlReaderSettings

Nastavení nové XmlReader instance. Tato hodnota může být null.

Návraty

Objekt, který se používá ke čtení dat XML v datovém proudu.

Výjimky

Hodnota inputUri je null.

Soubor určený identifikátorem URI nebyl nalezen.

Formát identifikátoru URI není správný.

Poznámka: V .NET pro aplikace pro Windows Store nebo v přenosné knihovně tříd místo toho zachyťte výjimku FormatExceptionzákladní třídy.

Příklady

Následující příklad vytvoří XmlReader objekt, který podporuje ověřování definice typu dokumentu (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

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako jsou definice typu dokumentu (DTD), entity, schémata atd. používá objekt bez přihlašovacích údajů.

Důležité

Počínaje rozhraním .NET Framework 4.5.2 není k dispozici žádná výchozí XmlUrlResolver hodnota. Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver vlastnost pomocí XmlReaderSettings.XmlResolver vlastnosti .

To znamená, že má XmlReader přístup ke všem umístěním, která nevyžadují ověřování. Pokud se externí prostředek nachází v síťovém prostředku, který vyžaduje ověření, použijte XmlReaderSettings.XmlResolver vlastnost k zadání XmlResolver s potřebnými přihlašovacími údaji.

Důležité

Prostředky, ke kterým má objekt přístup, XmlReader můžete omezit nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

Vytvořený XmlReader objekt rozbalí odkazy na entity a provede normalizaci XML nových znaků řádku.

Platí pro