XmlReader.Create Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Vytvoří novou instanci XmlReader.

Přetížení

Name	Description
Create(String, XmlReaderSettings, XmlParserContext)	Vytvoří novou XmlReader instanci pomocí zadaného identifikátoru URI, nastavení a kontextových informací pro analýzu.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Vytvoří novou XmlReader instanci pomocí zadané čtečky textu, nastavení a kontextových informací pro analýzu.
Create(Stream, XmlReaderSettings, XmlParserContext)	Vytvoří novou XmlReader instanci pomocí zadaného datového proudu, nastavení a kontextových informací pro analýzu.
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é č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 naleznete v doplňku API poznámky pro XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Zdroj:

XmlReader.cs

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

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

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 pro soubor obsahující data XML. Objekt XmlResolver na objektu XmlReaderSettings slouží k převodu cesty na kanonický datový reprezentace. 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 analýze fragmentu XML. Informace o kontextu můžou zahrnovat XmlNameTable použití, kódování, obor názvů, aktuální xml:lang a xml:space obor, základní identifikátor URI a definici typu dokumentu.

Tato hodnota může být null.

Návraty

XmlReader

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

Výjimky

ArgumentNullException

Hodnota inputUri je null.

SecurityException

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

ArgumentException

NameTable Obě vlastnosti NameTable obsahují hodnoty. (Lze nastavit a použít pouze jednu z těchto NameTable vlastností).

FileNotFoundException

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

UriFormatException

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 je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití XmlReaderSettings.XmlResolver vlastnosti.

To znamená, že XmlReader má přístup k jakýmkoli 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 XmlReader má přístup, můžete omezit nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Zdroj:

XmlReader.cs

Vytvoří novou XmlReader instanci pomocí zadané čtečky textu, nastavení a kontextových informací pro analýzu.

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 nepoužívá čtečka XML k dekódování datového streamu.

settings

XmlReaderSettings

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

inputContext

XmlParserContext

Kontextové informace potřebné k analýze fragmentu XML. Informace o kontextu můžou zahrnovat XmlNameTable použití, kódování, obor názvů, aktuální xml:lang a xml:space obor, základní identifikátor URI a definici typu dokumentu.

Tato hodnota může být null.

Návraty

XmlReader

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

Výjimky

ArgumentNullException

Hodnota input je null.

ArgumentException

NameTable Obě vlastnosti NameTable obsahují hodnoty. (Lze 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 je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití 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í prostředků XmlReader , ke kterým má přístup, můžete použít jednu z následujících metod:

• Omezte prostředky, ke kterým XmlReader má přístup, nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

nebo

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(Stream, XmlReaderSettings, XmlParserContext)

Zdroj:

XmlReader.cs

Vytvoří novou XmlReader instanci pomocí zadaného datového proudu, nastavení a kontextových informací pro analýzu.

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é znaménko kódování. Při určení kódování se kódování používá k pokračování ve čtení datového proudu a zpracování pokračuje v analýze 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 analýze fragmentu XML. Informace o kontextu můžou zahrnovat XmlNameTable použití, kódování, obor názvů, aktuální xml:lang a xml:space obor, základní identifikátor URI a definici typu dokumentu.

Tato hodnota může být null.

Návraty

XmlReader

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

Výjimky

ArgumentNullException

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití 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í prostředků XmlReader , ke kterým má přístup, můžete použít jednu z následujících metod:

• Omezte prostředky, ke kterým XmlReader má přístup, nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

nebo

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(Stream, XmlReaderSettings, String)

Zdroj:

XmlReader.cs

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

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 datového proudu a hledá značku pořadí bajtů nebo jiné znaménko kódování. Při určení kódování se kódování používá k pokračování ve čtení datového proudu a zpracování pokračuje v analýze vstupu jako streamu znaků (Unicode).

settings

XmlReaderSettings

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

baseUri

String

Základní identifikátor URI entity nebo dokumentu, který se čte. Tato hodnota může být null.

Poznámka k zabezpečení Základní identifikátor URI slouží 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

XmlReader

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

Výjimky

ArgumentNullException

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití 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í prostředků XmlReader , ke kterým má přístup, můžete použít jednu z následujících metod:

• Omezte prostředky, ke kterým XmlReader má přístup, nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

nebo

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(XmlReader, XmlReaderSettings)

Zdroj:

XmlReader.cs

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

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í pro novou XmlReader instanci.

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

Návraty

XmlReader

Objekt, který je zabalen kolem zadaného XmlReader objektu.

Výjimky

ArgumentNullException

Hodnota reader je null.

InvalidOperationException

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

nebo

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

Příklady

Následující příklad vytvoří validační XmlReader objekt, který je zabalen 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ý metodou Create nebo XmlReader objekt vytvořený pomocí jedné z konkrétních XmlReader implementací.

Výchozí nastavení 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití XmlReaderSettings.XmlResolver vlastnosti.

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

Důležité

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

• Omezte prostředky, ke kterým XmlReader má přístup, nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

nebo

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(TextReader, XmlReaderSettings, String)

Zdroj:

XmlReader.cs

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

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

settings

XmlReaderSettings

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

baseUri

String

Základní identifikátor URI entity nebo dokumentu, který se čte. Tato hodnota může být null.

Poznámka k zabezpečení Základní identifikátor URI slouží 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

XmlReader

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

Výjimky

ArgumentNullException

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití 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í prostředků XmlReader , ke kterým má přístup, můžete použít jednu z následujících metod:

• Omezte prostředky, ke kterým XmlReader má přístup, nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

nebo

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(TextReader, XmlReaderSettings)

Zdroj:

XmlReader.cs

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

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 nepoužívá čtečka XML k dekódování datového streamu.

settings

XmlReaderSettings

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

Návraty

XmlReader

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

Výjimky

ArgumentNullException

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití 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í prostředků XmlReader , ke kterým má přístup, můžete použít jednu z následujících metod:

• Omezte prostředky, ke kterým XmlReader má přístup, nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

nebo

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(Stream, XmlReaderSettings)

Zdroj:

XmlReader.cs

Vytvoří novou XmlReader instanci se zadaným datovým proudem 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);

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 datového proudu a hledá značku pořadí bajtů nebo jiné znaménko kódování. Při určení kódování se kódování používá k pokračování ve čtení datového proudu a zpracování pokračuje v analýze vstupu jako streamu znaků (Unicode).

