Udostępnij za pośrednictwem

XmlReader.Create Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Xml
Zestaw:
System.Xml.ReaderWriter.dll
Zestaw:
System.Xml.dll
Zestaw:
netstandard.dll

Tworzy nowe wystąpienie klasy XmlReader.

Przeciążenia

Create(String, XmlReaderSettings, XmlParserContext)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego identyfikatora URI, ustawień i informacji kontekstowych do analizowania.
Create(TextReader, XmlReaderSettings, XmlParserContext)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu, ustawień i informacji kontekstowych na potrzeby analizowania.
Create(Stream, XmlReaderSettings, XmlParserContext)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia, ustawień i informacji kontekstowych do analizowania.
Create(Stream, XmlReaderSettings, String)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia, podstawowego identyfikatora URI i ustawień.
Create(XmlReader, XmlReaderSettings)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika i ustawień XML.
Create(TextReader, XmlReaderSettings, String)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu, ustawień i podstawowego identyfikatora URI.
Create(TextReader, XmlReaderSettings)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu i ustawień.
Create(Stream, XmlReaderSettings)

Tworzy nowe XmlReader wystąpienie z określonym strumieniem i ustawieniami.
Create(String)

Tworzy nowe XmlReader wystąpienie z określonym identyfikatorem URI.
Create(TextReader)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu.
Create(Stream)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia z ustawieniami domyślnymi.
Create(String, XmlReaderSettings)

Tworzy nowe XmlReader wystąpienie przy użyciu określonego identyfikatora URI i ustawień.

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Uwagi dotyczące dodatkowego interfejsu API dla elementu XmlReader.Close.

Create(String, XmlReaderSettings, XmlParserContext)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego identyfikatora URI, ustawień i informacji kontekstowych do analizowania.

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

Identyfikator URI pliku zawierającego dane XML. Obiekt XmlResolver na XmlReaderSettings obiekcie służy do konwertowania ścieżki na reprezentację danych kanonicznych. Jeśli XmlResolver jest to null, jest używany nowy XmlUrlResolver obiekt.

settings
XmlReaderSettings

Ustawienia nowego XmlReader wystąpienia. Ta wartość może być następująca null: .

inputContext
XmlParserContext

Informacje kontekstowe wymagane do analizowania fragmentu XML. Informacje kontekstowe mogą obejmować XmlNameTable użycie, kodowanie, zakres przestrzeni nazw, bieżący xml:lang i xml:space zakres, podstawowy identyfikator URI i definicję typu dokumentu.

Ta wartość może być następująca null: .

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu inputUri to null.

SecurityException

Element XmlReader nie ma wystarczających uprawnień dostępu do lokalizacji danych XML.

ArgumentException

Właściwości NameTable i NameTable zawierają wartości. (Można ustawić i użyć tylko jednej z tych NameTable właściwości).

FileNotFoundException

Nie można odnaleźć pliku określonego przez identyfikator URI.

UriFormatException

Format identyfikatora URI nie jest poprawny.

Uwagi

Domyślnie bez XmlUrlResolver poświadczeń jest używany do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Oznacza to, że program XmlReader może uzyskiwać dostęp do wszystkich lokalizacji, które nie wymagają uwierzytelniania. Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Możesz ograniczyć zasoby, do których może uzyskiwać dostęp, XmlReader ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(TextReader, XmlReaderSettings, XmlParserContext)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu, ustawień i informacji kontekstowych na potrzeby analizowania.

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

Czytnik tekstu, z którego mają być odczytywane dane XML. Czytnik tekstu zwraca strumień znaków Unicode, więc kodowanie określone w deklaracji XML nie jest używane przez czytnik XML do dekodowania strumienia danych.

settings
XmlReaderSettings

Ustawienia nowego XmlReader wystąpienia. Ta wartość może być następująca null: .

inputContext
XmlParserContext

Informacje kontekstowe wymagane do analizowania fragmentu XML. Informacje kontekstowe mogą obejmować XmlNameTable użycie, kodowanie, zakres przestrzeni nazw, bieżący xml:lang i xml:space zakres, podstawowy identyfikator URI i definicję typu dokumentu.

Ta wartość może być następująca null: .

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

ArgumentException

