Aracılığıyla paylaş

XmlReader.Create Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Xml
Bütünleştirilmiş Kod:
System.Xml.ReaderWriter.dll
Bütünleştirilmiş Kod:
System.Xml.dll
Bütünleştirilmiş Kod:
netstandard.dll

Yeni bir XmlReader örneği oluşturur.

Aşırı Yüklemeler

Create(String, XmlReaderSettings, XmlParserContext)

Ayrıştırma için belirtilen URI'yi, ayarları ve bağlam bilgilerini kullanarak yeni XmlReader bir örnek oluşturur.
Create(TextReader, XmlReaderSettings, XmlParserContext)

Ayrıştırma için belirtilen metin okuyucuyu, ayarları ve bağlam bilgilerini kullanarak yeni XmlReader bir örnek oluşturur.
Create(Stream, XmlReaderSettings, XmlParserContext)

Ayrıştırma için belirtilen akışı, ayarları ve bağlam bilgilerini kullanarak yeni XmlReader bir örnek oluşturur.
Create(Stream, XmlReaderSettings, String)

Belirtilen akışı, temel URI'yi ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.
Create(XmlReader, XmlReaderSettings)

Belirtilen XML okuyucuyu ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.
Create(TextReader, XmlReaderSettings, String)

Belirtilen metin okuyucuyu, ayarları ve temel URI'yi kullanarak yeni XmlReader bir örnek oluşturur.
Create(TextReader, XmlReaderSettings)

Belirtilen metin okuyucuyu ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.
Create(Stream, XmlReaderSettings)

Belirtilen akış ve ayarlarla yeni XmlReader bir örnek oluşturur.
Create(String)

Belirtilen URI ile yeni XmlReader bir örnek oluşturur.
Create(TextReader)

Belirtilen metin okuyucuyu kullanarak yeni XmlReader bir örnek oluşturur.
Create(Stream)

Varsayılan ayarlarla belirtilen akışı kullanarak yeni XmlReader bir örnek oluşturur.
Create(String, XmlReaderSettings)

Belirtilen URI'yi ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.

Açıklamalar

Bu API hakkında daha fazla bilgi için bkz . XmlReader.Close için ek API açıklamaları.

Create(String, XmlReaderSettings, XmlParserContext)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Ayrıştırma için belirtilen URI'yi, ayarları ve bağlam bilgilerini kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

inputUri
String

XML verilerini içeren dosyanın URI'sini. Nesnedeki XmlResolverXmlReaderSettings nesne, yolu kurallı veri gösterimine dönüştürmek için kullanılır. ise XmlResolvernull, yeni XmlUrlResolver bir nesne kullanılır.

settings
XmlReaderSettings

Yeni XmlReader örneğin ayarları. Bu değer olabilir null.

inputContext
XmlParserContext

XML parçasını ayrıştırmak için gereken bağlam bilgileri. Bağlam bilgileri kullanılacak, kodlama, ad alanı kapsamı, geçerli xml:lang ve xml:space kapsam, temel URI ve belge türü tanımını içerebilirXmlNameTable.

Bu değer olabilir null.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan bir nesne.

Özel durumlar

ArgumentNullException

inputUri değeri null olur.

SecurityException

, XmlReader XML verilerinin konumuna erişmek için yeterli izinlere sahip değil.

ArgumentException

NameTable ve NameTable özelliklerinin her ikisi de değer içerir. (Bu NameTable özelliklerden yalnızca biri ayarlanabilir ve kullanılabilir).

FileNotFoundException

URI tarafından belirtilen dosya bulunamıyor.

UriFormatException

URI biçimi doğru değil.

Açıklamalar

Varsayılan olarak XmlUrlResolver , belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgisi olmayan bir kullanılır.

Önemli

.NET Framework 4.5.2'den başlayarak varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Bu, öğesinin XmlReader kimlik doğrulaması gerektirmeyen tüm konumlara erişebileceği anlamına gelir. Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, gerekli kimlik bilgileriyle belirtmek XmlResolver için özelliğini kullanınXmlReaderSettings.XmlResolver.

Önemli

özelliğini bir XmlSecureResolver nesne olarak ayarlayarak öğesinin XmlReaderXmlResolver erişebileceği kaynakları kısıtlayabilirsiniz.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(TextReader, XmlReaderSettings, XmlParserContext)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Ayrıştırma için belirtilen metin okuyucuyu, ayarları ve bağlam bilgilerini kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

