XmlReader.ReadToFollowing Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Odczytuje do momentu znalezienia nazwanego elementu.

Przeciążenia

ReadToFollowing(String)	Odczytuje do momentu znalezienia elementu o określonej kwalifikowanej nazwie.
ReadToFollowing(String, String)	Odczytuje do momentu znalezienia elementu o określonej lokalnej nazwie i identyfikatorze URI przestrzeni nazw.

ReadToFollowing(String)

Źródło:

XmlReader.cs

Odczytuje do momentu znalezienia elementu o określonej kwalifikowanej nazwie.

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

Parametry

name

String

Kwalifikowana nazwa elementu.

Zwraca

Boolean

true jeśli zostanie znaleziony pasujący element; w przeciwnym razie false element XmlReader jest w stanie zakończenia pliku.

Wyjątki

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentException

Parametr jest pustym ciągiem.

Uwagi

Ta metoda jest funkcjonalnie równoważna wykonujące following::name wyrażenie XPath z bieżącego węzła. Zapewnia szybki sposób znajdowania nazwanego elementu w dokumencie XML. Spowoduje to przejście czytelnika do następnego następującego elementu zgodnego z określoną nazwą i zwraca wartość true , jeśli zostanie znaleziony pasujący element. Korzystając z poniższego przykładu, czytelnik odczytał pierwsze wystąpienie określonego elementu podczas odczytywania dalej.

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item");

Tę metodę można wywołać we wszystkich typach węzłów.

ReadToFollowing(String, String)

Źródło:

XmlReader.cs

Odczytuje do momentu znalezienia elementu o określonej lokalnej nazwie i identyfikatorze URI przestrzeni nazw.

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

Parametry

localName

String

Lokalna nazwa elementu.

namespaceURI

String

Identyfikator URI przestrzeni nazw elementu.

Zwraca

Boolean

true jeśli zostanie znaleziony pasujący element; w przeciwnym razie false element XmlReader jest w stanie zakończenia pliku.

Wyjątki

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W tym przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

ArgumentNullException

Obie wartości parametrów to null.

Uwagi

Ta metoda jest funkcjonalnie równoważna wykonujące following::name wyrażenie XPath z bieżącego węzła. Zapewnia szybki sposób znajdowania nazwanego elementu w dokumencie XML. Spowoduje to przejście czytelnika do następnego następującego elementu zgodnego z określoną nazwą i zwraca wartość true , jeśli zostanie znaleziony pasujący element.

<!--"sample.xml"-->
<?xml version="1.0">
   <items>
      <item xmls="urn:1"/>
   </items>
</xml>

XmlTextReader reader = newXmlTextReader("sample.xml");

reader.ReadToFollowing("item", "urn:1");

Tę metodę można wywołać we wszystkich typach węzłów.