Właściwości NameTable i NameTable zawierają wartości. (Można ustawić i użyć tylko jednej z tych NameTable właściwości).

Przykłady

Poniższy przykład tworzy XmlReader obiekt, który odczytuje 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)

Uwagi

Domyślnie bez XmlUrlResolver poświadczeń jest używany do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Jedną z następujących metod można użyć do kontrolowania XmlReader zasobów, do których można uzyskać dostęp:

-lub-

  • Nie zezwalaj na XmlReader otwieranie żadnych zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(Stream, XmlReaderSettings, XmlParserContext)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia, ustawień i informacji kontekstowych do analizowania.

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

Strumień zawierający dane XML.

Funkcja XmlReader skanuje pierwsze bajty strumienia, wyszukując znacznik kolejności bajtów lub inny znak kodowania. Po określeniu kodowania kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).

settings
XmlReaderSettings

Ustawienia nowego XmlReader wystąpienia. Ta wartość może być następująca null: .

inputContext
XmlParserContext

Informacje kontekstowe wymagane do analizowania fragmentu XML. Informacje kontekstowe mogą obejmować XmlNameTable użycie, kodowanie, zakres przestrzeni nazw, bieżący xml:lang i xml:space zakres, podstawowy identyfikator URI i definicję typu dokumentu.

Ta wartość może być następująca null: .

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie bez XmlUrlResolver poświadczeń jest używany do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Jedną z następujących metod można użyć do kontrolowania XmlReader zasobów, do których można uzyskać dostęp:

-lub-

  • Nie zezwalaj na XmlReader otwieranie żadnych zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(Stream, XmlReaderSettings, String)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia, podstawowego identyfikatora URI i ustawień.

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

Strumień zawierający dane XML.

Funkcja XmlReader skanuje pierwsze bajty strumienia, wyszukując znacznik kolejności bajtów lub inny znak kodowania. Po określeniu kodowania kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).

settings
XmlReaderSettings

Ustawienia nowego XmlReader wystąpienia. Ta wartość może być następująca null: .

baseUri
String

Podstawowy identyfikator URI dla odczytywanej jednostki lub dokumentu. Ta wartość może być następująca null: .

Uwaga dotycząca zabezpieczeń Podstawowy identyfikator URI służy do rozpoznawania względnego identyfikatora URI dokumentu XML. Nie używaj podstawowego identyfikatora URI ze źródła niezaufanego.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie bez XmlUrlResolver poświadczeń jest używany do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Jedną z następujących metod można użyć do kontrolowania XmlReader zasobów, do których można uzyskać dostęp:

-lub-

  • Nie zezwalaj na XmlReader otwieranie żadnych zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(XmlReader, XmlReaderSettings)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika i ustawień XML.

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

Obiekt, którego chcesz użyć jako podstawowego czytnika XML.

settings
XmlReaderSettings

Ustawienia nowego XmlReader wystąpienia.

Poziom XmlReaderSettings zgodności obiektu musi być zgodny z poziomem zgodności podstawowego czytnika lub musi być ustawiony na Autowartość .

Zwraca

XmlReader

Obiekt, który jest opakowany wokół określonego XmlReader obiektu.

Wyjątki

ArgumentNullException

Wartość elementu reader to null.

InvalidOperationException

XmlReaderSettings Jeśli obiekt określa poziom zgodności, który nie jest zgodny z poziomem zgodności podstawowego czytnika.

-lub-

Element bazowy XmlReader jest w Error stanie lub Closed .

Przykłady

Poniższy przykład tworzy prawidłowy XmlReader obiekt, który jest opakowany wokół XmlNodeReader obiektu.

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

Uwagi

Ta metoda umożliwia dodawanie dodatkowych funkcji do obiektu bazowego XmlReader . Obiekt bazowy XmlReader może być innym XmlReader obiektem utworzonym przez metodę Create lub XmlReader obiektem utworzonym przy użyciu jednej z konkretnych XmlReader implementacji.

Wartość domyślna XmlUrlResolver bez poświadczeń jest używana do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak schemat.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, określ XmlResolver element z wymaganymi poświadczeniami przy użyciu XmlReaderSettings.XmlResolver właściwości .

Ważne

Jedną z następujących metod można użyć do kontrolowania XmlReader zasobów, do których można uzyskać dostęp:

