KeyPairGenerator 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
KeyPairGenerator 類別用於產生公鍵與私鑰對。
[Android.Runtime.Register("java/security/KeyPairGenerator", DoNotGenerateAcw=true)]
public abstract class KeyPairGenerator : Java.Security.KeyPairGeneratorSpi[<Android.Runtime.Register("java/security/KeyPairGenerator", DoNotGenerateAcw=true)>]
type KeyPairGenerator = class
inherit KeyPairGeneratorSpi- 繼承
- 屬性
備註
KeyPairGenerator 類別用於產生公鍵與私鑰對。 金鑰對產生器是利用 getInstance 工廠方法（靜態方法，回傳特定類別的實例）來構建。
特定演算法的金鑰對產生器會產生一對公私鑰，可用於該演算法。 它也會將演算法特定的參數與每個產生的鍵鍵關聯起來。
產生金鑰對有兩種方式：一種是演算法獨立的方式，另一種是演算法特定方式。 兩者唯一的差別在於物件的初始化：
<ul><li><b>Algorithm-Independent 初始化</b>
所有金鑰對產生器都共享密鑰大小與隨機來源的概念。 不同演算法對鍵大小的解釋不同（例如， 在 DSA 演算法中，鍵大小對應於模數的長度）。 在這個 KeyPairGenerator 類別中有一個 #initialize(int, java.security.SecureRandom) initialize 方法，可以接受這兩種普遍共享的參數類型。 還有一種方法只 keysize 用參數，並以 SecureRandom 最高優先順序的安裝提供者作為隨機性的來源。 （若安裝的供應商均未提供 的實作 SecureRandom，則使用系統提供的隨機性來源。）
由於呼叫上述演算法無關 initialize 方法時未指定其他參數，提供者如何處理每個鍵所關聯的演算法特定參數（若有）由提供者決定。
若演算法為 DSA 演算法，且鍵大小（模大小）為 512、768、1024 或 2048，則 Sun 提供者會使用一組預先計算的 p、 q、 g 及參數值。 若模數大小不符合上述數值， Sun 提供者會建立一組新的參數。 其他供應商可能已預先計算出超出上述模數大小的參數集。 還有些系統可能根本沒有預先計算的參數清單，而是總是建立新的參數集。
<li><b>Algorithm-Specific 初始化</b>
對於已經存在一組演算法專屬參數的情況（例如DSA中所謂 的社群參數 ），有兩種 #initialize(java.security.spec.AlgorithmParameterSpec) initialize 方法具有參數 AlgorithmParameterSpec 。 一方也有論 SecureRandom 點，另一方則以 SecureRandom 最高優先順序安裝的提供者作為隨機性的來源。 （若安裝的供應商均未提供 的實作 SecureRandom，則使用系統提供的隨機性來源。） </ul>
若用戶端未透過呼叫 initialize 方法明確初始化 KeyPairGenerator，每個提供者必須提供（並記錄）預設初始化。 例如， Sun 提供者使用的預設模大小（金鑰大小）為 1024 位元。
請注意，這個類別是抽象的，且是出於歷史原因從 擴展出來 KeyPairGeneratorSpi 的。 應用程式開發者只需注意此 KeyPairGenerator 類別中定義的方法;超類別中的所有方法皆為希望提供自有金鑰對產生器實作的密碼學服務提供者設計。
Android 提供以下KeyPairGenerator演算法：<table><thead><tr><th>演算法</th><>支援的 API 等級/<th></tr></thead><tbody><tr><td>DH</td td><>1+</td></tr><tr><td>DSA</td td><>1+</td></tr><tr td td><>EC</td><TD 11+>/TD<>/TR<>TR<>TD<RSA>/td<>TD<1+>/td<>/tr<>tr<>TD<XDH>/td<>td<33+>/td<>/tr/tbody<><>/表格<>
這些演算法在 Java 密碼學架構標準演算法名稱文件中的 KeyPairGenerator 章節中有詳細說明。
在 1.1 版本中加入。
Java 文件 java.security.KeyPairGenerator。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| KeyPairGenerator(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
| KeyPairGenerator(String) |
為指定的演算法建立一個 KeyPairGenerator 物件。 |
屬性
| 名稱 | Description |
|---|---|
| Algorithm |
回傳此金鑰對產生器演算法的標準名稱。 |
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| JniPeerMembers |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| Provider |
回傳此金鑰對產生物件的提供者。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| Equals(Object) |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GenerateKeyPair() |
產生一對金鑰對。 |
| GenKeyPair() |
產生一對金鑰對。 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetInstance(String, Provider) |
回傳一個 KeyPairGenerator 物件，為指定演算法產生公私鑰對。 |
| GetInstance(String, String) |
回傳一個 KeyPairGenerator 物件，為指定演算法產生公私鑰對。 |
| GetInstance(String) |
回傳一個 KeyPairGenerator 物件，為指定演算法產生公私鑰對。 |
| Initialize(IAlgorithmParameterSpec, SecureRandom) |
利用指定的參數集及使用者提供的隨機來源初始化金鑰對產生器。 (繼承來源 KeyPairGeneratorSpi) |
| Initialize(IAlgorithmParameterSpec) |
使用指定的參數集初始化金鑰對產生器，並以 |
| Initialize(Int32, SecureRandom) |
以特定鍵大小初始化金鑰對產生器，並以隨機來源（及預設參數集）為基礎。 |
| Initialize(Int32) |
使用預設參數集及 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
KeyPairGenerator 類別用於產生公鍵與私鑰對。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |