XmlReader.Create Metod

Definition

Namnområde:: System.Xml

Sammansättningar:: netstandard.dll, System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.ReaderWriter.dll

Sammansättning:: System.Xml.dll

Sammansättning:: netstandard.dll

Sammansättningar:: System.Xml.dll, System.Xml.ReaderWriter.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Skapar en ny XmlReader instans.

Överlagringar

Name	Description
Create(String, XmlReaderSettings, XmlParserContext)	Skapar en ny XmlReader instans med hjälp av angiven URI, inställningar och kontextinformation för parsning.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Skapar en ny XmlReader instans med den angivna textläsaren, inställningarna och kontextinformationen för parsning.
Create(Stream, XmlReaderSettings, XmlParserContext)	Skapar en ny XmlReader instans med den angivna strömmen, inställningarna och kontextinformationen för parsning.
Create(Stream, XmlReaderSettings, String)	Skapar en ny XmlReader instans med den angivna strömmen, bas-URI:n och inställningarna.
Create(XmlReader, XmlReaderSettings)	Skapar en ny XmlReader instans med den angivna XML-läsaren och inställningarna.
Create(TextReader, XmlReaderSettings, String)	Skapar en ny XmlReader instans med den angivna textläsaren, inställningarna och bas-URI:n.
Create(TextReader, XmlReaderSettings)	Skapar en ny XmlReader instans med hjälp av den angivna textläsaren och inställningarna.
Create(Stream, XmlReaderSettings)	Skapar en ny XmlReader instans med den angivna strömmen och inställningarna.
Create(String)	Skapar en ny XmlReader instans med angiven URI.
Create(TextReader)	Skapar en ny XmlReader instans med hjälp av den angivna textläsaren.
Create(Stream)	Skapar en ny XmlReader instans med den angivna strömmen med standardinställningar.
Create(String, XmlReaderSettings)	Skapar en ny XmlReader instans med hjälp av angiven URI och inställningar.

Kommentarer

Mer information om det här API:et finns i Kompletterande API-kommentarer för XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med hjälp av angiven URI, inställningar och kontextinformation för parsning.

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

Parametrar

inputUri: String

URI:n för filen som innehåller XML-data. Objektet XmlResolver på XmlReaderSettings objektet används för att konvertera sökvägen till en kanonisk datarepresentation. Om XmlResolver är nullanvänds ett nytt XmlUrlResolver objekt.

settings: XmlReaderSettings

Inställningarna för den nya XmlReader instansen. Det här värdet kan vara null.

inputContext: XmlParserContext

Den kontextinformation som krävs för att parsa XML-fragmentet. Kontextinformationen XmlNameTable kan innehålla definitionen för att använda, koda, namnområdesomfång, aktuell xml:lang och xml:space omfattning, bas-URI och dokumenttyp.

Det här värdet kan vara null.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet inputUri är null.

SecurityException

XmlReader Har inte tillräckliga behörigheter för att komma åt platsen för XML-data.

ArgumentException

Egenskaperna NameTable och NameTable innehåller båda värdena. (Endast en av dessa NameTable egenskaper kan anges och användas).

FileNotFoundException

Det går inte att hitta filen som anges av URI:n.

UriFormatException

URI-formatet är inte korrekt.

Kommentarer

Som standard används en XmlUrlResolver utan autentiseringsuppgifter för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Från och med .NET Framework 4.5.2 tillhandahålls ingen standard XmlUrlResolver. Om din lösning är avsedd för .NET Framework 4.5.2 eller senare versioner anger du en XmlResolver med egenskapen XmlReaderSettings.XmlResolver.

Det innebär att XmlReader kan komma åt alla platser som inte kräver autentisering. Om den externa resursen finns på en nätverksresurs som kräver autentisering använder du XmlReaderSettings.XmlResolver egenskapen för att ange en XmlResolver med nödvändiga autentiseringsuppgifter.

Important

