XmlReader.Create Metoda

Definicja

Tworzy nowe wystąpienie klasy XmlReader.Creates a new XmlReader instance.

Przeciążenia

Create(String, XmlReaderSettings, XmlParserContext)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego identyfikatora URI, ustawień i informacji kontekstowych do analizy.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika tekstu, ustawień i informacji kontekstowych do analizy.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, XmlParserContext)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego strumienia, ustawień i informacji kontekstowych do analizy.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, String)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego strumienia, podstawowego identyfikatora URI i ustawień.Creates a new XmlReader instance using the specified stream, base URI, and settings.

Create(XmlReader, XmlReaderSettings)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika i ustawień XML.Creates a new XmlReader instance by using the specified XML reader and settings.

Create(TextReader, XmlReaderSettings, String)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika tekstu, ustawień i podstawowego identyfikatora URI.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

Create(TextReader, XmlReaderSettings)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika tekstu i ustawień.Creates a new XmlReader instance by using the specified text reader and settings.

Create(Stream, XmlReaderSettings)

Tworzy nowe wystąpienie XmlReader z określonym strumieniem i ustawieniami.Creates a new XmlReader instance with the specified stream and settings.

Create(String)

Tworzy nowe wystąpienie XmlReader o określonym identyfikatorze URI.Creates a new XmlReader instance with specified URI.

Create(TextReader)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika tekstu.Creates a new XmlReader instance by using the specified text reader.

Create(Stream)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego strumienia z ustawieniami domyślnymi.Creates a new XmlReader instance using the specified stream with default settings.

Create(String, XmlReaderSettings)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego identyfikatora URI i ustawień.Creates a new XmlReader instance by using the specified URI and settings.

Przykłady

W tym przykładzie tworzony jest czytnik XML, który przypasaj nieznaczący biały znak, paski komentarzy i wykonuje sprawdzanie zgodności na poziomie fragmentów.This example creates an XML reader that strips insignificant white space, strips comments, and performs fragment-level conformance checking.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
settings.IgnoreWhitespace = true;
settings.IgnoreComments = true;
XmlReader reader = XmlReader.Create("books.xml", settings);

Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
settings.IgnoreWhitespace = true
settings.IgnoreComments = true
Dim reader As XmlReader = XmlReader.Create("books.xml", settings)

Poniższy przykład używa XmlUrlResolver z poświadczeniami domyślnymi w celu uzyskania dostępu do pliku.The following example uses an XmlUrlResolver with default credentials to access a file.

// Set the reader settings.
XmlReaderSettings^ settings = gcnew XmlReaderSettings;
settings->IgnoreComments = true;
settings->IgnoreProcessingInstructions = true;
settings->IgnoreWhitespace = true;

// Set the reader settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true;
settings.IgnoreProcessingInstructions = true;
settings.IgnoreWhitespace = true;
' Set the reader settings.
Dim settings as XmlReaderSettings = new XmlReaderSettings()
settings.IgnoreComments = true
settings.IgnoreProcessingInstructions = true
settings.IgnoreWhitespace = true
// Create a resolver with default credentials.
XmlUrlResolver^ resolver = gcnew XmlUrlResolver;
resolver->Credentials = System::Net::CredentialCache::DefaultCredentials;

 // Set the reader settings object to use the resolver.
 settings->XmlResolver = resolver;

// Create the XmlReader object.
XmlReader^ reader = XmlReader::Create( L"http://ServerName/data/books.xml", settings );

  // Create a resolver with default credentials.
  XmlUrlResolver resolver = new XmlUrlResolver();
  resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;

  // Set the reader settings object to use the resolver.
  settings.XmlResolver = resolver;

  // Create the XmlReader object.
  XmlReader reader = XmlReader.Create("http://ServerName/data/books.xml", settings);
' Create a resolver with default credentials.
Dim resolver as XmlUrlResolver = new XmlUrlResolver()
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials

' Set the reader settings object to use the resolver.
settings.XmlResolver = resolver

' Create the XmlReader object.
Dim reader as XmlReader = XmlReader.Create("http://ServerName/data/books.xml", settings)

Poniższy kod otacza wystąpienie czytnika w innym czytniku.The following code wraps a reader instance within another reader.

XmlTextReader txtReader = new XmlTextReader("bookOrder.xml");
XmlReaderSettings settings = new XmlReaderSettings();
settings.Schemas.Add("urn:po-schema", "PO.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader reader = XmlReader.Create(txtReader, settings);

Dim txtReader As XmlTextReader = New XmlTextReader("bookOrder.xml")
Dim settings As New XmlReaderSettings()
settings.Schemas.Add("urn:po-schema", "PO.xsd")
settings.ValidationType = ValidationType.Schema
Dim reader As XmlReader = XmlReader.Create(txtReader, settings)

Ten przykład umożliwia łańcuchom Dodawanie elementów DTD i sprawdzanie poprawności schematu XML.This example chains readers to add DTD and XML schema validation.

XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.DTD;
XmlReader inner = XmlReader.Create("book.xml", settings); // DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd");
settings.ValidationType = ValidationType.Schema;
XmlReader outer = XmlReader.Create(inner, settings);  // XML Schema Validation
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.DTD
Dim inner As XmlReader = XmlReader.Create("book.xml", settings) ' DTD Validation
settings.Schemas.Add("urn:book-schema", "book.xsd")
settings.ValidationType = ValidationType.Schema
Dim outer As XmlReader = XmlReader.Create(inner, settings)  ' XML Schema Validation

Uwagi

Większość przeciążeń Create zawierają parametr settings, który akceptuje obiekt XmlReaderSettings.Most of the Create overloads include a settings parameter that accepts an XmlReaderSettings object. Można użyć tego obiektu, aby:You can use this object to:

  • Określ, które funkcje mają być obsługiwane w obiekcie XmlReader.Specify which features you want supported on the XmlReader object.

  • Użyj ponownie obiektu XmlReaderSettings, aby utworzyć wielu czytników.Reuse the XmlReaderSettings object to create multiple readers. Możesz użyć tych samych ustawień, aby utworzyć wielu czytników z tą samą funkcjonalnością.You can use the same settings to create multiple readers with the same functionality. Można też zmodyfikować ustawienia w wystąpieniu XmlReaderSettings i utworzyć nowy czytelnik z innym zestawem funkcji.Or, you can modify the settings on an XmlReaderSettings instance and create a new reader with a different set of features.

  • Dodaj funkcje do istniejącego czytnika XML.Add features to an existing XML reader. Metoda Create może akceptować inny obiekt XmlReader.The Create method can accept another XmlReader object. Podstawowy obiekt XmlReader może być czytelnikem zdefiniowanym przez użytkownika, obiektem XmlTextReader lub innym wystąpieniem XmlReader, do którego chcesz dodać dodatkowe funkcje.The underlying XmlReader object can be a user-defined reader, a XmlTextReader object, or another XmlReader instance that you want to add additional features to.

  • W pełni korzystaj z funkcji, takich jak lepsze sprawdzanie zgodności i zgodność z zaleceniem XML 1,0 (w czwartej wersji) , które są dostępne tylko dla XmlReader obiektów utworzonych przez metodę statycznego Create.Take full advantage of features such as better conformance checking and compliance to the XML 1.0 (fourth edition) recommendation that are available only on XmlReader objects created by the static Create method.

Uwaga

Chociaż .NET Framework obejmuje konkretne implementacje klasy XmlReader, takie jak XmlTextReader, XmlNodeReaderi klasy XmlValidatingReader, zalecamy utworzenie wystąpień XmlReader przy użyciu metody Create.Although the .NET Framework includes concrete implementations of the XmlReader class, such as the XmlTextReader, XmlNodeReader, and the XmlValidatingReader classes, we recommend that you create XmlReader instances by using the Create method.

Ustawienia domyślneDefault settings

Jeśli używasz przeciążenia Create, które nie akceptuje obiektu XmlReaderSettings, zostaną użyte następujące domyślne ustawienia czytnika:If you use a Create overload that doesn't accept a XmlReaderSettings object, the following default reader settings are used:

UstawienieSetting DomyślnyDefault
CheckCharacters true
ConformanceLevel ConformanceLevel.Document
IgnoreComments false
IgnoreProcessingInstructions false
IgnoreWhitespace false
LineNumberOffset 00
LinePositionOffset 00
NameTable null
DtdProcessing Prohibit
Schemas Pusty obiekt XmlSchemaSetAn empty XmlSchemaSet object
ValidationFlags ProcessIdentityConstraints włączonyProcessIdentityConstraints enabled
ValidationType None
XmlResolver Nowy obiekt XmlUrlResolver.A new XmlUrlResolver object. Począwszy od .NET Framework 4.5.2, to ustawienie ma wartość domyślną null.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

Ustawienia dla typowych scenariuszySettings for common scenarios

Poniżej przedstawiono właściwości XmlReaderSettings, które należy ustawić dla niektórych typowych scenariuszy czytnika XML.Here are the XmlReaderSettings properties you should set for some of the typical XML reader scenarios.

WymaganieRequirement Ustaw nagłówekSet
Dane muszą być poprawnie sformułowanym dokumentem XML.Data must be a well-formed XML document. z programu ConformanceLevel do programu Document.ConformanceLevel to Document.
Dane muszą być poprawnie sformułowaną jednostką przeanalizowanym XML.Data must be a well-formed XML parsed entity. z programu ConformanceLevel do programu Fragment.ConformanceLevel to Fragment.
Dane muszą być zweryfikowane pod kątem DTD.Data must be validated against a DTD. Od DtdProcessing do ParseDtdProcessing to Parse
z programu ValidationType do programu DTD.ValidationType to DTD.
Dane muszą być zweryfikowane względem schematu XML.Data must be validated against an XML schema. Od ValidationType do SchemaValidationType to Schema
Schemas XmlSchemaSet do użycia podczas walidacji.Schemas to the XmlSchemaSet to use for validation. Należy zauważyć, że XmlReader nie obsługuje walidacji schematu danych XML (XDR).Note that XmlReader doesn't support XML-Data Reduced (XDR) schema validation.
Dane muszą być zweryfikowane względem wbudowanego schematu XML.Data must be validated against an inline XML schema. Od ValidationType do SchemaValidationType to Schema
z programu ValidationFlags do programu ProcessInlineSchema.ValidationFlags to ProcessInlineSchema.
Obsługa typów.Type support. Od ValidationType do SchemaValidationType to Schema
Schemas do XmlSchemaSet do użycia.Schemas to the XmlSchemaSet to use.

XmlReader nie obsługuje walidacji schematu danych XML (XDR).XmlReader doesn't support XML-Data Reduced (XDR) schema validation.

Programowanie asynchroniczneAsynchronous programming

W trybie synchronicznym Metoda Create odczytuje pierwszy fragment danych z bufora pliku, strumienia lub czytnika tekstu.In synchronous mode, the Create method reads the first chunk of data from the buffer of the file, stream, or text reader. Może to zgłosić wyjątek, jeśli operacja we/wy nie powiedzie się.This may throw an exception if an I/O operation fails. W trybie asynchronicznym Pierwsza operacja we/wy odbywa się z operacją odczytu, dlatego w przypadku wystąpienia operacji odczytu zostaną zgłoszone wyjątki.In asynchronous mode, the first I/O operation occurs with a read operation, so exceptions that arise will be thrown when the read operation occurs.

Zagadnienia dotyczące bezpieczeństwaSecurity considerations

Domyślnie XmlReader używa obiektu XmlUrlResolver bez poświadczeń użytkownika do otwierania zasobów.By default, the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. Oznacza to, że domyślnie czytnik XML ma dostęp do dowolnej lokalizacji, która nie wymaga poświadczeń.This means that, by default, the XML reader can access any location that doesn't require credentials. Użyj właściwości XmlResolver, aby kontrolować dostęp do zasobów:Use the XmlResolver property to control access to resources:

lub-or-

  • Ustaw XmlResolver na null, aby uniemożliwić odczytywanie przez czytnika XML żadnych zasobów zewnętrznych.Set XmlResolver to null to prevent the XML reader from opening any external resources.

Create(String, XmlReaderSettings, XmlParserContext)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego identyfikatora URI, ustawień i informacji kontekstowych do analizy.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

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

Identyfikator URI pliku zawierającego dane XML.The URI for the file containing the XML data. Obiekt XmlResolver w obiekcie XmlReaderSettings służy do konwertowania ścieżki na reprezentację danych kanonicznych.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Jeśli XmlResolver jest null, zostanie użyty nowy obiekt XmlUrlResolver.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

Ustawienia dla nowego wystąpienia XmlReader.The settings for the new XmlReader instance. Ta wartość może być null.This value can be null.

inputContext
XmlParserContext

Informacje kontekstowe wymagane do przeanalizowania fragmentu kodu XML.The context information required to parse the XML fragment. Informacje kontekstowe mogą zawierać XmlNameTable, które mają być używane, kodowanie, zakres przestrzeni nazw, bieżące XML: lang i XML: zakres obszaru , podstawowy identyfikator URI i definicja typu dokumentu.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Ta wartość może być null.This value can be null.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość inputUri jest null.The inputUri value is null.

XmlReader nie ma wystarczających uprawnień, aby uzyskać dostęp do lokalizacji danych XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Właściwości NameTable i NameTable zawierają wartości.The NameTable and NameTable properties both contain values. (Można ustawić i użyć tylko jednej z tych właściwości NameTable).(Only one of these NameTable properties can be set and used).

Nie można znaleźć pliku określonego przez identyfikator URI.The file specified by the URI cannot be found.

Format identyfikatora URI jest niepoprawny.The URI format is not correct.

Uwagi

Domyślnie XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Oznacza to, że XmlReader może uzyskać dostęp do dowolnych lokalizacji, które nie wymagają uwierzytelniania.This means that the XmlReader can access any locations that does not require authentication. Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, użyj właściwości XmlReaderSettings.XmlResolver, aby określić XmlResolver z niezbędnymi poświadczeniami.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Ważne

Można ograniczyć zasoby, do których XmlReader może uzyskać dostęp, ustawiając właściwość XmlResolver na obiekt XmlSecureResolver.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika tekstu, ustawień i informacji kontekstowych do analizy.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

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.The text reader from which to read the XML data. Czytnik tekstu zwraca strumień znaków Unicode, więc kodowanie określone w deklaracji XML nie jest używane przez czytnika XML do dekodowania strumienia danych.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings

Ustawienia dla nowego wystąpienia XmlReader.The settings for the new XmlReader instance. Ta wartość może być null.This value can be null.

inputContext
XmlParserContext

Informacje kontekstowe wymagane do przeanalizowania fragmentu kodu XML.The context information required to parse the XML fragment. Informacje kontekstowe mogą zawierać XmlNameTable, które mają być używane, kodowanie, zakres przestrzeni nazw, bieżące XML: lang i XML: zakres obszaru , podstawowy identyfikator URI i definicja typu dokumentu.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Ta wartość może być null.This value can be null.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość input jest null.The input value is null.

Właściwości NameTable i NameTable zawierają wartości.The NameTable and NameTable properties both contain values. (Można ustawić i użyć tylko jednej z tych właściwości NameTable).(Only one of these NameTable properties can be set and used).

Przykłady

Poniższy przykład tworzy obiekt XmlReader, który odczytuje fragment XML.The following example creates an XmlReader object that reads an 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)

