XmlReader.Create XmlReader.Create XmlReader.Create XmlReader.Create Method

정의

XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance.

오버로드

Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext)

지정된 URI, 설정 및 컨텍스트 정보를 구문 분석에 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.

Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext)

지정된 텍스트 판독기, 설정 및 컨텍스트 정보를 구문 분석에 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance by using the specified text reader, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext)

구문 분석을 위해 지정한 스트림, 설정 및 컨텍스트 정보를 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.

Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String)

지정된 스트림, 기본 URI 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance using the specified stream, base URI, and settings.

Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings)

지정된 XML 판독기 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance by using the specified XML reader and settings.

Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String)

지정된 텍스트 판독기, 설정 및 기본 URI를 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance by using the specified text reader, settings, and base URI.

Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings)

지정된 텍스트 판독기 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance by using the specified text reader and settings.

Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings)

지정된 스트림 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance with the specified stream and settings.

Create(String) Create(String) Create(String) Create(String)

지정된 URI를 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance with specified URI.

Create(TextReader) Create(TextReader) Create(TextReader) Create(TextReader)

지정된 텍스트 판독기를 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance by using the specified text reader.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

기본 설정의 지정된 스트림을 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance using the specified stream with default settings.

Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings)

지정된 URI 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.Creates a new XmlReader instance by using the specified URI and settings.

예제

이 예제에서는 불필요 한 공백을 제거, 주석, 제거 및 조각 수준 규칙 검사를 수행 하는 XML 판독기를 만듭니다.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)

다음 예제에서는 XmlUrlResolver 파일에 액세스 하려면 기본 자격 증명을 사용 합니다.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)

다음 코드는 다른 판독기 내에서 판독기 인스턴스를 래핑합니다.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)

이 예제에서는 DTD 및 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

설명