Du kan begränsa de resurser som kan kommas åt genom att XmlReader ange XmlResolver egenskapen till ett XmlSecureResolver objekt.

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(TextReader, XmlReaderSettings, XmlParserContext)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med den angivna textläsaren, inställningarna och kontextinformationen för parsning.

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

Parametrar

input: TextReader

Textläsaren som XML-data ska läsas från. En textläsare returnerar en ström med Unicode-tecken, så kodningen som anges i XML-deklarationen används inte av XML-läsaren för att avkoda dataströmmen.

settings: XmlReaderSettings

Inställningarna för den nya XmlReader instansen. Det här värdet kan vara null.

inputContext: XmlParserContext

Det här värdet kan vara null.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet input är null.

ArgumentException

Egenskaperna NameTable och NameTable innehåller båda värdena. (Endast en av dessa NameTable egenskaper kan anges och användas.)

Exempel

I följande exempel skapas ett XmlReader objekt som läser ett XML-fragment.

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)

Kommentarer

Som standard används en XmlUrlResolver utan autentiseringsuppgifter för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Om den externa resursen finns på en nätverksresurs som kräver autentisering använder du XmlReaderSettings.XmlResolver egenskapen för att ange en XmlResolver med nödvändiga autentiseringsuppgifter.

Important

Du kan använda någon av följande metoder för att styra vilka resurser XmlReader som kan komma åt:

Begränsa resurserna som XmlReader kan få tillgång till genom att ställa in XmlResolver-egenskapen till ett XmlSecureResolver-objekt.

-eller-

Tillåt inte XmlReader att externa resurser öppnas genom att ange egenskapen XmlResolver till null.

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(Stream, XmlReaderSettings, XmlParserContext)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med den angivna strömmen, inställningarna och kontextinformationen för parsning.

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

Parametrar

input: Stream

Dataströmmen som innehåller XML-data.

Genomsöker XmlReader de första byteen i strömmen och letar efter ett byteordningsmärke eller andra tecken på kodning. När kodningen fastställs används kodningen för att fortsätta läsa dataströmmen, och bearbetningen fortsätter att parsa indata som en ström av (Unicode)-tecken.

settings: XmlReaderSettings

Inställningarna för den nya XmlReader instansen. Det här värdet kan vara null.

inputContext: XmlParserContext

Det här värdet kan vara null.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet input är null.

Kommentarer

Som standard används en XmlUrlResolver utan autentiseringsuppgifter för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Du kan använda någon av följande metoder för att styra vilka resurser XmlReader som kan komma åt:

Begränsa resurserna som XmlReader kan få tillgång till genom att ställa in XmlResolver-egenskapen till ett XmlSecureResolver-objekt.

-eller-

Tillåt inte XmlReader att externa resurser öppnas genom att ange egenskapen XmlResolver till null.

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(Stream, XmlReaderSettings, String)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med den angivna strömmen, bas-URI:n och inställningarna.

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

Parametrar

input: Stream

Dataströmmen som innehåller XML-data.

settings: XmlReaderSettings

Inställningarna för den nya XmlReader instansen. Det här värdet kan vara null.

baseUri: String

Bas-URI:n för entiteten eller dokumentet som läses. Det här värdet kan vara null.

Säkerhetsanteckning Bas-URI:n används för att matcha xml-dokumentets relativa URI. Använd inte en bas-URI från en ej betrodd källa.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet input är null.

Kommentarer

Som standard används en XmlUrlResolver utan autentiseringsuppgifter för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Du kan använda någon av följande metoder för att styra vilka resurser XmlReader som kan komma åt:

Begränsa resurserna som XmlReader kan få tillgång till genom att ställa in XmlResolver-egenskapen till ett XmlSecureResolver-objekt.

-eller-

Tillåt inte XmlReader att externa resurser öppnas genom att ange egenskapen XmlResolver till null.

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(XmlReader, XmlReaderSettings)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med den angivna XML-läsaren och inställningarna.

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

Parametrar

reader: XmlReader

Det objekt som du vill använda som underliggande XML-läsare.

settings: XmlReaderSettings

Inställningarna för den nya XmlReader instansen.

Objektets XmlReaderSettings överensstämmelsenivå måste antingen matcha den underliggande läsarens överensstämmelsenivå eller vara inställt på Auto.

Returer

XmlReader

Ett objekt som omsluts av det angivna XmlReader objektet.

Undantag

ArgumentNullException

Värdet reader är null.

InvalidOperationException

Om objektet XmlReaderSettings anger en överensstämmelsenivå som inte är konsekvent med den underliggande läsarens efterlevnadsnivå.

-eller-

Den underliggande XmlReader är i ett Error eller-tillstånd Closed .

Exempel

I följande exempel skapas ett valideringsobjekt XmlReader som omsluts av ett XmlNodeReader objekt.

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

Kommentarer

Med den här metoden kan du lägga till ytterligare funktioner i ett underliggande XmlReader objekt. Det underliggande XmlReader objektet kan vara ett annat XmlReader objekt som skapats av Create metoden eller ett XmlReader objekt som skapats med någon av de konkreta XmlReader implementeringarna.

Ett standardvärde XmlUrlResolver utan autentiseringsuppgifter används för att komma åt externa resurser, till exempel ett schema.

Important

Om den externa resursen finns på en nätverksresurs som kräver autentisering anger du en XmlResolver med nödvändiga autentiseringsuppgifter med hjälp av XmlReaderSettings.XmlResolver egenskapen .

Important

Du kan använda någon av följande metoder för att styra vilka resurser XmlReader som kan komma åt:

Begränsa resurserna som XmlReader kan få tillgång till genom att ställa in XmlResolver-egenskapen till ett XmlSecureResolver-objekt.

-eller-

Tillåt inte XmlReader att externa resurser öppnas genom att ange egenskapen XmlResolver till null.

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(TextReader, XmlReaderSettings, String)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med den angivna textläsaren, inställningarna och bas-URI:n.

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

Parametrar

input: TextReader

Textläsaren som XML-data ska läsas från. En textläsare returnerar en ström med Unicode-tecken, så kodningen som anges i XML-deklarationen används inte av för att avkoda XmlReader dataströmmen.

settings: XmlReaderSettings

Inställningarna för den nya XmlReader instansen. Det här värdet kan vara null.

baseUri: String

Bas-URI:n för entiteten eller dokumentet som läses. Det här värdet kan vara null.

Säkerhetsanteckning Bas-URI:n används för att matcha xml-dokumentets relativa URI. Använd inte en bas-URI från en ej betrodd källa.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet input är null.

Kommentarer

Som standard används en XmlUrlResolver utan autentiseringsuppgifter för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Du kan använda någon av följande metoder för att styra vilka resurser XmlReader som kan komma åt:

Begränsa resurserna som XmlReader kan få tillgång till genom att ställa in XmlResolver-egenskapen till ett XmlSecureResolver-objekt.

-eller-

Tillåt inte XmlReader att externa resurser öppnas genom att ange egenskapen XmlResolver till null.

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(TextReader, XmlReaderSettings)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med hjälp av den angivna textläsaren och inställningarna.

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

Parametrar

input: TextReader

settings: XmlReaderSettings

Inställningarna för den nya XmlReader. Det här värdet kan vara null.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet input är null.

Kommentarer

Som standard används en XmlUrlResolver utan autentiseringsuppgifter för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Du kan använda någon av följande metoder för att styra vilka resurser XmlReader som kan komma åt:

Begränsa resurserna som XmlReader kan få tillgång till genom att ställa in XmlResolver-egenskapen till ett XmlSecureResolver-objekt.

-eller-

Tillåt inte XmlReader att externa resurser öppnas genom att ange egenskapen XmlResolver till null.

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(Stream, XmlReaderSettings)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med den angivna strömmen och inställningarna.

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