input
TextReader

XML verilerinin okunduğu metin okuyucu. Metin okuyucu unicode karakter akışı döndürdüğünden XML bildiriminde belirtilen kodlama XML okuyucusu tarafından veri akışının kodunu çözmek için kullanılmaz.

settings
XmlReaderSettings

Yeni XmlReader örneğin ayarları. Bu değer olabilir null.

inputContext
XmlParserContext

XML parçasını ayrıştırmak için gereken bağlam bilgileri. Bağlam bilgileri kullanılacak, kodlama, ad alanı kapsamı, geçerli xml:lang ve xml:space kapsam, temel URI ve belge türü tanımını içerebilirXmlNameTable.

Bu değer olabilir null.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan bir nesne.

Özel durumlar

ArgumentNullException

input değeri null olur.

ArgumentException

NameTable ve NameTable özelliklerinin her ikisi de değer içerir. (Bu NameTable özelliklerden yalnızca biri ayarlanabilir ve kullanılabilir.)

Örnekler

Aşağıdaki örnek, XML XmlReader parçasını okuyan bir nesne oluşturur.

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)

Açıklamalar

Varsayılan olarak XmlUrlResolver , belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgisi olmayan bir kullanılır.

Önemli

.NET Framework 4.5.2'den başlayarak varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, gerekli kimlik bilgileriyle belirtmek XmlResolver için özelliğini kullanınXmlReaderSettings.XmlResolver.

Önemli

Hangi kaynaklara XmlReader erişebileceğini denetlemek için aşağıdaki yöntemlerden birini kullanabilirsiniz:

-veya-

  • özelliğini nullolarak ayarlayarak öğesinin dış kaynakları açmasına XmlResolver izin XmlReader verme.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(Stream, XmlReaderSettings, XmlParserContext)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Ayrıştırma için belirtilen akışı, ayarları ve bağlam bilgilerini kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

input
Stream

XML verilerini içeren akış.

, XmlReader bayt sırası işaretini veya başka bir kodlama işaretini arayarak akışın ilk baytlarını tarar. Kodlama belirlendiğinde, akışı okumaya devam etmek için kodlama kullanılır ve işleme girişi (Unicode) karakterlerin akışı olarak ayrıştırmaya devam eder.

settings
XmlReaderSettings

Yeni XmlReader örneğin ayarları. Bu değer olabilir null.

inputContext
XmlParserContext

XML parçasını ayrıştırmak için gereken bağlam bilgileri. Bağlam bilgileri kullanılacak, kodlama, ad alanı kapsamı, geçerli xml:lang ve xml:space kapsam, temel URI ve belge türü tanımını içerebilirXmlNameTable.

Bu değer olabilir null.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan bir nesne.

Özel durumlar

ArgumentNullException

input değeri null olur.

Açıklamalar

Varsayılan olarak XmlUrlResolver , belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgisi olmayan bir kullanılır.

Önemli

.NET Framework 4.5.2'den başlayarak varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, gerekli kimlik bilgileriyle belirtmek XmlResolver için özelliğini kullanınXmlReaderSettings.XmlResolver.

Önemli

Hangi kaynaklara XmlReader erişebileceğini denetlemek için aşağıdaki yöntemlerden birini kullanabilirsiniz:

-veya-

  • özelliğini nullolarak ayarlayarak öğesinin dış kaynakları açmasına XmlResolver izin XmlReader verme.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(Stream, XmlReaderSettings, String)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Belirtilen akışı, temel URI'yi ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

input
Stream

XML verilerini içeren akış.

, XmlReader bayt sırası işaretini veya başka bir kodlama işaretini arayarak akışın ilk baytlarını tarar. Kodlama belirlendiğinde, akışı okumaya devam etmek için kodlama kullanılır ve işleme girişi (Unicode) karakterlerin akışı olarak ayrıştırmaya devam eder.

settings
XmlReaderSettings

Yeni XmlReader örneğin ayarları. Bu değer olabilir null.

baseUri
String

Okunan varlık veya belge için temel URI. Bu değer olabilir null.

Güvenlik Notu Temel URI, XML belgesinin göreli URI'sini çözümlemek için kullanılır. Güvenilmeyen bir kaynaktan temel URI kullanmayın.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan bir nesne.

Özel durumlar

ArgumentNullException

input değeri null olur.

Açıklamalar

Varsayılan olarak XmlUrlResolver , belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgisi olmayan bir kullanılır.

Önemli

.NET Framework 4.5.2'den başlayarak varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, gerekli kimlik bilgileriyle belirtmek XmlResolver için özelliğini kullanınXmlReaderSettings.XmlResolver.

Önemli

Hangi kaynaklara XmlReader erişebileceğini denetlemek için aşağıdaki yöntemlerden birini kullanabilirsiniz:

-veya-

  • özelliğini nullolarak ayarlayarak öğesinin dış kaynakları açmasına XmlResolver izin XmlReader verme.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(XmlReader, XmlReaderSettings)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Belirtilen XML okuyucuyu ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

reader
XmlReader

Temel XML okuyucusu olarak kullanmak istediğiniz nesne.

settings
XmlReaderSettings

Yeni XmlReader örneğin ayarları.

Nesnenin XmlReaderSettings uyumluluk düzeyi, temel okuyucunun uyumluluk düzeyiyle eşleşmeli veya olarak ayarlanmalıdır Auto.

Döndürülenler

XmlReader

Belirtilen XmlReader nesnenin çevresinde sarmalanmış bir nesne.

Özel durumlar

ArgumentNullException

reader değeri null olur.

InvalidOperationException

Nesne, XmlReaderSettings temel okuyucunun uyumluluk düzeyiyle tutarlı olmayan bir uyumluluk düzeyi belirtiyorsa.

-veya-

Temel alınan XmlReader bir veya Closed durumundadırError.

Örnekler

Aşağıdaki örnek, bir nesnenin çevresinde sarmalanmış bir XmlNodeReader doğrulama XmlReader nesnesi oluşturur.

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

Açıklamalar

Bu yöntem, temel alınan XmlReader bir nesneye ek özellikler eklemenize olanak tanır. Temel alınan XmlReader nesne yöntemi tarafından Create oluşturulan başka bir XmlReader nesne veya somut XmlReader uygulamalardan biri kullanılarak oluşturulan bir XmlReader nesne olabilir.

Şema gibi dış kaynaklara erişmek için kimlik bilgisi olmayan bir varsayılan XmlUrlResolver kullanılır.

Önemli

.NET Framework 4.5.2'den başlayarak varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver gerekli kimlik bilgileriyle bir XmlResolver belirtin.

Önemli

Hangi kaynaklara XmlReader erişebileceğini denetlemek için aşağıdaki yöntemlerden birini kullanabilirsiniz:

-veya-

  • özelliğini nullolarak ayarlayarak öğesinin dış kaynakları açmasına XmlResolver izin XmlReader verme.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(TextReader, XmlReaderSettings, String)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Belirtilen metin okuyucuyu, ayarları ve temel URI'yi kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

input
TextReader

XML verilerinin okunduğu metin okuyucu. Metin okuyucu bir Unicode karakter akışı döndürdüğünden, XML bildiriminde belirtilen kodlama veri akışının kodunu çözmek için tarafından XmlReader kullanılmaz.

settings
XmlReaderSettings

Yeni XmlReader örneğin ayarları. Bu değer olabilir null.

baseUri
String

Okunan varlık veya belge için temel URI. Bu değer olabilir null.

Güvenlik Notu Temel URI, XML belgesinin göreli URI'sini çözümlemek için kullanılır. Güvenilmeyen bir kaynaktan temel URI kullanmayın.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan bir nesne.

Özel durumlar

ArgumentNullException

input değeri null olur.

Açıklamalar

Varsayılan olarak XmlUrlResolver , belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgisi olmayan bir kullanılır.

Önemli

.NET Framework 4.5.2'den başlayarak varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, gerekli kimlik bilgileriyle belirtmek XmlResolver için özelliğini kullanınXmlReaderSettings.XmlResolver.

Önemli

Hangi kaynaklara XmlReader erişebileceğini denetlemek için aşağıdaki yöntemlerden birini kullanabilirsiniz:

-veya-

  • özelliğini nullolarak ayarlayarak öğesinin dış kaynakları açmasına XmlResolver izin XmlReader verme.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(TextReader, XmlReaderSettings)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Belirtilen metin okuyucuyu ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

input
TextReader

XML verilerinin okunduğu metin okuyucu. Metin okuyucu unicode karakter akışı döndürdüğünden XML bildiriminde belirtilen kodlama XML okuyucusu tarafından veri akışının kodunu çözmek için kullanılmaz.

settings
XmlReaderSettings

Yeni XmlReaderiçin ayarlar. Bu değer olabilir null.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan bir nesne.