대부분의 합니다 Create 오버 로드 포함를 settings 허용 하는 매개 변수는 XmlReaderSettings 개체입니다.Most of the Create overloads include a settings parameter that accepts an XmlReaderSettings object. 이 개체를 사용할 수 있습니다.You can use this object to:

  • 지원 되는 원하는 어떤 기능을 지정 합니다 XmlReader 개체입니다.Specify which features you want supported on the XmlReader object.

  • 재사용을 XmlReaderSettings 여러 판독기를 만들 개체입니다.Reuse the XmlReaderSettings object to create multiple readers. 같은 설정을 사용하면 같은 기능을 갖춘 여러 판독기를 만들 수 있습니다.You can use the same settings to create multiple readers with the same functionality. 설정을 수정할 수 있습니다 또는 XmlReaderSettings 인스턴스 및 다양 한 기능을 사용 하 여 새 판독기를 만듭니다.Or, you can modify the settings on an XmlReaderSettings instance and create a new reader with a different set of features.

  • 기존 XML 판독기에 기능을 추가 합니다.Add features to an existing XML reader. Create 메서드는 다른 XmlReader 개체를 허용할 수 있습니다.The Create method can accept another XmlReader object. 내부 XmlReader 개체는 사용자 정의 판독기 수를 XmlTextReader 개체 또는 다른 XmlReader 추가 기능을 추가 하려는 인스턴스.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.

  • 향상 된 규칙 검사에 대 한 규정 준수 등의 기능을 최대한 활용 합니다 XML 1.0 (1.0(fourth edition) 에서만 사용할 수 있는 권장 사항을 XmlReader 정적으로 생성 된 개체 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.

참고

.NET Framework의 구체적 구현이 포함 되어 있지만 합니다 XmlReader 클래스와 같은 합니다 XmlTextReader, XmlNodeReader, 및 XmlValidatingReader 만드는 것을 권장 클래스 XmlReader 인스턴스를 사용 하 여는 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.

기본 설정Default settings

사용 하는 경우는 Create 받지 않은 오버 로드는 XmlReaderSettings 다음과 같은 기본 판독기 설정 되는 개체:If you use a Create overload that doesn't accept a XmlReaderSettings object, the following default reader settings are used:

설정Setting 기본값Default
CheckCharacters true
ConformanceLevel ConformanceLevel.Document
IgnoreComments false
IgnoreProcessingInstructions false
IgnoreWhitespace false
LineNumberOffset 00
LinePositionOffset 00
NameTable null
DtdProcessing Prohibit
Schemas XmlSchemaSet 개체An empty XmlSchemaSet object
ValidationFlags ProcessIdentityConstraints 사용 하도록 설정ProcessIdentityConstraints enabled
ValidationType None
XmlResolver XmlUrlResolver 개체입니다.A new XmlUrlResolver object. .NET Framework 4.5.2부터이 설정에 기본값은 null합니다.Starting with the .NET Framework 4.5.2, this setting has a default value of null.

일반적인 시나리오에 대 한 설정Settings for common scenarios

다음은 XmlReaderSettings 일반적인 XML 판독기 시나리오 중 일부에 대해 설정 해야 하는 속성입니다.Here are the XmlReaderSettings properties you should set for some of the typical XML reader scenarios.

요구 사항Requirement SetSet
데이터에는 올바른 형식의 XML 문서 여야 합니다.Data must be a well-formed XML document. ConformanceLevel Document입니다.ConformanceLevel to Document.
데이터에는 올바른 형식의 XML 구문 분석 된 엔터티를 해야 합니다.Data must be a well-formed XML parsed entity. ConformanceLevel Fragment입니다.ConformanceLevel to Fragment.
데이터는 DTD에 대해 유효성이 검사 되어야 합니다.Data must be validated against a DTD. DtdProcessing - ParseDtdProcessing to Parse
ValidationType DTD입니다.ValidationType to DTD.
데이터는 XML 스키마에 대해 유효성이 검사 되어야 합니다.Data must be validated against an XML schema. ValidationType - SchemaValidationType to Schema
SchemasXmlSchemaSet 유효성 검사에 사용할 합니다.Schemas to the XmlSchemaSet to use for validation. XmlReader Xml-data Reduced (XDR) 스키마 유효성 검사를 지원 하지 않습니다.Note that XmlReader doesn't support XML-Data Reduced (XDR) schema validation.
데이터는 인라인 XML 스키마에 대해 유효성이 검사 되어야 합니다.Data must be validated against an inline XML schema. ValidationType - SchemaValidationType to Schema
ValidationFlags ProcessInlineSchema입니다.ValidationFlags to ProcessInlineSchema.
형식 지원.Type support. ValidationType - SchemaValidationType to Schema
SchemasXmlSchemaSet 사용 하도록 합니다.Schemas to the XmlSchemaSet to use.

XmlReader Xml-data Reduced (XDR) 스키마 유효성 검사를 지원 하지 않습니다.XmlReader doesn't support XML-Data Reduced (XDR) schema validation.

비동기 프로그래밍Asynchronous programming

동기 모드에서는 Create 메서드 파일, 스트림 또는 텍스트 판독기의 버퍼에서 데이터의 첫 번째 청크를 읽습니다.In synchronous mode, the Create method reads the first chunk of data from the buffer of the file, stream, or text reader. I/O 작업이 실패 하면 예외가 throw 될 수 있습니다이 합니다.This may throw an exception if an I/O operation fails. 비동기 모드에서 첫 번째 I/O 작업이 읽기 작업을 사용 하 여 발생 하므로 읽기 작업이 수행 될 때 발생 하는 예외를 throw 됩니다.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.

보안 고려 사항Security considerations

기본적으로 XmlReader 사용 하는 XmlUrlResolver 리소스를 열려면 사용자 자격 증명 없이 개체입니다.By default, the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. 이 기본적으로 XML 판독기 위치에 액세스할 수 있는 자격 증명이 필요 하지 않은 것을 의미 합니다.This means that, by default, the XML reader can access any location that doesn't require credentials. 사용 된 XmlResolver 리소스에 대 한 액세스를 제어 하는 속성:Use the XmlResolver property to control access to resources:

또는-or-

  • 설정 XmlResolvernull XML 판독기가 외부 리소스를 열기 하지 못하도록 합니다.Set XmlResolver to null to prevent the XML reader from opening any external resources.

Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext) Create(String, XmlReaderSettings, XmlParserContext)

지정된 URI, 설정 및 컨텍스트 정보를 구문 분석에 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