-lub-

  • Nie zezwalaj na XmlReader otwieranie żadnych zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(TextReader, XmlReaderSettings, String)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu, ustawień i podstawowego identyfikatora 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

Czytnik tekstu, z którego mają być odczytywane dane XML. Czytnik tekstu zwraca strumień znaków Unicode, więc kodowanie określone w deklaracji XML nie jest używane przez XmlReader element do dekodowania strumienia danych.

settings
XmlReaderSettings

Ustawienia nowego XmlReader wystąpienia. Ta wartość może być następująca null: .

baseUri
String

Podstawowy identyfikator URI dla odczytywanej jednostki lub dokumentu. Ta wartość może być następująca null: .

Uwaga dotycząca zabezpieczeń Podstawowy identyfikator URI służy do rozpoznawania względnego identyfikatora URI dokumentu XML. Nie używaj podstawowego identyfikatora URI ze źródła niezaufanego.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie bez XmlUrlResolver poświadczeń jest używany do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Jedną z następujących metod można użyć do kontrolowania XmlReader zasobów, do których można uzyskać dostęp:

-lub-

  • Nie zezwalaj na XmlReader otwieranie żadnych zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(TextReader, XmlReaderSettings)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu i ustawień.

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

Czytnik tekstu, z którego mają być odczytywane dane XML. Czytnik tekstu zwraca strumień znaków Unicode, więc kodowanie określone w deklaracji XML nie jest używane przez czytnik XML do dekodowania strumienia danych.

settings
XmlReaderSettings

Ustawienia dla nowego XmlReaderelementu . Ta wartość może być następująca null: .

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie bez XmlUrlResolver poświadczeń jest używany do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Jedną z następujących metod można użyć do kontrolowania XmlReader zasobów, do których można uzyskać dostęp:

-lub-

  • Nie zezwalaj na XmlReader otwieranie żadnych zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(Stream, XmlReaderSettings)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie z określonym strumieniem i ustawieniami.

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

Strumień zawierający dane XML.

Funkcja XmlReader skanuje pierwsze bajty strumienia, wyszukując znacznik kolejności bajtów lub inny znak kodowania. Po określeniu kodowania kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).

settings
XmlReaderSettings

Ustawienia nowego XmlReader wystąpienia. Ta wartość może być następująca null: .

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Uwagi

Domyślnie bez XmlUrlResolver poświadczeń jest używany do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Jedną z następujących metod można użyć do kontrolowania XmlReader zasobów, do których można uzyskać dostęp:

-lub-

  • Nie zezwalaj na XmlReader otwieranie żadnych zasobów zewnętrznych przez ustawienie XmlResolver właściwości na null.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(String)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie z określonym identyfikatorem 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

Identyfikator URI pliku, który zawiera dane XML. Klasa XmlUrlResolver służy do konwertowania ścieżki na reprezentację danych kanonicznych.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu inputUri to null.

SecurityException

Element XmlReader nie ma wystarczających uprawnień dostępu do lokalizacji danych XML.

FileNotFoundException

Plik zidentyfikowany przez identyfikator URI nie istnieje.

UriFormatException

Format identyfikatora URI nie jest poprawny.

Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klas przechwyć wyjątek klasy bazowej , FormatExceptionzamiast tego.

Przykłady

Poniższy przykład tworzy XmlReader obiekt, który odczytuje plik danych XML określony przez identyfikator URI.

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

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

Uwagi

Obiekt XmlReaderSettings z ustawieniami domyślnymi służy do tworzenia czytnika. Jeśli chcesz określić funkcje do obsługi utworzonego czytnika, użyj przeciążenia, które przyjmuje XmlReaderSettings obiekt jako jeden z jego argumentów, i przekaż XmlReaderSettings obiekt z odpowiednimi ustawieniami.

Ustawienie domyślne XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, określ XmlResolver element z wymaganymi poświadczeniami przy użyciu XmlReaderSettings.XmlResolver właściwości .

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(TextReader)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego czytnika tekstu.

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

Czytnik tekstu, z którego mają być odczytywane dane XML. Czytnik tekstu zwraca strumień znaków Unicode, więc kodowanie określone w deklaracji XML nie jest używane przez czytnik XML do dekodowania strumienia danych.

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