Özel durumlar

ArgumentNullException

input değeri null olur.

Açıklamalar

Varsayılan olarak XmlUrlResolver , belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgisi olmayan bir kullanılır.

Önemli

.NET Framework 4.5.2'den başlayarak varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, gerekli kimlik bilgileriyle belirtmek XmlResolver için özelliğini kullanınXmlReaderSettings.XmlResolver.

Önemli

Hangi kaynaklara XmlReader erişebileceğini denetlemek için aşağıdaki yöntemlerden birini kullanabilirsiniz:

-veya-

  • özelliğini nullolarak ayarlayarak öğesinin dış kaynakları açmasına XmlResolver izin XmlReader verme.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(Stream, XmlReaderSettings)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Belirtilen akış ve ayarlarla yeni XmlReader bir örnek oluşturur.

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

Parametreler

input
Stream

XML verilerini içeren akış.

, XmlReader bayt sırası işaretini veya başka bir kodlama işaretini arayarak akışın ilk baytlarını tarar. Kodlama belirlendiğinde, akışı okumaya devam etmek için kodlama kullanılır ve işleme girişi (Unicode) karakterlerin akışı olarak ayrıştırmaya devam eder.

settings
XmlReaderSettings

Yeni XmlReader örneğin ayarları. Bu değer olabilir null.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan nesne.

Özel durumlar

ArgumentNullException

input değeri null olur.

Açıklamalar

Varsayılan olarak XmlUrlResolver , belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgisi olmayan bir kullanılır.

Önemli

.NET Framework 4.5.2'den başlayarak varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, gerekli kimlik bilgileriyle belirtmek XmlResolver için özelliğini kullanınXmlReaderSettings.XmlResolver.

Önemli

Hangi kaynaklara XmlReader erişebileceğini denetlemek için aşağıdaki yöntemlerden birini kullanabilirsiniz:

-veya-

  • özelliğini nullolarak ayarlayarak öğesinin dış kaynakları açmasına XmlResolver izin XmlReader verme.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(String)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Belirtilen URI ile yeni XmlReader bir örnek oluşturur.

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

Parametreler

inputUri
String

XML verilerini içeren dosyanın URI'sini. XmlUrlResolver sınıfı, yolu kurallı veri gösterimine dönüştürmek için kullanılır.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan nesne.

Özel durumlar

ArgumentNullException

inputUri değeri null olur.

SecurityException

, XmlReader XML verilerinin konumuna erişmek için yeterli izinlere sahip değil.

FileNotFoundException

URI tarafından tanımlanan dosya yok.

UriFormatException

URI biçimi doğru değil.

Not: Windows Mağazası uygulamaları için .NET'te veya Taşınabilir Sınıf Kitaplığı'nda bunun yerine temel sınıf özel durumunu FormatExceptionyakalayın.

Örnekler

Aşağıdaki örnek, URI tarafından belirtilen XML veri dosyasını okuyan bir XmlReader nesne oluşturur.

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

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

Açıklamalar

XmlReaderSettings Okuyucuyu oluşturmak için varsayılan ayarlara sahip bir nesne kullanılır. Oluşturulan okuyucuda destekleneceğini özellikleri belirtmek istiyorsanız, bir XmlReaderSettings nesneyi bağımsız değişkenlerinden biri olarak alan aşırı yüklemeyi kullanın ve doğru ayarlara sahip bir XmlReaderSettings nesne geçirin.

Belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgileri olmayan bir varsayılan XmlUrlResolver kullanılır.

Önemli

.NET Framework 4.5.2'den itibaren varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver gerekli kimlik bilgileriyle bir XmlResolver belirtin.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(TextReader)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Belirtilen metin okuyucuyu kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

input
TextReader

XML verilerinin okunduğu metin okuyucu. Metin okuyucu unicode karakter akışı döndürdüğünden, XML bildiriminde belirtilen kodlama XML okuyucusu tarafından veri akışının kodunu çözmek için kullanılmaz.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan nesne.

Özel durumlar

ArgumentNullException

input değeri null olur.

Örnekler

Aşağıdaki örnek, xml dizesini okumak için sınıfını StringReader kullanır.

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

Açıklamalar

XmlReaderSettings Okuyucuyu oluşturmak için varsayılan ayarlara sahip bir nesne kullanılır. Oluşturulan okuyucuda destekleneceğini özellikleri belirtmek istiyorsanız, bir XmlReaderSettings nesneyi bağımsız değişkenlerinden biri olarak alan aşırı yüklemeyi kullanın ve doğru ayarlara sahip bir XmlReaderSettings nesne geçirin.

Belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgileri olmayan bir varsayılan XmlUrlResolver kullanılır.

Önemli

.NET Framework 4.5.2'den itibaren varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver gerekli kimlik bilgileriyle bir XmlResolver belirtin.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(Stream)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Varsayılan ayarlarla belirtilen akışı kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

input
Stream

XML verilerini içeren akış.

, XmlReader bayt sırası işareti veya başka bir kodlama işareti arayarak akışın ilk baytlarını tarar. Kodlama belirlendiğinde, kodlama akışı okumaya devam etmek için kullanılır ve işleme girişi (Unicode) karakter akışı olarak ayrıştırmaya devam eder.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan nesne.

Özel durumlar

ArgumentNullException

input değeri null olur.

SecurityException

, XmlReader XML verilerinin konumuna erişmek için yeterli izinlere sahip değil.

Örnekler

Aşağıdaki örnek, öğesinden okuyan bir XmlReaderFileStreamnesnesi oluşturur.


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

Açıklamalar

XmlReaderSettings Okuyucuyu oluşturmak için varsayılan ayarlara sahip bir nesne kullanılır. Oluşturulan okuyucuda destekleneceğini özellikleri belirtmek istiyorsanız, bir XmlReaderSettings nesneyi bağımsız değişkenlerinden biri olarak alan aşırı yüklemeyi kullanın ve doğru ayarlara sahip bir XmlReaderSettings nesne geçirin.

Belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgileri olmayan bir varsayılan XmlUrlResolver kullanılır.

Önemli

.NET Framework 4.5.2'den itibaren varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver gerekli kimlik bilgileriyle bir XmlResolver belirtin.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır

Create(String, XmlReaderSettings)

Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs
Kaynak:
XmlReader.cs

Belirtilen URI ve ayarları kullanarak yeni XmlReader bir örnek oluşturur.

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

Parametreler

inputUri
String

XML verilerini içeren dosyanın URI'sini. XmlResolver Nesnedeki XmlReaderSettings nesnesi, yolu kurallı veri gösterimine dönüştürmek için kullanılır. ise XmlResolvernull, yeni XmlUrlResolver bir nesne kullanılır.

settings
XmlReaderSettings

Yeni XmlReader örneğin ayarları. Bu değer olabilir null.

Döndürülenler

XmlReader

Akıştaki XML verilerini okumak için kullanılan nesne.

Özel durumlar

ArgumentNullException

inputUri değeri null olur.

FileNotFoundException

URI tarafından belirtilen dosya bulunamıyor.

UriFormatException

URI biçimi doğru değil.

Not: Windows Mağazası uygulamaları için .NET'te veya Taşınabilir Sınıf Kitaplığı'nda bunun yerine temel sınıf özel durumunu FormatExceptionyakalayın.

Örnekler

Aşağıdaki örnek, belge türü tanımı (DTD) doğrulamasını destekleyen bir XmlReader nesne oluşturur.

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

Açıklamalar

Varsayılan olarak XmlUrlResolver , belge türü tanımı (DTD), varlıklar, şemalar vb. gibi dış kaynaklara erişmek için kimlik bilgileri olmayan bir kullanılır.

Önemli

.NET Framework 4.5.2'den itibaren varsayılan XmlUrlResolver değer sağlanmadı. Çözümünüz .NET Framework 4.5.2 veya sonraki sürümlerini hedefliyorsa, özelliğini kullanarak XmlReaderSettings.XmlResolver bir XmlResolver belirtin.

Bu, öğesinin XmlReader kimlik doğrulaması gerektirmeyen tüm konumlara erişebileceği anlamına gelir. Dış kaynak kimlik doğrulaması gerektiren bir ağ kaynağında bulunuyorsa, gerekli kimlik bilgileriyle belirtmek XmlResolver için özelliğini kullanınXmlReaderSettings.XmlResolver.

Önemli

özelliğini bir XmlSecureResolver nesne olarak XmlReader ayarlayarak öğesinin XmlResolver erişebileceği kaynakları kısıtlayabilirsiniz.

Oluşturulan XmlReader nesne varlık başvurularını genişletir ve yeni satır karakterlerinin XML normalleştirmesini gerçekleştirir.

Şunlara uygulanır