XmlReader.IsStartElement Yöntem

Tanım

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

Aşırı Yüklemeler

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 NamespaceURI özelliklerinin verilen dizelerle eşleşip eşleşmediğini LocalName çağırır MoveToContent() 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 Name çağırır MoveToContent() ve test eder.

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 NamespaceURI özelliklerinin verilen dizelerle eşleşip eşleşmediğini LocalName çağırır MoveToContent() 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 öğenin özelliğiyle LocalName eşleşecek dize.

ns
String

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

Döndürülenler

Boolean

true sonuçta 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

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

Ö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üne konumlandırılana kadar boşlukları, açıklamaları 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.

Şunlara uygulanır

IsStartElement()

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 başlangıç etiketi veya boş öğe etiketi bulursa MoveToContent() ; false dışında XmlNodeType.Element bir düğüm türü bulunursa.

Özel durumlar

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

Ö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 öğenin metin içeriği görüntülenir.

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üne konumlandırılana kadar boşlukları, açıklamaları 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.

Şunlara uygulanır

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 Name çağırır MoveToContent() 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 öğenin ö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 XmlNodeType.Element bir düğüm türü bulunduysa veya öğe Name özelliği belirtilen dizeyle eşleşmiyorsa.

Özel durumlar

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

Ö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üne konumlandırılana kadar boşlukları, açıklamaları 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.

Şunlara uygulanır