Przykłady

W poniższym przykładzie StringReader użyto klasy do odczytania ciągu 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))

Uwagi

Obiekt XmlReaderSettings z ustawieniami domyślnymi służy do tworzenia czytnika. Jeśli chcesz określić funkcje do obsługi utworzonego czytnika, użyj przeciążenia, które przyjmuje XmlReaderSettings obiekt jako jeden z jego argumentów, i przekaż XmlReaderSettings obiekt z odpowiednimi ustawieniami.

Ustawienie domyślne XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, określ XmlResolver element z wymaganymi poświadczeniami przy użyciu XmlReaderSettings.XmlResolver właściwości .

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(Stream)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego strumienia z ustawieniami domyślnymi.

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

Strumień zawierający dane XML.

Funkcja XmlReader skanuje pierwsze bajty strumienia, wyszukując znacznik kolejności bajtów lub inny znak kodowania. Po określeniu kodowania kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu input to null.

SecurityException

Element XmlReader nie ma wystarczających uprawnień dostępu do lokalizacji danych XML.

Przykłady

Poniższy przykład tworzy XmlReader obiekt, który odczytuje z obiektu 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

Uwagi

Obiekt XmlReaderSettings z ustawieniami domyślnymi służy do tworzenia czytnika. Jeśli chcesz określić funkcje do obsługi utworzonego czytnika, użyj przeciążenia, które przyjmuje XmlReaderSettings obiekt jako jeden z jego argumentów, i przekaż XmlReaderSettings obiekt z odpowiednimi ustawieniami.

Ustawienie domyślne XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, określ XmlResolver element z wymaganymi poświadczeniami przy użyciu XmlReaderSettings.XmlResolver właściwości .

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy

Create(String, XmlReaderSettings)

Źródło:
XmlReader.cs
Źródło:
XmlReader.cs
Źródło:
XmlReader.cs

Tworzy nowe XmlReader wystąpienie przy użyciu określonego identyfikatora URI i ustawień.

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

Identyfikator URI pliku zawierającego dane XML. Obiekt XmlResolver na XmlReaderSettings obiekcie służy do konwertowania ścieżki na reprezentację danych kanonicznych. Jeśli XmlResolver jest to null, jest używany nowy XmlUrlResolver obiekt.

settings
XmlReaderSettings

Ustawienia nowego XmlReader wystąpienia. Ta wartość może być następująca null: .

Zwraca

XmlReader

Obiekt używany do odczytywania danych XML w strumieniu.

Wyjątki

ArgumentNullException

Wartość elementu inputUri to null.

FileNotFoundException

Nie można odnaleźć pliku określonego przez identyfikator URI.

UriFormatException

Format identyfikatora URI nie jest poprawny.

Uwaga: na platformie .NET dla aplikacji ze Sklepu Windows lub przenośnej biblioteki klas przechwyć wyjątek klasy bazowej , FormatExceptionzamiast tego.

Przykłady

Poniższy przykład tworzy obiekt, który obsługuje walidację XmlReader definicji 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

Uwagi

Domyślnie bez XmlUrlResolver poświadczeń jest używany do uzyskiwania dostępu do jakichkolwiek zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy itd.

Ważne

Począwszy od programu .NET Framework 4.5.2, nie podano wartości domyślnej XmlUrlResolver . Jeśli rozwiązanie jest przeznaczone dla wersji .NET Framework 4.5.2 lub nowszej, określ XmlResolver właściwość using .XmlReaderSettings.XmlResolver

Oznacza to, że program XmlReader może uzyskiwać dostęp do wszystkich lokalizacji, które nie wymagają uwierzytelniania. Jeśli zasób zewnętrzny znajduje się w zasobie sieciowym, który wymaga uwierzytelniania, użyj XmlReaderSettings.XmlResolver właściwości , aby określić element XmlResolver z wymaganymi poświadczeniami.

Ważne

Możesz ograniczyć zasoby, do których może uzyskiwać dostęp, XmlReader ustawiając XmlResolver właściwość na XmlSecureResolver obiekt.

Utworzony XmlReader obiekt rozszerza odwołania do jednostki i wykonuje normalizację XML nowych znaków wiersza.

Dotyczy