Uwagi

Domyślnie XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, użyj właściwości XmlReaderSettings.XmlResolver, aby określić XmlResolver z niezbędnymi poświadczeniami.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Ważne

Możesz użyć jednej z następujących metod, aby kontrolować zasoby, do których XmlReader może uzyskać dostęp:You can use one of the following methods to control which resources the XmlReader can access:

lub-or-

  • Nie Zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie właściwości XmlResolver na null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, XmlParserContext)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego strumienia, ustawień i informacji kontekstowych do analizy.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

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.The stream that contains the XML data.

XmlReader skanuje pierwsze bajty strumienia, szukając znacznika kolejności bajtów lub innego znaku kodowania.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Po ustaleniu kodowania, kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

Ustawienia dla nowego wystąpienia XmlReader.The settings for the new XmlReader instance. Ta wartość może być null.This value can be null.

inputContext
XmlParserContext

Informacje kontekstowe wymagane do przeanalizowania fragmentu kodu XML.The context information required to parse the XML fragment. Informacje kontekstowe mogą zawierać XmlNameTable, które mają być używane, kodowanie, zakres przestrzeni nazw, bieżące XML: lang i XML: zakres obszaru , podstawowy identyfikator URI i definicja typu dokumentu.The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.

Ta wartość może być null.This value can be null.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość input jest null.The input value is null.

