XmlReader.IsEmptyElement Property

Definition

파생 클래스에서 재정의되면 현재 노드가 <MyElement/>와 같은 빈 요소인지를 나타내는 값을 가져옵니다.When overridden in a derived class, gets a value indicating whether the current node is an empty element (for example, <MyElement/>).

public:
 abstract property bool IsEmptyElement { bool get(); };
public abstract bool IsEmptyElement { get; }
member this.IsEmptyElement : bool
Public MustOverride ReadOnly Property IsEmptyElement As Boolean

Property Value

Boolean

현재 노드가 />로 끝나는 요소 (NodeType equals XmlNodeType.Element) 인 경우 true 합니다. 그렇지 않으면 false합니다.true if the current node is an element (NodeType equals XmlNodeType.Element) that ends with />; otherwise, false.

Exceptions

이전 비동기 작업이 완료되기 전에 XmlReader 메서드가 호출되었습니다.An XmlReader method was called before a previous asynchronous operation finished. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

Examples

다음 예제에서는 각 요소의 텍스트 콘텐츠를 표시합니다.The following example displays the text content of each element.

while (reader.Read()) {
  if (reader.IsStartElement()) {
    if (reader.IsEmptyElement)
                {
                    Console.WriteLine("<{0}/>", reader.Name);
                }
                else {
      Console.Write("<{0}> ", reader.Name);
      reader.Read(); // Read the start tag.
      if (reader.IsStartElement())  // Handle nested elements.
        Console.Write("\r\n<{0}>", reader.Name);
      Console.WriteLine(reader.ReadString());  //Read the text content of the element.
    }
  }
}
While reader.Read()
  If reader.IsStartElement() Then
    If reader.IsEmptyElement Then
      Console.WriteLine("<{0}/>", reader.Name)
    Else
      Console.Write("<{0}> ", reader.Name)
      reader.Read() ' Read the start tag.
      If reader.IsStartElement() Then ' Handle nested elements.
        Console.Write(vbCr + vbLf + "<{0}>", reader.Name)
      End If
      Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
    End If
  End If
End While

이 예제에서는 elems.xml파일을 입력으로 사용 합니다.The example uses the file, elems.xml, as input.

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
  <misc/>
</book>

Remarks

이 속성을 사용하여 다음 간의 차이를 확인할 수 있습니다.This property enables you to determine the difference between the following:

<item num="123"/> (IsEmptyElement true).<item num="123"/> (IsEmptyElement is true).

<item num="123"></item> (IsEmptyElement 요소 내용이 비어 있지만 false됩니다.<item num="123"></item> (IsEmptyElement is false, although element content is empty).

빈 요소에는 해당 EndElement 노드가 생성 되지 않습니다.A corresponding EndElement node is not generated for empty elements.

스키마 유효성 검사로 인해 기본 콘텐츠가 요소에 추가 된 경우에는 IsEmptyElement true반환 됩니다.If default content has been added to an element due to schema validation, IsEmptyElement still returns true. 요소에는 기본값이 여부에 관계가 없습니다.It has no bearing on whether or not the element has a default value. 즉, IsEmptyElement는 소스 문서의 요소에 끝 요소 태그가 있는지 여부를 보고 합니다.In other words, IsEmptyElement simply reports whether or not the element in the source document had an end element tag.

Applies to