XmlReader.Create 메서드

정의

네임스페이스:

System.Xml

어셈블리:

System.Xml.ReaderWriter.dll

새 XmlReader 인스턴스를 만듭니다.

오버로드

Create(String, XmlReaderSettings, XmlParserContext)	지정된 URI, 설정 및 컨텍스트 정보를 구문 분석에 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(TextReader, XmlReaderSettings, XmlParserContext)	지정된 텍스트 판독기, 설정 및 컨텍스트 정보를 구문 분석에 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(Stream, XmlReaderSettings, XmlParserContext)	구문 분석을 위해 지정한 스트림, 설정 및 컨텍스트 정보를 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(Stream, XmlReaderSettings, String)	지정된 스트림, 기본 URI 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(XmlReader, XmlReaderSettings)	지정된 XML 판독기 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(TextReader, XmlReaderSettings, String)	지정된 텍스트 판독기, 설정 및 기본 URI를 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(TextReader, XmlReaderSettings)	지정된 텍스트 판독기 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(Stream, XmlReaderSettings)	지정된 스트림 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(String)	지정된 URI를 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(TextReader)	지정된 텍스트 판독기를 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(Stream)	기본 설정의 지정된 스트림을 사용하여 새 XmlReader 인스턴스를 만듭니다.
Create(String, XmlReaderSettings)	지정된 URI 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.

설명

이 API에 대한 자세한 내용은 XmlReader.Close에 대한 추가 API 설명을 참조하세요.

Create(String, XmlReaderSettings, XmlParserContext)

Source:

XmlReader.cs

지정된 URI, 설정 및 컨텍스트 정보를 구문 분석에 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

XML 데이터를 포함하는 파일의 URI입니다. XmlReaderSettings 개체의 XmlResolver 개체는 경로를 정규 데이터 표현으로 변환하는 데 사용됩니다. XmlResolver가 null이면 새 XmlUrlResolver 개체가 사용됩니다.

settings

XmlReaderSettings

새 XmlReader 인스턴스의 설정입니다. 이 값은 null일 수 있습니다.

inputContext

XmlParserContext

XML 조각을 구문 분석하는 데 필요한 컨텍스트 정보입니다. 컨텍스트 정보에는 사용할 XmlNameTable, 인코딩, 네임스페이스 범위, 현재 xml:lang과 xml:space 범위, 기본 URI 및 문서 종류 정의가 포함될 수 있습니다.

이 값은 null일 수 있습니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

inputUri 값이 null입니다.

SecurityException

XmlReader에는 XML 데이터 위치에 액세스할 수 있는 충분한 권한이 없습니다.

ArgumentException

NameTable 및 NameTable 속성 둘 다에 값이 포함되어 있습니다. NameTable 속성 중 하나만 설정 및 사용할 수 있습니다.

FileNotFoundException

URI로 지정된 파일을 찾을 수 없습니다.

UriFormatException

URI 형식이 잘못되었습니다.

설명