Uwagi

Domyślnie XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, użyj właściwości XmlReaderSettings.XmlResolver, aby określić XmlResolver z niezbędnymi poświadczeniami.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Ważne

Możesz użyć jednej z następujących metod, aby kontrolować zasoby, do których XmlReader może uzyskać dostęp:You can use one of the following methods to control which resources the XmlReader can access:

lub-or-

  • Nie Zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie właściwości XmlResolver na null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, String)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego strumienia, podstawowego identyfikatora URI i ustawień.Creates a new XmlReader instance using the specified stream, base URI, and settings.

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

Strumień zawierający dane XML.The stream that contains the XML data.

XmlReader skanuje pierwsze bajty strumienia, szukając znacznika kolejności bajtów lub innego znaku kodowania.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Po ustaleniu kodowania, kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

Ustawienia dla nowego wystąpienia XmlReader.The settings for the new XmlReader instance. Ta wartość może być null.This value can be null.

baseUri
String

Podstawowy identyfikator URI dla odczytywanego obiektu lub dokumentu.The base URI for the entity or document being read. Ta wartość może być null.This value can be null.

Uwaga dotycząca zabezpieczeń Podstawowy identyfikator URI jest używany do rozpoznawania względnego identyfikatora URI dokumentu XML.Security Note The base URI is used to resolve the relative URI of the XML document. Nie należy używać podstawowego identyfikatora URI z niezaufanego źródła.Do not use a base URI from an untrusted source.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość input jest null.The input value is null.