inputUri
String String String String

XML 데이터를 포함하는 파일의 URI입니다.The URI for the file containing the XML data. XmlReaderSettings 개체의 XmlResolver 개체는 경로를 정규 데이터 표현으로 변환하는 데 사용됩니다.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. XmlResolvernull이면 새 XmlUrlResolver 개체가 사용됩니다.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

XmlReader 인스턴스의 설정입니다.The settings for the new XmlReader instance. 이 값은 null일 수 있습니다.This value can be null.

inputContext
XmlParserContext XmlParserContext XmlParserContext XmlParserContext

XML 조각을 구문 분석하는 데 필요한 컨텍스트 정보입니다.The context information required to parse the XML fragment. 컨텍스트 정보에는 사용할 XmlNameTable, 인코딩, 네임스페이스 범위, 현재 xml:langxml:space 범위, 기본 URI 및 문서 종류 정의가 포함될 수 있습니다.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.

이 값은 null일 수 있습니다.This value can be null.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

inputUri 값이 null입니다.The inputUri value is null.

XmlReader 에는 XML 데이터 위치에 액세스할 수 있는 충분한 권한이 없습니다.The XmlReader does not have sufficient permissions to access the location of the XML data.

NameTableNameTable 속성 둘 다에 값이 포함되어 있습니다.The NameTable and NameTable properties both contain values. NameTable 속성 중 하나만 설정 및 사용할 수 있습니다.(Only one of these NameTable properties can be set and used).

URI로 지정된 파일을 찾을 수 없습니다.The file specified by the URI cannot be found.

URI 형식이 잘못되었습니다.The URI format is not correct.

설명

기본적으로는 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

즉는 XmlReader 인증 필요 하지 않은 모든 위치에 액세스할 수 있습니다.This means that the XmlReader can access any locations that does not require authentication. 사용 하 여 외부 리소스를 인증을 요구 하는 네트워크 리소스에 있는 경우는 XmlReaderSettings.XmlResolver 속성에 지정할는 XmlResolver 에 필요한 자격 증명입니다.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.

중요

리소스를 제한할 수 있습니다는 합니다 XmlReader 설정 하 여 액세스할 수는 XmlResolver 속성을는 XmlSecureResolver 개체입니다.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext) Create(TextReader, XmlReaderSettings, XmlParserContext)

지정된 텍스트 판독기, 설정 및 컨텍스트 정보를 구문 분석에 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

input
TextReader TextReader TextReader TextReader

XML 데이터를 읽어올 텍스트 판독기입니다.The text reader from which to read the XML data. 텍스트 판독기는 유니코드 문자 스트림을 반환하므로 XML 선언에 지정된 인코딩은 XML 판독기가 데이터 스트림을 디코딩하는 데 사용되지 않습니다.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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

XmlReader 인스턴스의 설정입니다.The settings for the new XmlReader instance. 이 값은 null일 수 있습니다.This value can be null.

inputContext
XmlParserContext XmlParserContext XmlParserContext XmlParserContext

XML 조각을 구문 분석하는 데 필요한 컨텍스트 정보입니다.The context information required to parse the XML fragment. 컨텍스트 정보에는 사용할 XmlNameTable, 인코딩, 네임스페이스 범위, 현재 xml:langxml:space 범위, 기본 URI 및 문서 종류 정의가 포함될 수 있습니다.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.

이 값은 null일 수 있습니다.This value can be null.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

input 값이 null입니다.The input value is null.

NameTableNameTable 속성 둘 다에 값이 포함되어 있습니다.The NameTable and NameTable properties both contain values. NameTable 속성 중 하나만 설정 및 사용할 수 있습니다.(Only one of these NameTable properties can be set and used).

예제

다음 예제에서는 XmlReader 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)

설명

기본적으로는 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

사용 하 여 외부 리소스를 인증을 요구 하는 네트워크 리소스에 있는 경우는 XmlReaderSettings.XmlResolver 속성에 지정할는 XmlResolver 에 필요한 자격 증명입니다.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.

중요

리소스를 제어 하려면 다음 방법 중 하나를 사용할 수는 XmlReader 액세스할 수 있습니다.You can use one of the following methods to control which resources the XmlReader can access:

또는-or-

  • XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext) Create(Stream, XmlReaderSettings, XmlParserContext)

구문 분석을 위해 지정한 스트림, 설정 및 컨텍스트 정보를 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

input
Stream Stream Stream Stream

XML 데이터가 포함된 스트림입니다.The stream that contains the XML data.

XmlReader는 스트림의 첫 번째 바이트를 검색하여 바이트 순서 표시나 다른 인코딩 기호를 찾습니다.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 인코딩이 확인되면 이 인코딩을 사용하여 스트림을 읽고, 입력을 문자 스트림(유니코드)으로 구문 분석하는 작업이 수행됩니다.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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

XmlReader 인스턴스의 설정입니다.The settings for the new XmlReader instance. 이 값은 null일 수 있습니다.This value can be null.

inputContext
XmlParserContext XmlParserContext XmlParserContext XmlParserContext

XML 조각을 구문 분석하는 데 필요한 컨텍스트 정보입니다.The context information required to parse the XML fragment. 컨텍스트 정보에는 사용할 XmlNameTable, 인코딩, 네임스페이스 범위, 현재 xml:langxml:space 범위, 기본 URI 및 문서 종류 정의가 포함될 수 있습니다.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.

이 값은 null일 수 있습니다.This value can be null.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

input 값이 null입니다.The input value is null.

설명

기본적으로는 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

사용 하 여 외부 리소스를 인증을 요구 하는 네트워크 리소스에 있는 경우는 XmlReaderSettings.XmlResolver 속성에 지정할는 XmlResolver 에 필요한 자격 증명입니다.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.

중요

리소스를 제어 하려면 다음 방법 중 하나를 사용할 수는 XmlReader 액세스할 수 있습니다.You can use one of the following methods to control which resources the XmlReader can access:

또는-or-

  • XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String) Create(Stream, XmlReaderSettings, String)

지정된 스트림, 기본 URI 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

input
Stream Stream Stream Stream

XML 데이터가 포함된 스트림입니다.The stream that contains the XML data.

XmlReader는 스트림의 첫 번째 바이트를 검색하여 바이트 순서 표시나 다른 인코딩 기호를 찾습니다.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 인코딩이 확인되면 이 인코딩을 사용하여 스트림을 읽고, 입력을 문자 스트림(유니코드)으로 구문 분석하는 작업이 수행됩니다.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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

XmlReader 인스턴스의 설정입니다.The settings for the new XmlReader instance. 이 값은 null일 수 있습니다.This value can be null.

baseUri
String String String String

읽을 엔터티 또는 문서의 기본 URI입니다.The base URI for the entity or document being read. 이 값은 null일 수 있습니다.This value can be null.

보안 정보 기본 URI는 XML 문서의 상대 URI를 확인하는 데 사용됩니다.Security Note The base URI is used to resolve the relative URI of the XML document. 신뢰할 수 없는 소스의 기본 URI는 사용하지 않는 것이 좋습니다.Do not use a base URI from an untrusted source.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

input 값이 null입니다.The input value is null.

설명

기본적으로는 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

사용 하 여 외부 리소스를 인증을 요구 하는 네트워크 리소스에 있는 경우는 XmlReaderSettings.XmlResolver 속성에 지정할는 XmlResolver 에 필요한 자격 증명입니다.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.

중요

리소스를 제어 하려면 다음 방법 중 하나를 사용할 수는 XmlReader 액세스할 수 있습니다.You can use one of the following methods to control which resources the XmlReader can access:

또는-or-

  • XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings) Create(XmlReader, XmlReaderSettings)

지정된 XML 판독기 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

reader
XmlReader XmlReader XmlReader XmlReader

내부 XML 판독기로 사용할 개체입니다.The object that you want to use as the underlying XML reader.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

XmlReader 인스턴스의 설정입니다.The settings for the new XmlReader instance.

XmlReaderSettings 개체의 규칙 수준은 기본 판독기의 규칙 수준과 일치하거나 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.

반환

지정된 XmlReader 개체를 래핑하는 개체입니다.An object that is wrapped around the specified XmlReader object.