settings

XmlReaderSettings

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

Návraty

XmlReader

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

Výjimky

ArgumentNullException

Hodnota input je null.

Poznámky

Ve výchozím nastavení XmlUrlResolver se pro přístup k externím prostředkům, jako je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití 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í prostředků XmlReader , ke kterým má přístup, můžete použít jednu z následujících metod:

• Omezte prostředky, ke kterým XmlReader má přístup, nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

nebo

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(String)

Zdroj:

XmlReader.cs

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 pro soubor, který obsahuje data XML. Třída XmlUrlResolver se používá k převodu cesty na kanonickou reprezentaci dat.

Návraty

XmlReader

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

Výjimky

ArgumentNullException

Hodnota inputUri je null.

SecurityException

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

FileNotFoundException

Soubor identifikovaný identifikátorem URI neexistuje.

UriFormatException

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

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

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 slouží k vytvoření čtečky. Pokud chcete určit funkce, které mají být podporovány u vytvořené čtečky, použijte přetížení, které přebírá XmlReaderSettings objekt jako jeden z jeho 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 je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití XmlReaderSettings.XmlResolver vlastnosti.

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(TextReader)

Zdroj:

XmlReader.cs

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 nepoužívá čtečka XML k dekódování datového streamu.

Návraty

XmlReader

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

Výjimky

ArgumentNullException

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 slouží k vytvoření čtečky. Pokud chcete určit funkce, které mají být podporovány u vytvořené čtečky, použijte přetížení, které přebírá XmlReaderSettings objekt jako jeden z jeho 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 je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití XmlReaderSettings.XmlResolver vlastnosti.

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(Stream)

Zdroj:

XmlReader.cs

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 datového proudu a hledá značku pořadí bajtů nebo jiné znaménko kódování. Při určení kódování se kódování používá k pokračování ve čtení datového proudu a zpracování pokračuje v analýze vstupu jako streamu znaků (Unicode).

Návraty

XmlReader

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

Výjimky

ArgumentNullException

Hodnota input je null.

SecurityException

Nemá XmlReader 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 slouží k vytvoření čtečky. Pokud chcete určit funkce, které mají být podporovány u vytvořené čtečky, použijte přetížení, které přebírá XmlReaderSettings objekt jako jeden z jeho 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 je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití XmlReaderSettings.XmlResolver vlastnosti.

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

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.

Create(String, XmlReaderSettings)

Zdroj:

XmlReader.cs

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

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 pro soubor obsahující data XML. Objekt XmlResolver na objektu XmlReaderSettings slouží k převodu cesty na kanonický datový reprezentace. Pokud XmlResolver je null, použije se nový XmlUrlResolver objekt.

settings

XmlReaderSettings

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

Návraty

XmlReader

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

Výjimky

ArgumentNullException

Hodnota inputUri je null.

FileNotFoundException

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

UriFormatException

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

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

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 je 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í nastavení XmlUrlResolver . Pokud vaše řešení cílí na rozhraní .NET Framework 4.5.2 nebo novější verze, zadejte XmlResolver použití XmlReaderSettings.XmlResolver vlastnosti.

To znamená, že XmlReader má přístup k jakýmkoli 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 XmlReader má přístup, můžete omezit nastavením XmlResolver vlastnosti na XmlSecureResolver objekt.

Vytvořený XmlReader objekt rozšiřuje odkazy na entity a provádí normalizaci XML nových znaků řádku.