Uwagi

Domyślnie XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, użyj właściwości XmlReaderSettings.XmlResolver, aby określić XmlResolver z niezbędnymi poświadczeniami.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Ważne

Możesz użyć jednej z następujących metod, aby kontrolować zasoby, do których XmlReader może uzyskać dostęp:You can use one of the following methods to control which resources the XmlReader can access:

lub-or-

  • Nie Zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie właściwości XmlResolver na null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(XmlReader, XmlReaderSettings)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika i ustawień XML.Creates a new XmlReader instance by using the specified XML reader and 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óry ma być używany jako źródłowy czytnik XML.The object that you want to use as the underlying XML reader.

settings
XmlReaderSettings

Ustawienia dla nowego wystąpienia XmlReader.The settings for the new XmlReader instance.

Poziom zgodności obiektu XmlReaderSettings musi odpowiadać poziomowi zgodności czytnika bazowego lub musi być ustawiony na Auto.The conformance level of the XmlReaderSettings object must either match the conformance level of the underlying reader, or it must be set to Auto.

Zwraca

Obiekt, który jest opakowany wokół określonego XmlReader obiektu.An object that is wrapped around the specified XmlReader object.

Wyjątki

Wartość reader jest null.The reader value is null.

Jeśli obiekt XmlReaderSettings określa poziom zgodności, który nie jest spójny z poziomem zgodności dla czytnika.If the XmlReaderSettings object specifies a conformance level that is not consistent with conformance level of the underlying reader.

