XmlReader.IsStartElement Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
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
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.xml
olarak 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
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.