Parametrar

input: Stream

Dataströmmen som innehåller XML-data.

settings: XmlReaderSettings

Inställningarna för den nya XmlReader instansen. Det här värdet kan vara null.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet input är null.

Kommentarer

Som standard används en XmlUrlResolver utan autentiseringsuppgifter för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Du kan använda någon av följande metoder för att styra vilka resurser XmlReader som kan komma åt:

Begränsa resurserna som XmlReader kan få tillgång till genom att ställa in XmlResolver-egenskapen till ett XmlSecureResolver-objekt.

-eller-

Tillåt inte XmlReader att externa resurser öppnas genom att ange egenskapen XmlResolver till null.

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(String)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med angiven 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

Parametrar

inputUri: String

URI:n för filen som innehåller XML-data. Klassen XmlUrlResolver används för att konvertera sökvägen till en kanonisk datarepresentation.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet inputUri är null.

SecurityException

XmlReader Har inte tillräckliga behörigheter för att komma åt platsen för XML-data.

FileNotFoundException

Filen som identifieras av URI:n finns inte.

UriFormatException

URI-formatet är inte korrekt.

Obs! I .NET för Windows Store-appar eller Portable Class Library fångar du i stället basklassfelet FormatException.

Exempel

I följande exempel skapas ett XmlReader objekt som läser XML-datafilen som anges av URI:n.

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

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

Kommentarer

Ett XmlReaderSettings objekt med standardinställningar används för att skapa läsaren. Om du vill ange vilka funktioner som ska stödjas på den skapade läsaren använder du den överlagring som tar ett XmlReaderSettings objekt som ett av dess argument och skickar in ett XmlReaderSettings objekt med rätt inställningar.

Ett standardvärde XmlUrlResolver utan autentiseringsuppgifter används för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(TextReader)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med hjälp av den angivna textläsaren.

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

Parametrar

input: TextReader

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet input är null.

Exempel

I följande exempel används StringReader klassen för att läsa en XML-sträng.

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

Kommentarer

Ett standardvärde XmlUrlResolver utan autentiseringsuppgifter används för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(Stream)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med den angivna strömmen med standardinställningar.

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

Parametrar

input: Stream

Dataströmmen som innehåller XML-data.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet input är null.

SecurityException

XmlReader Har inte tillräckliga behörigheter för att komma åt platsen för XML-data.

Exempel

I följande exempel skapas ett XmlReader objekt som läser från en 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

Kommentarer

Ett standardvärde XmlUrlResolver utan autentiseringsuppgifter används för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Create(String, XmlReaderSettings)

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Källa:: XmlReader.cs

Skapar en ny XmlReader instans med hjälp av angiven URI och inställningar.

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

Parametrar

inputUri: String

settings: XmlReaderSettings

Inställningarna för den nya XmlReader instansen. Det här värdet kan vara null.

Returer

XmlReader

Ett objekt som används för att läsa XML-data i dataströmmen.

Undantag

ArgumentNullException

Värdet inputUri är null.

FileNotFoundException

Det går inte att hitta filen som anges av URI:n.

UriFormatException

URI-formatet är inte korrekt.

Obs! I .NET för Windows Store-appar eller Portable Class Library fångar du i stället basklassfelet FormatException.

Exempel

I följande exempel skapas ett XmlReader objekt som stöder validering av dokumenttypsdefinition (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

Kommentarer

Som standard används en XmlUrlResolver utan autentiseringsuppgifter för att komma åt externa resurser, till exempel en definition av dokumenttyp (DTD), entiteter, scheman och så vidare.

Important

Du kan begränsa de resurser som kan kommas åt genom att XmlReader ange XmlResolver egenskapen till ett XmlSecureResolver objekt.

Det skapade XmlReader objektet expanderar entitetsreferenser och utför XML-normalisering av nya radtecken.

Gäller för

Feedback

Var den här sidan till hjälp?