lub-or- XmlReader bazowa jest w stanie Error lub Closed.The underlying XmlReader is in an Error or Closed state.

Przykłady

Poniższy przykład tworzy walidację XmlReader obiektu, który jest opakowany wokół obiektu XmlNodeReader.The following example creates a validating XmlReader object that is wrapped around an XmlNodeReader object.

// 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 dodanie dodatkowych funkcji do bazowego obiektu XmlReader.This method allows you add additional features to an underlying XmlReader object. Źródłowy obiekt XmlReader może być innym obiektem XmlReader utworzonym przez metodę Create lub obiektem XmlReader utworzonym przy użyciu jednej z konkretnych implementacji XmlReader.The underlying XmlReader object can be another XmlReader object created by the Create method, or an XmlReader object created using one of the concrete XmlReader implementations.

Domyślny XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak schemat.A default XmlUrlResolver with no credentials is used to access any external resources such as a schema.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, określ XmlResolver z poświadczeniami niezbędnymi przy użyciu właściwości XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Ważne

Możesz użyć jednej z następujących metod, aby kontrolować zasoby, do których XmlReader może uzyskać dostęp:You can use one of the following methods to control which resources the XmlReader can access:

lub-or-

  • Nie Zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie właściwości XmlResolver na null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, String)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika tekstu, ustawień i podstawowego identyfikatora URI.Creates a new XmlReader instance by using the specified text reader, settings, and base 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

Czytnik tekstu, z którego mają być odczytywane dane XML.The text reader from which to read the XML data. Czytnik tekstu zwraca strumień znaków Unicode, więc kodowanie określone w deklaracji XML nie jest używane przez XmlReader do dekodowania strumienia danych.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XmlReader to decode the data stream.

settings
XmlReaderSettings

Ustawienia dla nowego wystąpienia XmlReader.The settings for the new XmlReader instance. Ta wartość może być null.This value can be null.

baseUri
String

Podstawowy identyfikator URI dla odczytywanego obiektu lub dokumentu.The base URI for the entity or document being read. Ta wartość może być null.This value can be null.

Uwaga dotycząca zabezpieczeń Podstawowy identyfikator URI jest używany do rozpoznawania względnego identyfikatora URI dokumentu XML.Security Note The base URI is used to resolve the relative URI of the XML document. Nie należy używać podstawowego identyfikatora URI z niezaufanego źródła.Do not use a base URI from an untrusted source.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość input jest null.The input value is null.

Uwagi

Domyślnie XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, użyj właściwości XmlReaderSettings.XmlResolver, aby określić XmlResolver z niezbędnymi poświadczeniami.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Ważne

Możesz użyć jednej z następujących metod, aby kontrolować zasoby, do których XmlReader może uzyskać dostęp:You can use one of the following methods to control which resources the XmlReader can access:

lub-or-

  • Nie Zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie właściwości XmlResolver na null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika tekstu i ustawień.Creates a new XmlReader instance by using the specified text reader and 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.The text reader from which to read the XML data. Czytnik tekstu zwraca strumień znaków Unicode, więc kodowanie określone w deklaracji XML nie jest używane przez czytnika XML do dekodowania strumienia danych.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream.

settings
XmlReaderSettings

Ustawienia dla nowego XmlReader.The settings for the new XmlReader. Ta wartość może być null.This value can be null.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość input jest null.The input value is null.

Uwagi

Domyślnie XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, użyj właściwości XmlReaderSettings.XmlResolver, aby określić XmlResolver z niezbędnymi poświadczeniami.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Ważne

Możesz użyć jednej z następujących metod, aby kontrolować zasoby, do których XmlReader może uzyskać dostęp:You can use one of the following methods to control which resources the XmlReader can access:

lub-or-

  • Nie Zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie właściwości XmlResolver na null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings)

