IXmlSerializer 介面
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
定義一個 XML 資訊集序列化介面。
[Android.Runtime.Register("org/xmlpull/v1/XmlSerializer", "", "Org.XmlPull.V1.IXmlSerializerInvoker")]
public interface IXmlSerializer : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("org/xmlpull/v1/XmlSerializer", "", "Org.XmlPull.V1.IXmlSerializerInvoker")>]
type IXmlSerializer = interface
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 屬性
- 實作
備註
序列化器操作定義於 Android 16 序列化器介面中。 前綴產生、元素狀態及可鏈式回傳值可由置頂的 Android KXmlSerializer 實作說明。
.NET 串流過載使用輸出串流轉接器。 關閉該介面卡會關閉底層的 .NET 串流;這些方法並未提供開啟選項。
定義一個 XML 資訊集序列化介面。 此介面會抽象化序列化 XML 是否為相容 XML 1.0 的文字,或是其他 XML 1.0 序列化格式(例如二進位 XML,例如 WBXML)。
<b>請注意:</b> 此介面將成為 XmlPull 1.2 API 的一部分。 本文作為討論基礎。 它可能會以任何方式改變。
可拋出的例外包括:IOException 或執行時例外(可拋出更多執行時例外,但未宣告,因此此介面沒有定義語意):ul<li em IllegalArgumentException>/em< - 幾乎所有標示該參數為非法><的方法 li>em<IllegalStateException>/em<><><>- 用來表示呼叫有良好的參數,但此處不預期(違反合約)及在請求設定未實作功能/屬性時(UnsupportedOperationException 會更好,但 MIDP 中沒有)</ul>
<b>注意:</b> 在某些實作中撰寫 CDSECT、ENTITY_REF、IGNORABLE_WHITESPACE、PROCESSING_INSTRUCTION、COMMENT 和 DOCDECL 可能不支援(例如序列化為 WBXML 時)。 此時會拋出 IllegalStateException,建議使用選用功能表示實作不支援此類輸出。
Java 文件 org.xmlpull.v1.XmlSerializer。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
屬性
| 名稱 | Description |
|---|---|
| Depth |
回傳元件目前的深度。 |
| Handle |
取得底層 Android 物件的 JNI 值。 (繼承來源 IJavaObject) |
| JniIdentityHashCode |
回傳包裹實例的 |
| JniManagedPeerState |
管理貴族的狀況。 (繼承來源 IJavaPeerable) |
| JniObjectReferenceControlBlock |
取得一個實作專屬的 JNI 參考控制區塊指標。 (繼承來源 IJavaPeerable) |
| JniPeerMembers |
成員存取與召喚支援。 (繼承來源 IJavaPeerable) |
| Name |
回傳由 startTag() 設定的當前元素名稱。 |
| Namespace |
回傳目前元素的命名空間 URI,由 startTag() 設定。 |
| PeerReference |
回傳JniObjectReference包裹後的 Java 物件實例。 (繼承來源 IJavaPeerable) |
方法
| 名稱 | Description |
|---|---|
| Attribute(String, String, String) |
寫一個屬性。 |
| Cdsect(String) |
將提供的文字寫入 CDATA。 |
| Comment(String) |
撰寫包含所提供文字的 XML 註解。 |
| Disposed() |
當實例被處理後才被召喚。 (繼承來源 IJavaPeerable) |
| DisposeUnlessReferenced() |
如果沒有未解決的參考資料,則 |
| Docdecl(String) |
撰寫包含所提供文字的文件類型聲明。 |
| EndDocument() |
把書寫完成。 |
| EndTag(String, String) |
寫下結束標籤。 |
| EntityRef(String) |
會寫入一個包含所提供名稱的實體參考。 |
| Finalized() |
當實例完成後才會被通知。 (繼承來源 IJavaPeerable) |
| Flush() |
把所有待處理的輸出寫入串流。 |
| GetFeature(String) |
回傳該特徵的當前值並帶有名稱。 |
| GetPrefix(String, Boolean) |
回傳對應於給定前綴的命名空間:若該命名空間沒有綁定前綴,則回傳空;若 generatePrefix 為假,則回傳已生成的前綴。 |
| GetProperty(String) |
查詢房產的價值。 |
| IgnorableWhitespace(String) |
在 XML 輸出中寫入空白。 |
| ProcessingInstruction(String) |
撰寫 XML 處理指令。 |
| SetFeature(String, Boolean) |
設定以名稱識別的功能(建議使用 URI 以求唯一性)。 |
| SetJniIdentityHashCode(Int32) |
將回傳的值設為 |
| SetJniManagedPeerState(JniManagedPeerStates) |
設定狀態旗標 。 |
| SetOutput(Stream, String) |
設定為使用帶有特定編碼的二進位輸出串流。 |
| SetOutput(Writer) |
將輸出設定給指定的寫入者。 |
| SetPeerReference(JniObjectReference) |
將回傳的值設為 |
| SetPrefix(String, String) |
將給定前綴綁定到指定命名空間。 |
| SetProperty(String, Object) |
設定房產價值。 |
| StartDocument(String, Boolean) |
寫作 &;?XML 宣告,若編碼非 null,則為獨立標誌(若非 null),此方法只能在 setOutput 之後呼叫。 |
| StartTag(String, String) |
寫入一個包含指定命名空間和名稱的起始標籤。 |
| Text(Char[], Int32, Int32) |
撰寫文字,特殊 XML 字元會自動跳脫 |
| Text(String) |
撰寫文字,特殊 XML 字元會自動跳脫 |
| UnregisterFromRuntime() |
取消註冊此實例,讓執行時不會在未來 Java.Interop.JniRuntime+JniValueManager.PeekValue 的呼叫中回傳該實例。 (繼承來源 IJavaPeerable) |