예외

reader 값이 null입니다.The reader value is null.

XmlReaderSettings 개체가 기본 판독기의 규칙 수준과 일치하지 않는 규칙 수준을 지정하는 경우If the XmlReaderSettings object specifies a conformance level that is not consistent with conformance level of the underlying reader.

또는-or- 기본 XmlReaderError 또는 Closed 상태에 있는 경우The underlying XmlReader is in an Error or Closed state.

예제

다음 예제에서는 유효성을 검사 하 XmlReader 개체를 래핑하는 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

설명

이 메서드는 기본 추가 기능을 사용 하면 XmlReader 개체입니다.This method allows you add additional features to an underlying XmlReader object. 기본 XmlReader 다른 개체 일 수 있습니다 XmlReader 하 여 만든 개체를 Create 메서드를 요소나 XmlReader 구체적인 중 하나를 사용 하 여 만든 개체 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.

기본값 XmlUrlResolver 자격 증명이 없는 되는 스키마와 같은 외부 리소스에 액세스 합니다.A default XmlUrlResolver with no credentials is used to access any external resources such as a schema.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

인증이 필요한 네트워크 리소스에 대 한 외부 리소스가 있으면 지정는 XmlResolver 를 사용 하 여 필요한 자격 증명으로는 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.

중요

리소스를 제어 하려면 다음 방법 중 하나를 사용할 수는 XmlReader 액세스할 수 있습니다.You can use one of the following methods to control which resources the XmlReader can access:

또는-or-

  • XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String) Create(TextReader, XmlReaderSettings, String)

지정된 텍스트 판독기, 설정 및 기본 URI를 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

input
TextReader TextReader TextReader TextReader

XML 데이터를 읽어올 텍스트 판독기입니다.The text reader from which to read the XML data. 텍스트 판독기는 유니코드 문자 스트림을 반환하므로 XML 선언에 지정된 인코딩은 XmlReader가 데이터 스트림을 디코딩하는 데 사용되지 않습니다.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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

XmlReader 인스턴스의 설정입니다.The settings for the new XmlReader instance. 이 값은 null일 수 있습니다.This value can be null.

baseUri
String String String String

읽을 엔터티 또는 문서의 기본 URI입니다.The base URI for the entity or document being read. 이 값은 null일 수 있습니다.This value can be null.

보안 정보 기본 URI는 XML 문서의 상대 URI를 확인하는 데 사용됩니다.Security Note The base URI is used to resolve the relative URI of the XML document. 신뢰할 수 없는 소스의 기본 URI는 사용하지 않는 것이 좋습니다.Do not use a base URI from an untrusted source.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

input 값이 null입니다.The input value is null.

설명

기본적으로는 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

사용 하 여 외부 리소스를 인증을 요구 하는 네트워크 리소스에 있는 경우는 XmlReaderSettings.XmlResolver 속성에 지정할는 XmlResolver 에 필요한 자격 증명입니다.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.

중요

리소스를 제어 하려면 다음 방법 중 하나를 사용할 수는 XmlReader 액세스할 수 있습니다.You can use one of the following methods to control which resources the XmlReader can access:

또는-or-

  • XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings) Create(TextReader, XmlReaderSettings)

지정된 텍스트 판독기 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

input
TextReader TextReader TextReader TextReader

XML 데이터를 읽어올 텍스트 판독기입니다.The text reader from which to read the XML data. 텍스트 판독기는 유니코드 문자 스트림을 반환하므로 XML 선언에 지정된 인코딩은 XML 판독기가 데이터 스트림을 디코딩하는 데 사용되지 않습니다.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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

XmlReader의 설정입니다.The settings for the new XmlReader. 이 값은 null일 수 있습니다.This value can be null.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

input 값이 null입니다.The input value is null.

설명

기본적으로는 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

사용 하 여 외부 리소스를 인증을 요구 하는 네트워크 리소스에 있는 경우는 XmlReaderSettings.XmlResolver 속성에 지정할는 XmlResolver 에 필요한 자격 증명입니다.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.

중요

리소스를 제어 하려면 다음 방법 중 하나를 사용할 수는 XmlReader 액세스할 수 있습니다.You can use one of the following methods to control which resources the XmlReader can access:

또는-or-

  • XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings) Create(Stream, XmlReaderSettings)

지정된 스트림 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

input
Stream Stream Stream Stream

XML 데이터가 포함된 스트림입니다.The stream that contains the XML data.

XmlReader는 스트림의 첫 번째 바이트를 검색하여 바이트 순서 표시나 다른 인코딩 기호를 찾습니다.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 인코딩이 확인되면 이 인코딩을 사용하여 스트림을 읽고, 입력을 문자 스트림(유니코드)으로 구문 분석하는 작업이 수행됩니다.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 XmlReaderSettings XmlReaderSettings XmlReaderSettings

XmlReader 인스턴스의 설정입니다.The settings for the new XmlReader instance. 이 값은 null일 수 있습니다.This value can be null.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

input 값이 null입니다.The input value is null.

설명

기본적으로는 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

사용 하 여 외부 리소스를 인증을 요구 하는 네트워크 리소스에 있는 경우는 XmlReaderSettings.XmlResolver 속성에 지정할는 XmlResolver 에 필요한 자격 증명입니다.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.

중요

리소스를 제어 하려면 다음 방법 중 하나를 사용할 수는 XmlReader 액세스할 수 있습니다.You can use one of the following methods to control which resources the XmlReader can access:

또는-or-

  • XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String) Create(String) Create(String) Create(String)

지정된 URI를 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

inputUri
String String String String

XML 데이터를 포함하는 파일의 URI입니다.The URI for the file that contains the XML data. XmlUrlResolver 클래스는 경로를 정규 데이터 표현으로 변환하는 데 사용됩니다.The XmlUrlResolver class is used to convert the path to a canonical data representation.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

inputUri 값이 null입니다.The inputUri value is null.

XmlReader에는 XML 데이터 위치에 액세스할 수 있는 충분한 권한이 없습니다.The XmlReader does not have sufficient permissions to access the location of the XML data.

URI로 식별된 파일이 없는 경우The file identified by the URI does not exist.

Windows 스토어 앱용 .NET 또는 이식 가능한 클래스 라이브러리에서 대신 기본 클래스 예외 FormatException을 catch합니다.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

URI 형식이 잘못되었습니다.The URI format is not correct.

예제

다음 예제에서는 XmlReader URI로 지정 된 XML 데이터 파일을 읽는 개체입니다.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")

설명

XmlReaderSettings 개체 기본 설정 사용 하 여 판독기를 만드는 데 사용 됩니다.An XmlReaderSettings object with default settings is used to create the reader. 만들어진된 판독기에서 지원할 기능을 지정 하려는 경우는 오버 로드를 사용 하 여는 XmlReaderSettings 해당 인수의 하나로 개체를 전달는 XmlReaderSettings 올바른 설정 포함 하는 개체입니다.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.

기본값 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

인증이 필요한 네트워크 리소스에 대 한 외부 리소스가 있으면 지정는 XmlResolver 를 사용 하 여 필요한 자격 증명으로는 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.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(TextReader) Create(TextReader) Create(TextReader) Create(TextReader)

지정된 텍스트 판독기를 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

input
TextReader TextReader TextReader TextReader

XML 데이터를 읽어올 텍스트 판독기입니다.The text reader from which to read the XML data. 텍스트 판독기는 유니코드 문자 스트림을 반환하므로 XML 선언에 지정된 인코딩은 XML 판독기가 데이터 스트림을 디코딩하는 데 사용되지 않습니다.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.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

input 값이 null입니다.The input value is null.

예제

다음 예제에서는 StringReader 클래스는 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))

설명

XmlReaderSettings 개체 기본 설정 사용 하 여 판독기를 만드는 데 사용 됩니다.An XmlReaderSettings object with default settings is used to create the reader. 만들어진된 판독기에서 지원할 기능을 지정 하려는 경우는 오버 로드를 사용 하 여는 XmlReaderSettings 해당 인수의 하나로 개체를 전달는 XmlReaderSettings 올바른 설정 포함 하는 개체입니다.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.

기본값 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

