XmlReader.Create 메서드

정의

네임스페이스:

System.Xml

어셈블리:

netstandard.dll, System.Xml.ReaderWriter.dll

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

오버로드

Name	Description
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입니다. XmlResolver 개체의 XmlReaderSettings 개체는 경로를 정식 데이터 표현으로 변환하는 데 사용됩니다. 이 null경우 XmlResolver 새 XmlUrlResolver 개체가 사용됩니다.

settings

XmlReaderSettings

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

inputContext

XmlParserContext

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

이 값은 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 리소스를 XmlResolver 제한할 XmlSecureResolver 수 있습니다.

만든 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 조각을 구문 분석하는 데 필요한 컨텍스트 정보입니다. 컨텍스트 정보에는 사용할 항목, 인코딩, 네임스페이스 범위, 현재 xml:lang 및 xml:space 범위, 기본 URI 및 문서 형식 정의가 포함될 XmlNameTable 수 있습니다.

이 값은 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 조각을 구문 분석하는 데 필요한 컨텍스트 정보입니다. 컨텍스트 정보에는 사용할 항목, 인코딩, 네임스페이스 범위, 현재 xml:lang 및 xml:space 범위, 기본 URI 및 문서 형식 정의가 포함될 XmlNameTable 수 있습니다.

이 값은 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 데이터의 위치에 액세스할 수 있는 권한이 없습니다.

예제

다음 예제에서는 에서 읽는 XmlReader 개체를 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 기본 설정이 있는 개체는 판독기를 만드는 데 사용됩니다. 만든 판독기에서 지원할 기능을 지정하려면 개체를 인수 중 하나로 사용하는 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입니다. XmlResolver 개체의 XmlReaderSettings 개체는 경로를 정식 데이터 표현으로 변환하는 데 사용됩니다. 이 null경우 XmlResolver 새 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 리소스를 XmlResolver 제한할 XmlSecureResolver 수 있습니다.

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