語言

ILexicalHandler.StartEntity(String) 方法

定義

命名空間:
Org.Xml.Sax.Ext
組件:
Mono.Android.dll

報告部分內部及外部 XML 實體的起始。

[Android.Runtime.Register("startEntity", "(Ljava/lang/String;)V", "GetStartEntity_Ljava_lang_String_Handler:Org.Xml.Sax.Ext.ILexicalHandlerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public void StartEntity(string? name);
[<Android.Runtime.Register("startEntity", "(Ljava/lang/String;)V", "GetStartEntity_Ljava_lang_String_Handler:Org.Xml.Sax.Ext.ILexicalHandlerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member StartEntity : string -> unit

參數

name
String

這個實體的名稱。 若為參數實體，名稱以 '%' 開頭;若為外部 DTD 子集，則為「[dtd]」。

屬性
RegisterAttribute

例外狀況

SAXException

申請可能會提出例外。

備註

報告部分內部及外部 XML 實體的起始。

參數實體（包括外部 DTD 子集）的報告是可選的，且報告 LexicalHandler 事件的 SAX2 驅動程式可能無法實作此功能;你可以利用這個 http://xml.org/sax/features/lexical-handler/parameter-entities 功能查詢或控制參數實體的報告。

一般實體以其常規名稱報告，參數實體名稱前加 '%'，外部 DTD 子集則有偽實體名稱「[dtd]」。

當 SAX2 驅動程式提供這些事件時，所有其他事件必須妥善巢狀於開始/結束實體事件中。 沒有額外要求事件org.xml.sax.ext.DeclHandler DeclHandlerorg.xml.sax.DTDHandler DTDHandler必須正確排序。

請注意，跳過的實體會透過 org.xml.sax.ContentHandler#skippedEntity skippedEntity 事件報告，事件是 ContentHandler 介面的一部分。

由於 SAX 使用的串流事件模型，某些實體邊界在任何情況下都無法被報告：

<UL>LI 屬性值<中的一般實體/LI><LI>參數實體在宣告/<LI<>/UL 中><>

這些區域將被悄悄擴展，且不會顯示原始實體邊界的位置。

另外要注意的是，角色參考的邊界（其實也不是實體）並不會被報告。

所有 start/endEntity 事件都必須妥善巢狀。

的 org.xml.sax.ext.LexicalHandler.startEntity(java.lang.String)Java 檔。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

另請參閱

  • EndEntity(String)
  • <xref:Org.Xml.Sax.Ext.IDeclHandler.InternalEntityDecl(System.String%2c+System.String)>
  • <xref:Org.Xml.Sax.Ext.IDeclHandler.ExternalEntityDecl(System.String%2c+System.String%2c+System.String)>