인증이 필요한 네트워크 리소스에 대 한 외부 리소스가 있으면 지정는 XmlResolver 를 사용 하 여 필요한 자격 증명으로는 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.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(Stream) Create(Stream) Create(Stream) Create(Stream)

기본 설정의 지정된 스트림을 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

input
Stream Stream Stream Stream

XML 데이터가 포함된 스트림입니다.The stream that contains the XML data.

XmlReader는 스트림의 첫 번째 바이트를 검색하여 바이트 순서 표시나 다른 인코딩 기호를 찾습니다.The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. 인코딩이 확인되면 이 인코딩을 사용하여 스트림을 읽고, 입력을 문자 스트림(유니코드)으로 구문 분석하는 작업이 수행됩니다.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.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

input 값이 null입니다.The input value is null.

XmlReader에는 XML 데이터 위치에 액세스할 수 있는 충분한 권한이 없습니다.The XmlReader does not have sufficient permissions to access the location of the XML data.

예제

다음 예제는 XmlReader 개체에서 읽는 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

설명

XmlReaderSettings 개체 기본 설정 사용 하 여 판독기를 만드는 데 사용 됩니다.An XmlReaderSettings object with default settings is used to create the reader. 만들어진된 판독기에서 지원할 기능을 지정 하려는 경우는 오버 로드를 사용 하 여는 XmlReaderSettings 해당 인수의 하나로 개체를 전달는 XmlReaderSettings 올바른 설정 포함 하는 개체입니다.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.

기본값 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

인증이 필요한 네트워크 리소스에 대 한 외부 리소스가 있으면 지정는 XmlResolver 를 사용 하 여 필요한 자격 증명으로는 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.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings) Create(String, XmlReaderSettings)

지정된 URI 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.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

매개 변수

inputUri
String String String String

XML 데이터를 포함하는 파일의 URI입니다.The URI for the file containing the XML data. XmlReaderSettings 개체의 XmlResolver 개체는 경로를 정규 데이터 표현으로 변환하는 데 사용됩니다.The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. XmlResolvernull이면 새 XmlUrlResolver 개체가 사용됩니다.If XmlResolver is null, a new XmlUrlResolver object is used.

settings
XmlReaderSettings XmlReaderSettings XmlReaderSettings XmlReaderSettings

XmlReader 인스턴스의 설정입니다.The settings for the new XmlReader instance. 이 값은 null일 수 있습니다.This value can be null.

반환

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.An object that is used to read the XML data in the stream.

예외

inputUri 값이 null입니다.The inputUri value is null.

URI로 지정된 파일을 찾을 수 없습니다.The file specified by the URI cannot be found.

Windows 스토어 앱용 .NET 또는 이식 가능한 클래스 라이브러리에서 대신 기본 클래스 예외 FormatException을 catch합니다.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

URI 형식이 잘못되었습니다.The URI format is not correct.

예제

다음 예제에서는 XmlReader 문서 유형 정의 (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

설명

기본적으로는 XmlUrlResolver 없는 자격 증명을 사용 하 여 문서 유형 정의 (DTD), 엔터티, 스키마 등 모든 외부 리소스에 액세스 합니다.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.

중요

기본값은 없습니다.NET Framework 4.5.2부터 XmlUrlResolver 제공 됩니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션의.NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 지정는 XmlResolver 를 사용 하 여는 XmlReaderSettings.XmlResolver 속성입니다.If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings.XmlResolver property.

즉는 XmlReader 인증 필요 하지 않은 모든 위치에 액세스할 수 있습니다.This means that the XmlReader can access any locations that does not require authentication. 사용 하 여 외부 리소스를 인증을 요구 하는 네트워크 리소스에 있는 경우는 XmlReaderSettings.XmlResolver 속성에 지정할는 XmlResolver 에 필요한 자격 증명입니다.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.

중요

리소스를 제한할 수 있습니다는 합니다 XmlReader 설정 하 여 액세스할 수는 XmlResolver 속성을는 XmlSecureResolver 개체입니다.You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

만들어진 XmlReader 개체는 엔터티 참조를 확장 하 고 줄 바꿈 문자의 XML 표준화를 수행 합니다.The created XmlReader object expands entity references and performs XML normalization of new line characters.

적용 대상