XmlReader.ReadToFollowing Method

Definition

명명된 요소를 찾을 때까지 읽습니다.Reads until the named element is found.

Overloads

ReadToFollowing(String)

지정된 정규화된 이름의 요소를 찾을 때까지 읽습니다.Reads until an element with the specified qualified name is found.

ReadToFollowing(String, String)

지정된 로컬 이름 및 네임스페이스 URI를 사용하는 요소를 찾을 때까지 읽습니다.Reads until an element with the specified local name and namespace URI is found.

ReadToFollowing(String)

지정된 정규화된 이름의 요소를 찾을 때까지 읽습니다.Reads until an element with the specified qualified name is found.

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

Parameters

name
String

요소의 정규화된 이름입니다.The qualified name of the element.

Returns

Boolean

일치하는 요소가 있으면 true이고, 그렇지 않으면 false이고 XmlReader가 파일 끝에 도달합니다.true if a matching element is found; otherwise false and the XmlReader is in an end of file state.

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.

Remarks

이 메서드는 현재 노드에서 following::name XPath 식을 실행 하는 것과 기능적으로 동일 합니다.This method is functionally equivalent executing the following::name XPath expression from the current node. XML 문서에 명명 된 요소를 찾는 빠른 방법을 제공 합니다.It provides a quick way to find a named element in the XML document. 판독기에서 지정 된 이름과 일치 하는 다음 요소로 이동 하 고 일치 하는 요소가 있는 경우 true을 반환 합니다.It advances the reader to the next following element that matches the specified name and returns true if a matching element is found. 아래 예제를 사용 하 여 판독기는 읽기 첫 번째 인스턴스의 지정된 된 요소를 앞으로 읽는 동안.Using the example below, the reader would read to the first instance of the specified element while reading forward.

<!--"sample.xml"-->  
<?xml version="1.0">  
   <items>  
      <item xmls="urn:1"/>  
   </items>  
</xml>  
  
XmlTextReader reader = newXmlTextReader("sample.xml");  
  
reader.ReadToFollowing("item");  
  

이 메서드는 모든 노드 형식에서 호출할 수 있습니다.This method can be called on all node types.

ReadToFollowing(String, String)

지정된 로컬 이름 및 네임스페이스 URI를 사용하는 요소를 찾을 때까지 읽습니다.Reads until an element with the specified local name and namespace URI is found.

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

Parameters

localName
String

요소의 로컬 이름입니다.The local name of the element.

namespaceURI
String

요소의 네임스페이스 URI입니다.The namespace URI of the element.

Returns

Boolean

일치하는 요소가 있으면 true이고, 그렇지 않으면 false이고 XmlReader가 파일 끝에 도달합니다.true if a matching element is found; otherwise false and the XmlReader is in an end of file state.

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

이 메서드는 현재 노드에서 following::name XPath 식을 실행 하는 것과 기능적으로 동일 합니다.This method is functionally equivalent executing the following::name XPath expression from the current node. XML 문서에 명명 된 요소를 찾는 빠른 방법을 제공 합니다.It provides a quick way to find a named element in the XML document. 판독기에서 지정 된 이름과 일치 하는 다음 요소로 이동 하 고 일치 하는 요소가 있는 경우 true을 반환 합니다.It advances the reader to the next following element that matches the specified name and returns true if a matching element is found.

<!--"sample.xml"-->  
<?xml version="1.0">  
   <items>  
      <item xmls="urn:1"/>  
   </items>  
</xml>  
  
XmlTextReader reader = newXmlTextReader("sample.xml");  
  
reader.ReadToFollowing("item", "urn:1");  
  

이 메서드는 모든 노드 형식에서 호출할 수 있습니다.This method can be called on all node types.

Applies to