XmlReader.Create Method

Definition

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

Overloads

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)

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

Create(Stream, XmlReaderSettings, XmlParserContext)

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

Create(Stream, XmlReaderSettings, String)

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

Create(XmlReader, XmlReaderSettings)

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

Create(TextReader, XmlReaderSettings, String)

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

Create(TextReader, XmlReaderSettings)

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

Create(Stream, XmlReaderSettings)

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

Create(String)

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

Create(TextReader)

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

Create(Stream)

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

Create(String, XmlReaderSettings)

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

Examples

이 예제에서는 불필요 한 공백을 제거, 주석, 제거 및 조각 수준 규칙 검사를 수행 하는 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

Remarks

대부분의 Create 오버 로드는 XmlReaderSettings 개체를 허용 하는 settings 매개 변수를 포함 합니다.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.

  • 정적 Create 메서드에서 만든 XmlReader 개체에만 사용할 수 있는 XML 1.0 (4 번째 버전) 권장 사항에 대 한 향상 된 규칙 검사 및 준수와 같은 기능을 최대한 활용 하세요.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.

Note

.NET Framework에는 XmlTextReader, XmlNodeReaderXmlValidatingReader 클래스와 같은 XmlReader 클래스의 구체적 구현이 포함 되어 있지만 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

XmlReaderSettings 개체를 받아들이지 않는 Create 오버 로드를 사용 하는 경우 다음과 같은 기본 판독기 설정이 사용 됩니다.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

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

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

XmlReader XDR (XML 데이터 축소) 스키마 유효성 검사를 지원 하지 않습니다.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-

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

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

Parameters

inputUri
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

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

inputContext
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.

Returns

XmlReader

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

Exceptions

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.

Remarks

기본적으로 자격 증명이 없는 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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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.

Important

XmlResolver 속성을 XmlSecureResolver 개체로 설정 하 여 XmlReader에서 액세스할 수 있는 리소스를 제한할 수 있습니다.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)

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

Parameters

input
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

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

inputContext
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.

Returns

XmlReader

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

Exceptions

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

Examples

다음 예제에서는 XML 조각을 읽는 XmlReader 개체를 만듭니다.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)

Remarks

기본적으로 자격 증명이 없는 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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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.

Important

다음 방법 중 하나를 사용 하 여 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)

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

Parameters

input
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

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

inputContext
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.

Returns

XmlReader

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

Exceptions

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

Remarks

기본적으로 자격 증명이 없는 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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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.

Important

다음 방법 중 하나를 사용 하 여 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)

지정된 스트림, 기본 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

Parameters

input
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

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

baseUri
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.

Returns

XmlReader

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

Exceptions

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

Remarks

기본적으로 자격 증명이 없는 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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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.

Important

다음 방법 중 하나를 사용 하 여 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)

지정된 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

Parameters

reader
XmlReader

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

settings
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.

Returns

XmlReader

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

Exceptions

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.

Examples

다음 예제에서는 XmlNodeReader 개체 주위에 래핑되는 유효성 검사 XmlReader 개체를 만듭니다.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

Remarks

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

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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, specify an XmlResolver with the necessary credentials using the XmlReaderSettings.XmlResolver property.

Important

다음 방법 중 하나를 사용 하 여 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)

지정된 텍스트 판독기, 설정 및 기본 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

Parameters

input
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

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

baseUri
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.

Returns

XmlReader

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

Exceptions

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

Remarks

기본적으로 자격 증명이 없는 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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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.

Important

다음 방법 중 하나를 사용 하 여 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)

지정된 텍스트 판독기 및 설정을 사용하여 새 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

Parameters

input
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

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

Returns

XmlReader

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

Exceptions

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

Remarks

기본적으로 자격 증명이 없는 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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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.

Important

다음 방법 중 하나를 사용 하 여 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)

지정된 스트림 및 설정을 사용하여 새 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

Parameters

input
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

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

Returns

XmlReader

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

Exceptions

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

Remarks

기본적으로 자격 증명이 없는 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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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.

Important

다음 방법 중 하나를 사용 하 여 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)

지정된 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

Parameters

inputUri
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.

Returns

XmlReader

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

Exceptions

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.

Examples

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

Remarks

판독기를 만드는 데 사용 되는 기본 설정을 사용 하는 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.

DTD (문서 종류 정의), 엔터티, 스키마 등의 외부 리소스에 액세스 하는 데 자격 증명이 없는 기본 XmlUrlResolver 사용 됩니다.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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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, 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)

지정된 텍스트 판독기를 사용하여 새 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

Parameters

input
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.

Returns

XmlReader

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

Exceptions

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

Examples

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

Remarks

판독기를 만드는 데 사용 되는 기본 설정을 사용 하는 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.

DTD (문서 종류 정의), 엔터티, 스키마 등의 외부 리소스에 액세스 하는 데 자격 증명이 없는 기본 XmlUrlResolver 사용 됩니다.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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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, 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)

기본 설정의 지정된 스트림을 사용하여 새 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

Parameters

input
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.

Returns

XmlReader

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

Exceptions

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

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

Examples

다음 예제에서는 FileStream에서 읽는 XmlReader 개체를 만듭니다.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

Remarks

판독기를 만드는 데 사용 되는 기본 설정을 사용 하는 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.

DTD (문서 종류 정의), 엔터티, 스키마 등의 외부 리소스에 액세스 하는 데 자격 증명이 없는 기본 XmlUrlResolver 사용 됩니다.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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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, 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)

지정된 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

Parameters

inputUri
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

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

Returns

XmlReader

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

Exceptions

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.

Examples

다음 예에서는 DTD (문서 종류 정의) 유효성 검사를 지 원하는 XmlReader 개체를 만듭니다.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

Remarks

기본적으로 자격 증명이 없는 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.

Important

.NET Framework 4.5.2 부터는 기본 XmlUrlResolver 제공 되지 않습니다.Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 XmlReaderSettings.XmlResolver 속성을 사용 하 여 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.

Important

XmlResolver 속성을 XmlSecureResolver 개체로 설정 하 여 XmlReader에서 액세스할 수 있는 리소스를 제한할 수 있습니다.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.

Applies to