XmlReader.IsStartElement Method

Definition

현재 콘텐츠 노드가 시작 태그인지 테스트합니다.Tests if the current content node is a start tag.

Overloads

IsStartElement(String, String)

MoveToContent()를 호출하고 현재 콘텐츠 노드가 시작 태그 또는 빈 요소 태그인지 여부와 찾은 요소의 LocalNameNamespaceURI 속성이 지정된 인수와 일치하는지 여부를 테스트합니다.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the LocalName and NamespaceURI properties of the element found match the given strings.

IsStartElement()

MoveToContent()를 호출하고 현재 콘텐츠 노드가 시작 태그 또는 빈 요소 태그인지 테스트합니다.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag.

IsStartElement(String)

MoveToContent()를 호출하고 현재 콘텐츠 노드가 시작 태그 또는 빈 요소 태그인지 여부와 찾은 요소의 Name 속성이 지정된 인수와 일치하는지 여부를 테스트합니다.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the Name property of the element found matches the given argument.

IsStartElement(String, String)

MoveToContent()를 호출하고 현재 콘텐츠 노드가 시작 태그 또는 빈 요소 태그인지 여부와 찾은 요소의 LocalNameNamespaceURI 속성이 지정된 인수와 일치하는지 여부를 테스트합니다.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the LocalName and NamespaceURI properties of the element found match the given strings.

public:
 virtual bool IsStartElement(System::String ^ localname, System::String ^ ns);
public virtual bool IsStartElement (string localname, string ns);
abstract member IsStartElement : string * string -> bool
override this.IsStartElement : string * string -> bool
Public Overridable Function IsStartElement (localname As String, ns As String) As Boolean

Parameters

localname
String

찾은 요소의 LocalName 속성과 일치하는 문자열입니다.The string to match against the LocalName property of the element found.

ns
String

찾은 요소의 NamespaceURI 속성과 일치하는 문자열입니다.The string to match against the NamespaceURI property of the element found.

Returns

Boolean

테스트한 결과 현재 노드가 요소이면 true이고,true if the resulting node is an element. false 이외의 노드 형식을 찾거나 요소의 XmlNodeType.ElementLocalName 속성이 지정된 문자열과 일치하지 않으면 NamespaceURI입니다.false if a node type other than XmlNodeType.Element was found or if the LocalName and NamespaceURI properties of the element do not match the specified strings.

Exceptions

잘못 된 XML 입력 스트림의 발생 합니다.Incorrect XML is encountered in the input stream.

이전 비동기 작업이 완료되기 전에 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."

Remarks

공백, 설명 및 처리 명령 콘텐츠 노드에 판독기가 배치 될 때까지이 메서드는 건너뜁니다.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. 현재 노드가 요소 이면에 다음 메서드를 테스트 합니다.The method then tests if the current node is an element.

See also

IsStartElement()

MoveToContent()를 호출하고 현재 콘텐츠 노드가 시작 태그 또는 빈 요소 태그인지 테스트합니다.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag.

public:
 virtual bool IsStartElement();
public virtual bool IsStartElement ();
abstract member IsStartElement : unit -> bool
override this.IsStartElement : unit -> bool
Public Overridable Function IsStartElement () As Boolean

Returns

Boolean

MoveToContent()가 시작 태그나 빈 요소 태그를 찾으면 true이고, false 이외의 노드 형식을 찾으면 XmlNodeType.Element입니다.true if MoveToContent() finds a start tag or empty element tag; false if a node type other than XmlNodeType.Element was found.

Exceptions

잘못 된 XML 입력 스트림의 발생 합니다.Incorrect XML is encountered in the input stream.

이전 비동기 작업이 완료되기 전에 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 method skips white space, comments, and processing instructions until the reader is positioned on a content node. 현재 노드가 요소 이면에 다음 메서드를 테스트 합니다.The method then tests if the current node is an element.

See also

IsStartElement(String)

MoveToContent()를 호출하고 현재 콘텐츠 노드가 시작 태그 또는 빈 요소 태그인지 여부와 찾은 요소의 Name 속성이 지정된 인수와 일치하는지 여부를 테스트합니다.Calls MoveToContent() and tests if the current content node is a start tag or empty element tag and if the Name property of the element found matches the given argument.

public:
 virtual bool IsStartElement(System::String ^ name);
public virtual bool IsStartElement (string name);
abstract member IsStartElement : string -> bool
override this.IsStartElement : string -> bool
Public Overridable Function IsStartElement (name As String) As Boolean

Parameters

name
String

찾은 요소의 Name 속성과 일치하는 문자열입니다.The string matched against the Name property of the element found.

Returns

Boolean

테스트한 결과 현재 노드가 요소이고 true 속성이 지정된 문자열과 일치하면 Name이고,true if the resulting node is an element and the Name property matches the specified string. false 이외의 노드 형식을 찾거나 요소 XmlNodeType.Element 속성이 지정된 문자열과 일치하지 않으면 Name입니다.false if a node type other than XmlNodeType.Element was found or if the element Name property does not match the specified string.

Exceptions

잘못 된 XML 입력 스트림의 발생 합니다.Incorrect XML is encountered in the input stream.

이전 비동기 작업이 완료되기 전에 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 each price element.

// Parse the file and display each price node.
while (reader.Read()) {
  if (reader.IsStartElement("price")) {
     Console.WriteLine(reader.ReadInnerXml());
  }
}
' Parse the file and display each price node.
While reader.Read()
  If reader.IsStartElement("price") Then
    Console.WriteLine(reader.ReadInnerXml())
  End If
End While

Remarks

공백, 설명 및 처리 명령 콘텐츠 노드에 판독기가 배치 될 때까지이 메서드는 건너뜁니다.This method skips white space, comments, and processing instructions until the reader is positioned on a content node. 현재 노드가 요소 이면에 다음 메서드를 테스트 합니다.The method then tests if the current node is an element.

See also

Applies to