XPathFactory.NewInstance 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| NewInstance() |
使用預設物件模型 |
| NewInstance(String) |
使用指定的物件模型取得新的 |
| NewInstance(String, String, ClassLoader) |
使用預設物件模型 <、W3C DOM 取得新的>程式碼<XPathFactory>/code |
NewInstance()
使用預設物件模型XPathFactory、W3C DOM 取得新的#DEFAULT_OBJECT_MODEL_URI實例。
[Android.Runtime.Register("newInstance", "()Ljavax/xml/xpath/XPathFactory;", "")]
public static Javax.Xml.Xpath.XPathFactory? NewInstance();[<Android.Runtime.Register("newInstance", "()Ljavax/xml/xpath/XPathFactory;", "")>]
static member NewInstance : unit -> Javax.Xml.Xpath.XPathFactory傳回
的 XPathFactory實例。
- 屬性
備註
使用預設物件模型XPathFactory、W3C DOM 取得新的#DEFAULT_OBJECT_MODEL_URI實例。
此方法在功能上相當於：
newInstance(DEFAULT_OBJECT_MODEL_URI)
由於 W3C DOM 的實作一律可供使用，因此此方法永遠不會失敗。
的 javax.xml.xpath.XPathFactory.newInstance()Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
NewInstance(String)
使用指定的物件模型取得新的 XPathFactory 實例。
[Android.Runtime.Register("newInstance", "(Ljava/lang/String;)Ljavax/xml/xpath/XPathFactory;", "")]
public static Javax.Xml.Xpath.XPathFactory? NewInstance(string? uri);[<Android.Runtime.Register("newInstance", "(Ljava/lang/String;)Ljavax/xml/xpath/XPathFactory;", "")>]
static member NewInstance : string -> Javax.Xml.Xpath.XPathFactory參數
- uri
- String
識別基礎物件模型。
此規格只會定義 W3C DOM、org.w3c.dom 套件的 URI#DEFAULT_OBJECT_MODEL_URIhttp://java.sun.com/jaxp/xpath/dom，而實作則免費導入其他物件模型的其他 URI。
傳回
的 XPathFactory實例。
- 屬性
例外狀況
如果指定的物件模型無法使用。
如果 uri 為 null。
如果 uri.length() == 0.
備註
使用指定的物件模型取得新的 XPathFactory 實例。
若要尋找 XPathFactory 物件，此方法會以下列順序尋找下列位置，其中 「class loader」 是指內容類別載入器：
<ol><li> 如果系統屬性 #DEFAULT_PROPERTY_NAME + “：uri” 存在，其中 uri 是這個方法的參數，則其值會讀取為類別名稱。 方法會嘗試使用類別載入器建立這個類別的新實例，並在成功建立時傳回它。
</li li><> ${java.home}/lib/jaxp.properties 已讀取，而且會尋找與上述系統屬性索引鍵相關聯的值。 如果存在，則會像上述一樣處理值。
</li：><>系統會要求類別載入器在資源目錄 META-INF/services 中比javax.xml.xpath.XPathFactory對服務提供者組態檔。 如需檔案格式和剖析規則，請參閱 JAR 檔案規格。 每個潛在的服務提供者都需要實作 方法：
{@link #isObjectModelSupported(String objectModel)}
傳回支援指定物件模型之類別載入器順序中的第一個服務提供者。
</li li><> Platform default XPathFactory 是以平臺特定方式找到。 W3C DOM 必須有平台預設的 XPathFactory，也就是 #DEFAULT_OBJECT_MODEL_URI。 </li></ol>
如果一切失敗， XPathFactoryConfigurationException 會擲回 。
發生問題的小費：
如需剖析屬性檔的確切方式，請參閱 java.util.Properties#load(java.io.InputStream) 。 特別是，必須在屬性檔中逸出冒號 『：』，因此請確定 URI 已正確逸出。 例如：
http\://java.sun.com/jaxp/xpath/dom=org.acme.DomXPathFactory
的 javax.xml.xpath.XPathFactory.newInstance(java.lang.String)Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
適用於
NewInstance(String, String, ClassLoader)
使用預設物件模型 <、W3C DOM 取得新的>程式碼<XPathFactory>/code#DEFAULT_OBJECT_MODEL_URI 實例。
[Android.Runtime.Register("newInstance", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/ClassLoader;)Ljavax/xml/xpath/XPathFactory;", "")]
public static Javax.Xml.Xpath.XPathFactory? NewInstance(string? uri, string? factoryClassName, Java.Lang.ClassLoader? classLoader);[<Android.Runtime.Register("newInstance", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/ClassLoader;)Ljavax/xml/xpath/XPathFactory;", "")>]
static member NewInstance : string * string * Java.Lang.ClassLoader -> Javax.Xml.Xpath.XPathFactory參數
- uri
- String
識別基礎物件模型。 規範僅定義 URI DEFAULT_OBJECT_MODEL_URI、http://java.sun.com/jaxp/xpath/dom 用於 W3C DOM 的 org.w3c.dom 套件，且實作可自由引入其他物件模型的 URI。
- factoryClassName
- String
完整合格的工廠類別名稱，提供 javax.xml.xpath 的實作。XPathFactory。
- classLoader
- ClassLoader
ClassLoader 過去用來載入工廠類別。 如果為空，目前執行緒的 context classLoader 會用來載入工廠類別。
傳回
的 XPathFactory實例。
- 屬性
例外狀況
如果指定的物件模型無法使用。
如果 uri 為 null。
如果 uri.length() == 0.
備註
從工廠類別名稱取得一個新的 XPathFactory 實例。 如果指定工廠類別支援指定的物件模型，則會回傳 XPathFactory。 當類別路徑中有多個提供者時，此函式非常有用。 它讓應用程式能控制更多，因為可以指定應該載入哪個提供者。 故障排除小技巧：設定 jaxp.debug system 屬性會讓這個方法向 System.err 印出大量除錯訊息，說明它正在做什麼以及在哪裡觀察。 如果你遇到困難，可以試試：
Java 參考 javax.xml.xpath.XPathFactory.newInstance。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。