XmlReaderSettings.CheckCharacters Property

Definition

문자 검사를 수행할지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether to do character checking.

public:
 property bool CheckCharacters { bool get(); void set(bool value); };
public bool CheckCharacters { get; set; }
member this.CheckCharacters : bool with get, set
Public Property CheckCharacters As Boolean

Property Value

Boolean

문자 검사를 하려면 true이고, 그렇지 않으면 false입니다.true to do character checking; otherwise false. 기본값은 true입니다.The default is true.


텍스트 데이터를 처리할 경우 XmlReader는 이 속성의 설정에 상관없이 XML 이름 및 텍스트 콘텐츠의 유효성을 항상 검사합니다.If the XmlReader is processing text data, it always checks that the XML names and text content are valid, regardless of the property setting. CheckCharactersfalse로 설정하면 문자 엔터티 참조에 대해 문자 검사가 수행되지 않습니다.Setting CheckCharacters to false turns off character checking for character entity references.

Remarks

이 속성은 xml 판독기가 읽고 있는 XML 데이터의 문자를 확인 하 고 문자가 유효한 XML 문자 범위를 벗어나면 XmlException을 throw 하도록 지시 합니다.This property instructs the XML reader to check characters in the XML data it's reading and throw an XmlException if any characters are outside the range of legal XML characters. 문자 검사 기능을 사용하면 다음 사항을 확인할 수 있습니다.When character checking is enabled, you are ensured the following:

  • W3C XML 1.0 권장 사항의 2.2 문자 섹션에 정의 된 대로 문자는 유효한 xml 문자 범위 내에 있습니다.Characters are within the range of legal XML characters, as defined by the 2.2 Characters section of the W3C XML 1.0 Recommendation.

  • W3C XML 1.0 권장 사항의 2.3 일반적인 구문 구조 섹션에서 정의한 대로 모든 XML 이름은 유효 합니다.All XML names are valid, as defined by the 2.3 Common Syntactic Constructs section of the W3C XML 1.0 Recommendation.

이 속성을 기본 설정인 true로 설정 하면 XML 파일에 잘못 된 문자나 잘못 된 XML 이름 (예: 요소 이름이 숫자로 시작)이 포함 된 경우 XmlException 예외가 throw 됩니다.When this property is set to true, which is the default setting, an XmlException exception is thrown if the XML file contains illegal characters or invalid XML names (for example, an element name starts with a number).

Applies to