기본적으로 XmlUrlResolver 자격 증명이 없는 는 DTD(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

즉, 는 XmlReader 인증이 필요하지 않은 모든 위치에 액세스할 수 있습니다. 외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 XmlReaderSettings.XmlResolver 필요한 자격 증명으로 을 XmlResolver 지정합니다.

중요

속성을 개체로 설정하여 에서 XmlReader 액세스할 수 있는 리소스를 XmlResolverXmlSecureResolver 제한할 수 있습니다.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(TextReader, XmlReaderSettings, XmlParserContext)

Source:

XmlReader.cs

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

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

XML 데이터를 읽어올 텍스트 판독기입니다. 텍스트 판독기는 유니코드 문자 스트림을 반환하므로 XML 선언에 지정된 인코딩은 XML 판독기가 데이터 스트림을 디코딩하는 데 사용되지 않습니다.

settings

XmlReaderSettings

새 XmlReader 인스턴스의 설정입니다. 이 값은 null일 수 있습니다.

inputContext

XmlParserContext

XML 조각을 구문 분석하는 데 필요한 컨텍스트 정보입니다. 컨텍스트 정보에는 사용할 XmlNameTable, 인코딩, 네임스페이스 범위, 현재 xml:lang과 xml:space 범위, 기본 URI 및 문서 종류 정의가 포함될 수 있습니다.

이 값은 null일 수 있습니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

input 값이 null입니다.

ArgumentException

NameTable 및 NameTable 속성 둘 다에 값이 포함되어 있습니다. (이러한 NameTable 속성 중 하나만 설정하고 사용할 수 있습니다.)

예제

다음 예제에서는 XML 조각을 읽는 개체를 만듭니다 XmlReader .

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(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 XmlReaderSettings.XmlResolver 필요한 자격 증명으로 을 XmlResolver 지정합니다.

중요

다음 방법 중 하나를 사용하여 에 액세스할 수 있는 리소스를 XmlReader 제어할 수 있습니다.

• XmlReader 속성을 XmlResolver 개체로 설정하여 XmlSecureResolver에서 액세스 가능한 리소스를 제한합니다.

또는

• XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(Stream, XmlReaderSettings, XmlParserContext)

Source:

XmlReader.cs

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

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

XML 데이터가 포함된 스트림입니다.

XmlReader는 스트림의 첫 번째 바이트를 검색하여 바이트 순서 표시나 다른 인코딩 기호를 찾습니다. 인코딩이 확인되면 이 인코딩을 사용하여 스트림을 읽고, 입력을 문자 스트림(유니코드)으로 구문 분석하는 작업이 수행됩니다.

settings

XmlReaderSettings

새 XmlReader 인스턴스의 설정입니다. 이 값은 null일 수 있습니다.

inputContext

XmlParserContext

XML 조각을 구문 분석하는 데 필요한 컨텍스트 정보입니다. 컨텍스트 정보에는 사용할 XmlNameTable, 인코딩, 네임스페이스 범위, 현재 xml:lang과 xml:space 범위, 기본 URI 및 문서 종류 정의가 포함될 수 있습니다.

이 값은 null일 수 있습니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

input 값이 null입니다.

설명

기본적으로 XmlUrlResolver 자격 증명이 없는 는 DTD(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 XmlReaderSettings.XmlResolver 필요한 자격 증명으로 을 XmlResolver 지정합니다.

중요

다음 방법 중 하나를 사용하여 에 액세스할 수 있는 리소스를 XmlReader 제어할 수 있습니다.

• XmlReader 속성을 XmlResolver 개체로 설정하여 XmlSecureResolver에서 액세스 가능한 리소스를 제한합니다.

또는

• XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(Stream, XmlReaderSettings, String)

Source:

XmlReader.cs

지정된 스트림, 기본 URI 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

XML 데이터가 포함된 스트림입니다.

XmlReader는 스트림의 첫 번째 바이트를 검색하여 바이트 순서 표시나 다른 인코딩 기호를 찾습니다. 인코딩이 확인되면 이 인코딩을 사용하여 스트림을 읽고, 입력을 문자 스트림(유니코드)으로 구문 분석하는 작업이 수행됩니다.

settings

XmlReaderSettings

새 XmlReader 인스턴스의 설정입니다. 이 값은 null일 수 있습니다.

baseUri

String

읽을 엔터티 또는 문서의 기본 URI입니다. 이 값은 null일 수 있습니다.

보안 정보 기본 URI는 XML 문서의 상대 URI를 확인하는 데 사용됩니다. 신뢰할 수 없는 소스의 기본 URI는 사용하지 않는 것이 좋습니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

input 값이 null입니다.

설명

기본적으로 XmlUrlResolver 자격 증명이 없는 는 DTD(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 XmlReaderSettings.XmlResolver 필요한 자격 증명으로 을 XmlResolver 지정합니다.

중요

다음 방법 중 하나를 사용하여 에 액세스할 수 있는 리소스를 XmlReader 제어할 수 있습니다.

• XmlReader 속성을 XmlResolver 개체로 설정하여 XmlSecureResolver에서 액세스 가능한 리소스를 제한합니다.

또는

• XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(XmlReader, XmlReaderSettings)

Source:

XmlReader.cs

지정된 XML 판독기 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

내부 XML 판독기로 사용할 개체입니다.

settings

XmlReaderSettings

새 XmlReader 인스턴스의 설정입니다.

XmlReaderSettings 개체의 규칙 수준은 기본 판독기의 규칙 수준과 일치하거나 Auto로 설정되어야 합니다.

반환

XmlReader

지정된 XmlReader 개체를 래핑하는 개체입니다.

예외

ArgumentNullException

reader 값이 null입니다.

InvalidOperationException

XmlReaderSettings 개체가 기본 판독기의 규칙 수준과 일치하지 않는 규칙 수준을 지정하는 경우

또는

기본 XmlReader가 Error 또는 Closed 상태에 있는 경우

예제

다음 예제에서는 개체 주위에 래핑되는 유효성 XmlReader 검사 개체를 XmlNodeReader 만듭니다.

// 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 . 기본 XmlReader 개체는 메서드에서 Create 만든 다른 XmlReader 개체이거나 XmlReader 구체적인 XmlReader 구현 중 하나를 사용하여 만든 개체일 수 있습니다.

자격 증명이 없는 기본값 XmlUrlResolver 은 스키마와 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 필요한 자격 증명을 사용하여 을 XmlReaderSettings.XmlResolver 지정 XmlResolver 합니다.

중요

다음 방법 중 하나를 사용하여 에 액세스할 수 있는 리소스를 XmlReader 제어할 수 있습니다.

• XmlReader 속성을 XmlResolver 개체로 설정하여 XmlSecureResolver에서 액세스 가능한 리소스를 제한합니다.

또는

• XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(TextReader, XmlReaderSettings, String)

Source:

XmlReader.cs

지정된 텍스트 판독기, 설정 및 기본 URI를 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

XML 데이터를 읽어올 텍스트 판독기입니다. 텍스트 판독기는 유니코드 문자 스트림을 반환하므로 XML 선언에 지정된 인코딩은 XmlReader가 데이터 스트림을 디코딩하는 데 사용되지 않습니다.

settings

XmlReaderSettings

새 XmlReader 인스턴스의 설정입니다. 이 값은 null일 수 있습니다.

baseUri

String

읽을 엔터티 또는 문서의 기본 URI입니다. 이 값은 null일 수 있습니다.

보안 정보 기본 URI는 XML 문서의 상대 URI를 확인하는 데 사용됩니다. 신뢰할 수 없는 소스의 기본 URI는 사용하지 않는 것이 좋습니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

input 값이 null입니다.

설명

기본적으로 XmlUrlResolver 자격 증명이 없는 는 DTD(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 XmlReaderSettings.XmlResolver 필요한 자격 증명으로 을 XmlResolver 지정합니다.

중요

다음 방법 중 하나를 사용하여 에 액세스할 수 있는 리소스를 XmlReader 제어할 수 있습니다.

• XmlReader 속성을 XmlResolver 개체로 설정하여 XmlSecureResolver에서 액세스 가능한 리소스를 제한합니다.

또는

• XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(TextReader, XmlReaderSettings)

Source:

XmlReader.cs

지정된 텍스트 판독기 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

XML 데이터를 읽어올 텍스트 판독기입니다. 텍스트 판독기는 유니코드 문자 스트림을 반환하므로 XML 선언에 지정된 인코딩은 XML 판독기가 데이터 스트림을 디코딩하는 데 사용되지 않습니다.

settings

XmlReaderSettings

새 XmlReader의 설정입니다. 이 값은 null일 수 있습니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

input 값이 null입니다.

설명

기본적으로 XmlUrlResolver 자격 증명이 없는 는 DTD(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 XmlReaderSettings.XmlResolver 필요한 자격 증명으로 을 XmlResolver 지정합니다.

중요

다음 방법 중 하나를 사용하여 에 액세스할 수 있는 리소스를 XmlReader 제어할 수 있습니다.

• XmlReader 속성을 XmlResolver 개체로 설정하여 XmlSecureResolver에서 액세스 가능한 리소스를 제한합니다.

또는

• XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(Stream, XmlReaderSettings)

Source:

XmlReader.cs

지정된 스트림 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

XML 데이터가 포함된 스트림입니다.

XmlReader는 스트림의 첫 번째 바이트를 검색하여 바이트 순서 표시나 다른 인코딩 기호를 찾습니다. 인코딩이 확인되면 이 인코딩을 사용하여 스트림을 읽고, 입력을 문자 스트림(유니코드)으로 구문 분석하는 작업이 수행됩니다.

settings

XmlReaderSettings

새 XmlReader 인스턴스의 설정입니다. 이 값은 null일 수 있습니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

input 값이 null입니다.

설명

기본적으로 XmlUrlResolver 자격 증명이 없는 는 DTD(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 XmlReaderSettings.XmlResolver 필요한 자격 증명으로 을 XmlResolver 지정합니다.

중요

다음 방법 중 하나를 사용하여 에 액세스할 수 있는 리소스를 XmlReader 제어할 수 있습니다.

• XmlReader 속성을 XmlResolver 개체로 설정하여 XmlSecureResolver에서 액세스 가능한 리소스를 제한합니다.

또는

• XmlReader 속성을 XmlResolver로 설정하여 null가 모든 외부 리소스를 열 수 없도록 하십시오.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(String)

Source:

XmlReader.cs

지정된 URI를 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

XML 데이터를 포함하는 파일의 URI입니다. XmlUrlResolver 클래스는 경로를 정규 데이터 표현으로 변환하는 데 사용됩니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

inputUri 값이 null입니다.

SecurityException

XmlReader에는 XML 데이터 위치에 액세스할 수 있는 충분한 권한이 없습니다.

FileNotFoundException

URI로 식별된 파일이 없는 경우

UriFormatException

URI 형식이 잘못되었습니다.

참고: Windows 스토어 앱 또는 이식 가능한 클래스 라이브러리용 .NET에서 기본 클래스 예외 를 FormatException대신 catch합니다.

예제

다음 예제에서는 URI로 XmlReader 지정된 XML 데이터 파일을 읽는 개체를 만듭니다.

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

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

설명

XmlReaderSettings 기본 설정이 있는 개체는 판독기를 만드는 데 사용됩니다. 만든 판독기에서 지원할 기능을 지정하려면 개체를 인수 중 하나로 사용하는 XmlReaderSettings 오버로드를 사용하고 올바른 설정으로 개체를 XmlReaderSettings 전달합니다.

자격 증명이 없는 기본값 XmlUrlResolver 은 DTD(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 필요한 자격 증명을 사용하여 을 XmlReaderSettings.XmlResolver 지정 XmlResolver 합니다.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(TextReader)

Source:

XmlReader.cs

지정된 텍스트 판독기를 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

XML 데이터를 읽어올 텍스트 판독기입니다. 텍스트 판독기는 유니코드 문자 스트림을 반환하므로 XML 선언에 지정된 인코딩은 XML 판독기가 데이터 스트림을 디코딩하는 데 사용되지 않습니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

input 값이 null입니다.

예제

다음 예제에서는 클래스를 StringReader 사용하여 XML 문자열을 읽습니다.

string xmlData ="<item productID='124390'>" +
                        "<price>5.95</price>" +
                        "</item>";

// Create the XmlReader object.
XmlReader reader = XmlReader.Create(new StringReader(xmlData));

Dim xmlData As String = "<item productID='124390'>" & _ 
                                     "<price>5.95</price>" & _ 
                                     "</item>"

' Create the XmlReader object.
Dim reader As XmlReader = XmlReader.Create(New StringReader(xmlData))

설명

XmlReaderSettings 기본 설정이 있는 개체는 판독기를 만드는 데 사용됩니다. 만든 판독기에서 지원할 기능을 지정하려면 개체를 인수 중 하나로 사용하는 XmlReaderSettings 오버로드를 사용하고 올바른 설정으로 개체를 XmlReaderSettings 전달합니다.

자격 증명이 없는 기본값 XmlUrlResolver 은 DTD(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 필요한 자격 증명을 사용하여 을 XmlReaderSettings.XmlResolver 지정 XmlResolver 합니다.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(Stream)

Source:

XmlReader.cs

기본 설정의 지정된 스트림을 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

XML 데이터가 포함된 스트림입니다.

XmlReader는 스트림의 첫 번째 바이트를 검색하여 바이트 순서 표시나 다른 인코딩 기호를 찾습니다. 인코딩이 확인되면 이 인코딩을 사용하여 스트림을 읽고, 입력을 문자 스트림(유니코드)으로 구문 분석하는 작업이 수행됩니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

input 값이 null입니다.

SecurityException

XmlReader에는 XML 데이터 위치에 액세스할 수 있는 충분한 권한이 없습니다.

예제

다음 예제에서는 에서 읽는 개체를 FileStream만듭니다XmlReader.

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 기본 설정이 있는 개체는 판독기를 만드는 데 사용됩니다. 만든 판독기에서 지원할 기능을 지정하려면 개체를 인수 중 하나로 사용하는 XmlReaderSettings 오버로드를 사용하고 올바른 설정으로 개체를 XmlReaderSettings 전달합니다.

자격 증명이 없는 기본값 XmlUrlResolver 은 DTD(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 필요한 자격 증명을 사용하여 을 XmlReaderSettings.XmlResolver 지정 XmlResolver 합니다.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.

Create(String, XmlReaderSettings)

Source:

XmlReader.cs

지정된 URI 및 설정을 사용하여 새 XmlReader 인스턴스를 만듭니다.

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

XML 데이터를 포함하는 파일의 URI입니다. XmlReaderSettings 개체의 XmlResolver 개체는 경로를 정규 데이터 표현으로 변환하는 데 사용됩니다. XmlResolver가 null이면 새 XmlUrlResolver 개체가 사용됩니다.

settings

XmlReaderSettings

새 XmlReader 인스턴스의 설정입니다. 이 값은 null일 수 있습니다.

반환

XmlReader

스트림의 XML 데이터를 읽는 데 사용되는 개체입니다.

예외

ArgumentNullException

inputUri 값이 null입니다.

FileNotFoundException

URI로 지정된 파일을 찾을 수 없습니다.

UriFormatException

URI 형식이 잘못되었습니다.

참고: Windows 스토어 앱 또는 이식 가능한 클래스 라이브러리용 .NET에서 기본 클래스 예외 를 FormatException대신 catch합니다.

예제

다음 예제에서는 DTD(문서 형식 정의) 유효성 검사를 지원하는 개체를 만듭니다 XmlReader .

// 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(문서 형식 정의), 엔터티, 스키마 등과 같은 외부 리소스에 액세스하는 데 사용됩니다.

중요

.NET Framework 4.5.2부터는 기본값 XmlUrlResolver 이 제공되지 않습니다. 솔루션이 .NET Framework 4.5.2 이상 버전을 대상으로 하는 경우 속성을 사용하여 을 XmlResolverXmlReaderSettings.XmlResolver 지정합니다.

즉, 는 XmlReader 인증이 필요하지 않은 모든 위치에 액세스할 수 있습니다. 외부 리소스가 인증이 필요한 네트워크 리소스에 있는 경우 속성을 사용하여 XmlReaderSettings.XmlResolver 필요한 자격 증명으로 을 XmlResolver 지정합니다.

중요

속성을 개체로 설정하여 에서 XmlReader 액세스할 수 있는 리소스를 XmlResolverXmlSecureResolver 제한할 수 있습니다.

만든 XmlReader 개체는 엔터티 참조를 확장하고 새 줄 문자의 XML 정규화를 수행합니다.