XmlReader.IsStartElement Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Geçerli içerik düğümünü bir başlangıç etiketi olup olmadığını sınar.

Aşırı Yüklemeler

Name	Description
IsStartElement(String, String)	Geçerli içerik düğümünün bir başlangıç etiketi veya boş öğe etiketi olup olmadığını ve bulunan öğenin ve MoveToContent() özelliklerinin verilen dizelerle eşleşip eşleşmediğini LocalName çağırır NamespaceURI ve test eder.
IsStartElement()	Geçerli içerik düğümü bir başlangıç etiketi veya boş öğe etiketiyse çağrılar MoveToContent() ve testler.
IsStartElement(String)	Geçerli içerik düğümünün bir başlangıç etiketi veya boş öğe etiketi olup olmadığını ve bulunan öğenin özelliğinin verilen bağımsız değişkenle eşleşip eşleşmediğini MoveToContent() çağırır Name ve test eder.

IsStartElement(String, String)

Kaynak:

XmlReader.cs

Geçerli içerik düğümünün bir başlangıç etiketi veya boş öğe etiketi olup olmadığını ve bulunan öğenin ve MoveToContent() özelliklerinin verilen dizelerle eşleşip eşleşmediğini LocalName çağırır NamespaceURI ve test eder.

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

Parametreler

localname

String

Bulunan öğesinin özelliğiyle LocalName eşleşecek dize.

ns

String

Bulunan öğesinin özelliğiyle NamespaceURI eşleşecek dize.

Döndürülenler

Boolean

true elde edilen düğüm bir öğeyse. false dışında XmlNodeType.Element bir düğüm türü bulunduysa veya öğesinin LocalName ve NamespaceURI özellikleri belirtilen dizelerle eşleşmiyorsa.

Özel durumlar

XmlException

Giriş akışında yanlış XML ile karşılaşıldı.

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Açıklamalar

Bu yöntem, okuyucu bir içerik düğümünde konumlandırılana kadar boşluk, açıklama ve işleme yönergelerini atlar. Yöntemi daha sonra geçerli düğümün bir öğe olup olmadığını sınar.

Ayrıca bkz.

• MoveToContent()

IsStartElement()

Kaynak:

XmlReader.cs

Geçerli içerik düğümü bir başlangıç etiketi veya boş öğe etiketiyse çağrılar MoveToContent() ve testler.

public:
 virtual bool IsStartElement();

public virtual bool IsStartElement();

abstract member IsStartElement : unit -> bool
override this.IsStartElement : unit -> bool

Public Overridable Function IsStartElement () As Boolean

Döndürülenler

Boolean

true bir MoveToContent() başlangıç etiketi veya boş öğe etiketi bulursa; false farklı XmlNodeType.Element bir düğüm türü bulunursa.

Özel durumlar

XmlException

Giriş akışında yanlış XML ile karşılaşıldı.

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnek, her öğenin metin içeriğini görüntüler.

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

Örnekte giriş elems.xmlolarak dosyası kullanılır.

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
  <misc/>
</book>

Açıklamalar

Bu yöntem, okuyucu bir içerik düğümünde konumlandırılana kadar boşluk, açıklama ve işleme yönergelerini atlar. Yöntemi daha sonra geçerli düğümün bir öğe olup olmadığını sınar.

Ayrıca bkz.

• MoveToContent()

IsStartElement(String)

Kaynak:

XmlReader.cs

Geçerli içerik düğümünün bir başlangıç etiketi veya boş öğe etiketi olup olmadığını ve bulunan öğenin özelliğinin verilen bağımsız değişkenle eşleşip eşleşmediğini MoveToContent() çağırır Name ve test eder.

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

Parametreler

name

String

Bulunan öğesinin özelliğiyle Name eşleşen dize.

Döndürülenler

Boolean

true sonuçta elde edilen düğüm bir öğeyse ve Name özellik belirtilen dizeyle eşleşiyorsa. false dışında bir düğüm türü XmlNodeType.Element bulunduysa veya öğe Name özelliği belirtilen dizeyle eşleşmiyorsa.

Özel durumlar

XmlException

Giriş akışında yanlış XML ile karşılaşıldı.

InvalidOperationException

Önceki XmlReader bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.

Örnekler

Aşağıdaki örnekte her fiyat öğesi görüntülenir.

// 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

Açıklamalar

Bu yöntem, okuyucu bir içerik düğümünde konumlandırılana kadar boşluk, açıklama ve işleme yönergelerini atlar. Yöntemi daha sonra geçerli düğümün bir öğe olup olmadığını sınar.

Ayrıca bkz.

• MoveToContent()