XmlReader.ReadToFollowing Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.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)

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 jest XmlReader w stanie końca pliku.

Wyjątki

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim 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 wykonywaniu following::name wyrażenia XPath z bieżącego węzła. Zapewnia szybki sposób znajdowania nazwanego elementu w dokumencie XML. Spowoduje to przejście czytnika do następnego elementu zgodnego z określoną nazwą i zwraca true wartość w przypadku znalezienia pasującego elementu. W poniższym przykładzie czytnik odczytuje pierwsze wystąpienie określonego elementu podczas odczytywania do przodu.

<!--"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)

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 jest XmlReader w stanie końca pliku.

Wyjątki

InvalidOperationException

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim 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 wykonywaniu following::name wyrażenia XPath z bieżącego węzła. Zapewnia szybki sposób znajdowania nazwanego elementu w dokumencie XML. Spowoduje to przejście czytnika do następnego elementu zgodnego z określoną nazwą i zwraca true wartość w przypadku znalezienia pasującego elementu.

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