Tworzy nowe wystąpienie XmlReader z określonym strumieniem i ustawieniami.Creates a new XmlReader instance with the specified stream and 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.The stream that contains the XML data.

XmlReader skanuje pierwsze bajty strumienia, szukając znacznika kolejności bajtów lub innego znaku kodowania.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Po ustaleniu kodowania, kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

settings
XmlReaderSettings

Ustawienia dla nowego wystąpienia XmlReader.The settings for the new XmlReader instance. Ta wartość może być null.This value can be null.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość input jest null.The input value is null.

Uwagi

Domyślnie XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, użyj właściwości XmlReaderSettings.XmlResolver, aby określić XmlResolver z niezbędnymi poświadczeniami.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Ważne

Możesz użyć jednej z następujących metod, aby kontrolować zasoby, do których XmlReader może uzyskać dostęp:You can use one of the following methods to control which resources the XmlReader can access:

lub-or-

  • Nie Zezwalaj XmlReader na otwieranie jakichkolwiek zasobów zewnętrznych przez ustawienie właściwości XmlResolver na null.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String)

Tworzy nowe wystąpienie XmlReader o określonym identyfikatorze URI.Creates a new XmlReader instance with specified 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 zawierającego dane XML.The URI for the file that contains the XML data. Klasa XmlUrlResolver służy do konwertowania ścieżki na reprezentację danych w postaci kanonicznej.The XmlUrlResolver class is used to convert the path to a canonical data representation.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość inputUri jest null.The inputUri value is null.

XmlReader nie ma wystarczających uprawnień, aby uzyskać dostęp do lokalizacji danych XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Plik identyfikowany przez identyfikator URI nie istnieje.The file identified by the URI does not exist.

W programie .NET dla aplikacji ze sklepu Windows lub przenośnej biblioteki klasPrzechwyć wyjątek klasy bazowej, FormatException, zamiast tego.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Format identyfikatora URI jest niepoprawny.The URI format is not correct.

Przykłady

Poniższy przykład tworzy obiekt XmlReader, który odczytuje plik danych XML określony przez identyfikator URI.The following example creates an XmlReader object that reads XML data file specified by the URI.

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

Uwagi

Do utworzenia czytnika jest używany obiekt XmlReaderSettings z ustawieniami domyślnymi.An XmlReaderSettings object with default settings is used to create the reader. Jeśli chcesz określić funkcje do obsługi dla utworzonego czytnika, Użyj przeciążenia, które przyjmuje obiekt XmlReaderSettings jako jeden z argumentów, i przekaż obiekt XmlReaderSettings z prawidłowymi ustawieniami.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Domyślny XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, określ XmlResolver z poświadczeniami niezbędnymi przy użyciu właściwości XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego czytnika tekstu.Creates a new XmlReader instance by using the specified text reader.

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.The text reader from which to read the XML data. 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.A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration is not used by the XML reader to decode the data stream.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość input jest null.The input value is null.

Przykłady

Poniższy przykład używa klasy StringReader, aby odczytać ciąg XML.The following example uses the StringReader class to read an XML string.

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

Do utworzenia czytnika jest używany obiekt XmlReaderSettings z ustawieniami domyślnymi.An XmlReaderSettings object with default settings is used to create the reader. Jeśli chcesz określić funkcje do obsługi dla utworzonego czytnika, Użyj przeciążenia, które przyjmuje obiekt XmlReaderSettings jako jeden z argumentów, i przekaż obiekt XmlReaderSettings z prawidłowymi ustawieniami.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Domyślny XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, określ XmlResolver z poświadczeniami niezbędnymi przy użyciu właściwości XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego strumienia z ustawieniami domyślnymi.Creates a new XmlReader instance using the specified stream with default settings.

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.The stream that contains the XML data.

XmlReader skanuje pierwsze bajty strumienia, szukając znacznika kolejności bajtów lub innego znaku kodowania.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. Po ustaleniu kodowania, kodowanie jest używane do kontynuowania odczytywania strumienia, a przetwarzanie kontynuuje analizowanie danych wejściowych jako strumienia znaków (Unicode).When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość input jest null.The input value is null.

