語言

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>

根據 var/var< 的值>http://xml.org/sax/features/namespaces<及 >var</var>http://xml.org/sax/features/namespace-prefixes< 性質,這些選項中的任何一種或全部可能被提供:>

<ul><li>當命名空間屬性為 <var>true</var> (預設值)時,命名空間 URI 與本地名稱是必需的;當命名空間屬性為 <var>false</var> (若指定其中一者,兩者皆必須同時存在)時則為可選;</li><li>當 namespace-prefixes 屬性為 <var>true</var> 時,必須使用限定名稱;當 namespace-prefixes 屬性為 <var>false</var> (預設值)時,則為可選名稱。</li></ul>

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

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

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

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

適用於