XmlReader.ReadToNextSibling Method

Definition

일치하는 다음 형제 요소로 XmlReader를 이동합니다.Advances the XmlReader to the next matching sibling element.

Overloads

ReadToNextSibling(String)

지정된 정규화 이름을 사용하는 다음 형제 요소로 XmlReader를 이동합니다.Advances the XmlReader to the next sibling element with the specified qualified name.

ReadToNextSibling(String, String)

지정된 로컬 이름과 네임스페이스 URI를 사용하는 다음 형제 요소로 XmlReader를 이동합니다.Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

ReadToNextSibling(String)

지정된 정규화 이름을 사용하는 다음 형제 요소로 XmlReader를 이동합니다.Advances the XmlReader to the next sibling element with the specified qualified name.

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

Parameters

name
String

판독기를 이동할 형제 요소의 정규화된 이름입니다.The qualified name of the sibling element you wish to move to.

Returns

Boolean

일치하는 형제 요소가 있으면 true이고, 그렇지 않으면 false입니다.true if a matching sibling element is found; otherwise false. 일치하는 형제 요소가 없으면 부모 요소의 끝 태그, 즉 NodeTypeXmlNodeType.EndElement인 태그에 XmlReader가 배치됩니다.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

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."

빈 문자열입니다.The parameter is an empty string.

Examples

다음 예제에서는 각 book 노드에 ISBN 특성을 읽습니다.The following example reads the ISBN attribute on each book node.

using (XmlReader reader = XmlReader.Create("books.xml")) {
    reader.ReadToFollowing("book");
    do {
       Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"));
    } while (reader.ReadToNextSibling("book"));
}
Using reader As XmlReader = XmlReader.Create("books.xml")
  reader.ReadToFollowing("book")
  Do
    Console.WriteLine("ISBN: {0}", reader.GetAttribute("ISBN"))
  Loop While reader.ReadToNextSibling("book")
End Using

Remarks

Note

XmlReader 초기 상태 (ReadState Initial) 인 경우 ReadToNextSibling를 호출 하지 마세요.Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). Read를 호출 하 여 XmlReader 이동한 다음 ReadToNextSibling 메서드를 호출할 수 있습니다.You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

ReadToNextSibling(String, String)

지정된 로컬 이름과 네임스페이스 URI를 사용하는 다음 형제 요소로 XmlReader를 이동합니다.Advances the XmlReader to the next sibling element with the specified local name and namespace URI.

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

Parameters

localName
String

판독기를 이동할 형제 요소의 로컬 이름입니다.The local name of the sibling element you wish to move to.

namespaceURI
String

판독기를 이동할 형제 요소의 네임스페이스 URI입니다.The namespace URI of the sibling element you wish to move to.

Returns

Boolean

일치하는 형제 요소가 있으면 true이고, 그렇지 않으면 false입니다.true if a matching sibling element is found; otherwise, false. 일치하는 형제 요소가 없으면 부모 요소의 끝 태그, 즉 NodeTypeXmlNodeType.EndElement인 태그에 XmlReader가 배치됩니다.If a matching sibling element is not found, the XmlReader is positioned on the end tag (NodeType is XmlNodeType.EndElement) of the parent element.

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."

두 매개 변수 값이 모두 null인 경우Both parameter values are null.

Remarks

Note

XmlReader 초기 상태 (ReadState Initial) 인 경우 ReadToNextSibling를 호출 하지 마세요.Do not call ReadToNextSibling when the XmlReader is an initial state (ReadState is Initial). Read를 호출 하 여 XmlReader 이동한 다음 ReadToNextSibling 메서드를 호출할 수 있습니다.You can call Read to advance the XmlReader and then call the ReadToNextSibling method.

Applies to