語言

ValidatorHandler.StartElement(String, String, String, IAttributes) 方法

定義

接收元素開始的通知。

[Android.Runtime.Register("startElement", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lorg/xml/sax/Attributes;)V", "GetStartElement_Ljava_lang_String_Ljava_lang_String_Ljava_lang_String_Lorg_xml_sax_Attributes_Handler")]
public abstract void StartElement(string? uri, string? localName, string? qName, Org.Xml.Sax.IAttributes? atts);
[<Android.Runtime.Register("startElement", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Lorg/xml/sax/Attributes;)V", "GetStartElement_Ljava_lang_String_Ljava_lang_String_Ljava_lang_String_Lorg_xml_sax_Attributes_Handler")>]
abstract member StartElement : string * string * string * Org.Xml.Sax.IAttributes -> unit

參數

uri
String

命名空間 URI,或若元素沒有命名空間 URI,或未進行命名空間處理,則為空字串

localName
String

本地名稱(無前綴),或在未進行命名空間處理時使用空字串

qName
String

限定名稱(含前綴),或若無法取得合格名稱則使用空字串

atts
IAttributes

附加於元素的屬性。 若無屬性,則為空屬性物件。 startElement 回傳後,該物件的值未定義

實作

屬性

備註

接收元素開始的通知。

解析器會在 XML 文件中每個元素的開頭呼叫此方法;每個 startElement 事件都會有對應 #endElement endElement 事件(即使該元素為空)。 元素的所有內容都會依序在對應的 endElement 事件發生前報告。

此事件允許每個元素最多三個命名元件:

<ol><li>命名空間 URI;</li><li>為當地名稱;/<li<>li>為限定(前綴)名稱。</li></ol>

根據 的 http://xml.org/sax/features/namespaces 值與屬性 http://xml.org/sax/features/namespace-prefixes ,以下任何一項或全部可能被提供:

<ul><li>當 namespaces 屬性為 true (預設值)時,命名空間 URI 與本地名稱為必填;當 namespaces 屬性為 false(若指定為 false ,兩者皆必須為 false)時,則為可選;</li><li>當 namespace-prefixes 屬性為 true 時,合格名稱為必填;當 namespace-prefixes 屬性為 false (預設值)時則為選填。</li></ul>

請注意,所提供的屬性清單只會包含明確值(指定或預設值)的屬性:#IMPLIED 屬性會被省略。 屬性清單僅在屬性 http://xml.org/sax/features/namespace-prefixes 為真(預設為假,且可選為真值)時,才會包含用於命名空間宣告的屬性(xmlns* 屬性)。

例如 #characters characters(),屬性值可能有需要多個 char 值的字元。

Java 文件 org.xml.sax.ContentHandler.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於