XmlReader nie ma wystarczających uprawnień, aby uzyskać dostęp do lokalizacji danych XML.The XmlReader does not have sufficient permissions to access the location of the XML data.

Przykłady

Poniższy przykład tworzy obiekt XmlReader, który odczytuje z FileStream.The following example creates an XmlReader object that reads from a 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

Do utworzenia czytnika jest używany obiekt XmlReaderSettings z ustawieniami domyślnymi.An XmlReaderSettings object with default settings is used to create the reader. Jeśli chcesz określić funkcje do obsługi dla utworzonego czytnika, Użyj przeciążenia, które przyjmuje obiekt XmlReaderSettings jako jeden z argumentów, i przekaż obiekt XmlReaderSettings z prawidłowymi ustawieniami.If you wish to specify the features to support on the created reader, use the overload that takes an XmlReaderSettings object as one of its arguments, and pass in an XmlReaderSettings object with the correct settings.

Domyślny XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.A default XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, określ XmlResolver z poświadczeniami niezbędnymi przy użyciu właściwości XmlReaderSettings.XmlResolver.If the external resource is located on a network resource that requires authentication, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String, XmlReaderSettings)

Tworzy nowe wystąpienie XmlReader przy użyciu określonego identyfikatora URI i ustawień.Creates a new XmlReader instance by using the specified URI and settings.

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

Identyfikator URI pliku zawierającego dane XML.The URI for the file containing the XML data. Obiekt XmlResolver w obiekcie XmlReaderSettings służy do konwertowania ścieżki na reprezentację danych kanonicznych.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. Jeśli XmlResolver jest null, zostanie użyty nowy obiekt XmlUrlResolver.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings

Ustawienia dla nowego wystąpienia XmlReader.The settings for the new XmlReader instance. Ta wartość może być null.This value can be null.

Zwraca

Obiekt, który jest używany do odczytywania danych XML w strumieniu.An object that is used to read the XML data in the stream.

Wyjątki

Wartość inputUri jest null.The inputUri value is null.

Nie można znaleźć pliku określonego przez identyfikator URI.The file specified by the URI cannot be found.

W programie .NET dla aplikacji ze sklepu Windows lub przenośnej biblioteki klasPrzechwyć wyjątek klasy bazowej, FormatException, zamiast tego.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

Format identyfikatora URI jest niepoprawny.The URI format is not correct.

Przykłady

Poniższy przykład tworzy obiekt XmlReader, który obsługuje walidację definicji typu dokumentu (DTD).The following example creates an XmlReader object that supports document type definition (DTD) validation.

// 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 XmlUrlResolver bez poświadczeń służy do uzyskiwania dostępu do zasobów zewnętrznych, takich jak definicja typu dokumentu (DTD), jednostki, schematy i tak dalej.By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.

Ważne

Począwszy od .NET Framework 4.5.2 nie podano domyślnego XmlUrlResolver.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. Jeśli rozwiązanie jest przeznaczone dla .NET Framework w wersji 4.5.2 lub nowszej, określ XmlResolver przy użyciu właściwości XmlReaderSettings.XmlResolver.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

Oznacza to, że XmlReader może uzyskać dostęp do dowolnych lokalizacji, które nie wymagają uwierzytelniania.This means that the XmlReader can access any locations that does not require authentication. Jeśli zasób zewnętrzny znajduje się w ramach zasobu sieciowego, który wymaga uwierzytelnienia, użyj właściwości XmlReaderSettings.XmlResolver, aby określić XmlResolver z niezbędnymi poświadczeniami.If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings.XmlResolver property to specify an XmlResolver with the necessary credentials.

Ważne

Można ograniczyć zasoby, do których XmlReader może uzyskać dostęp, ustawiając właściwość XmlResolver na obiekt XmlSecureResolver.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

Utworzony obiekt XmlReader rozszerza odwołania do jednostek i wykonuje normalizację XML znaków nowego wiersza.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Dotyczy