Cipher.Init 方法

定義

命名空間:

Javax.Crypto

組件:

Mono.Android.dll

多載

Init(CipherMode, IKey, IAlgorithmParameterSpec, SecureRandom)	使用索引鍵、一組演算法參數和隨機來源，初始化此加密。
Init(CipherMode, IKey, AlgorithmParameters, SecureRandom)	使用索引鍵、一組演算法參數和隨機來源，初始化此加密。
Init(CipherMode, IKey, IAlgorithmParameterSpec)	使用金鑰和一組演演算法參數，初始化此加密。
Init(CipherMode, IKey, SecureRandom)	使用索引鍵和隨機來源，初始化此加密。
Init(CipherMode, IKey, AlgorithmParameters)	使用金鑰和一組演演算法參數，初始化此加密。
Init(CipherMode, Certificate, SecureRandom)	使用來自指定憑證的公鑰和隨機來源，初始化此加密。
Init(CipherMode, IKey)	使用金鑰初始化此加密。
Init(CipherMode, Certificate)	使用來自指定憑證的公鑰，初始化此加密。

Init(CipherMode, IKey, IAlgorithmParameterSpec, SecureRandom)

使用索引鍵、一組演算法參數和隨機來源，初始化此加密。

[Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/spec/AlgorithmParameterSpec;Ljava/security/SecureRandom;)V", "")]
public void Init (Javax.Crypto.CipherMode opmode, Java.Security.IKey? key, Java.Security.Spec.IAlgorithmParameterSpec? params, Java.Security.SecureRandom? random);

[<Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/spec/AlgorithmParameterSpec;Ljava/security/SecureRandom;)V", "")>]
member this.Init : Javax.Crypto.CipherMode * Java.Security.IKey * Java.Security.Spec.IAlgorithmParameterSpec * Java.Security.SecureRandom -> unit

參數

opmode

CipherMode

此加密的作業模式 （這是下列其中一項：ENCRYPT_MODE、 DECRYPT_MODEWRAP_MODE 或 UNWRAP_MODE）

key

IKey

加密金鑰

params

IAlgorithmParameterSpec

演算法參數

random

SecureRandom

隨機性的來源

屬性

RegisterAttribute

例外狀況

InvalidKeyException

如果指定的索引鍵無法用來初始化這個加密實體，則為 。

InvalidAlgorithmParameterException

它指定的參數不適合此加密。

InvalidParameterException

如果指定的 opmode 無效，則為 。

備註

使用索引鍵、一組演算法參數和隨機來源，初始化此加密。

加密會針對下列四個作業之一進行初始化：加密、解密、密鑰包裝或金鑰解除包裝，視的值 opmode而定。

如果此加密需要任何演算法參數且 params 為 null，則基礎加密實作應該會在加密或金鑰包裝初始化時產生必要的參數本身（使用提供者特定的預設值或隨機值），並在初始化解密或金鑰解除包裝時引發 InvalidAlgorithmParameterException 。 產生的參數可以使用 或 #getIV() getIV 來擷#getParameters() getParameters取 （如果參數為IV）。

如果此加密需要無法衍生自輸入參數的演算法參數，而且沒有合理的提供者特定預設值，初始化一定會失敗。

如果此加密（包括其基礎意見反應或填補配置）需要任何隨機位元組（例如，用於參數產生），則會從 random取得它們。

請注意，初始化 Cipher 物件時，它會遺失所有先前取得的狀態。 換句話說，初始化 Cipher 相當於建立該加密的新實例，並將其初始化。

的 javax.crypto.Cipher.init(int, java.security.Key, java.security.spec.AlgorithmParameterSpec, java.security.SecureRandom)Java 檔。

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

Init(CipherMode, IKey, AlgorithmParameters, SecureRandom)

使用索引鍵、一組演算法參數和隨機來源，初始化此加密。

[Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/AlgorithmParameters;Ljava/security/SecureRandom;)V", "")]
public void Init (Javax.Crypto.CipherMode opmode, Java.Security.IKey? key, Java.Security.AlgorithmParameters? params, Java.Security.SecureRandom? random);

[<Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/AlgorithmParameters;Ljava/security/SecureRandom;)V", "")>]
member this.Init : Javax.Crypto.CipherMode * Java.Security.IKey * Java.Security.AlgorithmParameters * Java.Security.SecureRandom -> unit

參數

opmode

CipherMode

此加密的作業模式 （這是下列其中一項：ENCRYPT_MODE、 DECRYPT_MODEWRAP_MODE 或 UNWRAP_MODE）

key

IKey

加密金鑰

params

AlgorithmParameters

演算法參數

random

SecureRandom

隨機性的來源

屬性

RegisterAttribute

例外狀況

InvalidKeyException

如果指定的索引鍵無法用來初始化這個加密實體，則為 。

InvalidAlgorithmParameterException

如果指定的參數不適合此加密， 則為 。

InvalidParameterException

如果指定的 opmode 無效，則為 。

備註

使用索引鍵、一組演算法參數和隨機來源，初始化此加密。

加密會針對下列四個作業之一進行初始化：加密、解密、密鑰包裝或金鑰解除包裝，視的值 opmode而定。

如果此加密需要任何演算法參數且 params 為 null，則基礎加密實作應該會在加密或金鑰包裝初始化時產生必要的參數本身（使用提供者特定的預設值或隨機值），並在初始化解密或金鑰解除包裝時引發 InvalidAlgorithmParameterException 。 產生的參數可以使用 或 #getIV() getIV 來擷#getParameters() getParameters取 （如果參數為IV）。

如果此加密需要無法衍生自輸入參數的演算法參數，而且沒有合理的提供者特定預設值，初始化一定會失敗。

如果此加密（包括其基礎意見反應或填補配置）需要任何隨機位元組（例如，用於參數產生），則會從 random取得它們。

請注意，初始化 Cipher 物件時，它會遺失所有先前取得的狀態。 換句話說，初始化 Cipher 相當於建立該加密的新實例，並將其初始化。

的 javax.crypto.Cipher.init(int, java.security.Key, java.security.AlgorithmParameters, java.security.SecureRandom)Java 檔。

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

Init(CipherMode, IKey, IAlgorithmParameterSpec)

使用金鑰和一組演演算法參數，初始化此加密。

[Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/spec/AlgorithmParameterSpec;)V", "")]
public void Init (Javax.Crypto.CipherMode opmode, Java.Security.IKey? key, Java.Security.Spec.IAlgorithmParameterSpec? params);

[<Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/spec/AlgorithmParameterSpec;)V", "")>]
member this.Init : Javax.Crypto.CipherMode * Java.Security.IKey * Java.Security.Spec.IAlgorithmParameterSpec -> unit

參數

opmode

CipherMode

此加密的作業模式 （這是下列其中一項：ENCRYPT_MODE、 DECRYPT_MODEWRAP_MODE 或 UNWRAP_MODE）

key

IKey

加密金鑰

params

IAlgorithmParameterSpec

演算法參數

屬性

RegisterAttribute

例外狀況

InvalidKeyException

如果指定的索引鍵無法用來初始化這個加密實體，則為 。

InvalidAlgorithmParameterException

它指定的參數不適合此加密。

備註

使用金鑰和一組演演算法參數，初始化此加密。

加密會針對下列四個作業之一進行初始化：加密、解密、密鑰包裝或金鑰解除包裝，視的值 opmode而定。

如果此加密需要任何演算法參數且 params 為 null，則基礎加密實作應該會在加密或金鑰包裝初始化時產生必要的參數本身（使用提供者特定的預設值或隨機值），並在初始化解密或金鑰解除包裝時引發 InvalidAlgorithmParameterException 。 產生的參數可以使用 或 #getIV() getIV 來擷#getParameters() getParameters取 （如果參數為IV）。

如果此加密需要無法衍生自輸入參數的演算法參數，而且沒有合理的提供者特定預設值，初始化一定會失敗。

如果此加密（包括其基礎意見反應或填補配置）需要任何隨機位元組（例如，用於參數產生），則會使用 java.security.SecureRandom 安裝最高優先順序提供者的實作作為隨機性來源來取得它們。 （如果沒有已安裝的提供者提供 SecureRandom 的實作，則會使用系統提供的隨機來源。

請注意，初始化 Cipher 物件時，它會遺失所有先前取得的狀態。 換句話說，初始化 Cipher 相當於建立該加密的新實例，並將其初始化。

的 javax.crypto.Cipher.init(int, java.security.Key, java.security.spec.AlgorithmParameterSpec)Java 檔。

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

Init(CipherMode, IKey, SecureRandom)

使用索引鍵和隨機來源，初始化此加密。

[Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/SecureRandom;)V", "")]
public void Init (Javax.Crypto.CipherMode opmode, Java.Security.IKey? key, Java.Security.SecureRandom? random);

[<Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/SecureRandom;)V", "")>]
member this.Init : Javax.Crypto.CipherMode * Java.Security.IKey * Java.Security.SecureRandom -> unit

參數

opmode

CipherMode

此加密的作業模式 （這是下列其中一項：ENCRYPT_MODE、 DECRYPT_MODEWRAP_MODE 或 UNWRAP_MODE）

key

IKey

加密金鑰

random

SecureRandom

隨機性的來源

屬性

RegisterAttribute

例外狀況

InvalidKeyException

如果指定的索引鍵無法用來初始化這個加密實體，則為 。

InvalidParameterException

如果指定的 opmode 無效，則為 。

備註

使用索引鍵和隨機來源，初始化此加密。

加密會針對下列四個作業之一進行初始化：加密、解密、密鑰包裝或金鑰解除包裝，視的值 opmode而定。

如果此加密需要任何無法衍生自指定 key之演算法參數，則基礎加密實作應該在加密或金鑰包裝初始化時產生必要的參數本身（使用提供者特定的預設值或隨機值），並在初始化解密或金鑰解除包裝時引發 InvalidKeyException 。 產生的參數可以使用 或 #getIV() getIV 來擷#getParameters() getParameters取 （如果參數為IV）。

如果此加密需要無法衍生自輸入參數的演算法參數，而且沒有合理的提供者特定預設值，初始化一定會失敗。

如果此加密（包括其基礎意見反應或填補配置）需要任何隨機位元組（例如，用於參數產生），則會從 random取得它們。

請注意，初始化 Cipher 物件時，它會遺失所有先前取得的狀態。 換句話說，初始化 Cipher 相當於建立該加密的新實例，並將其初始化。

的 javax.crypto.Cipher.init(int, java.security.Key, java.security.SecureRandom)Java 檔。

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

Init(CipherMode, IKey, AlgorithmParameters)

使用金鑰和一組演演算法參數，初始化此加密。

[Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/AlgorithmParameters;)V", "")]
public void Init (Javax.Crypto.CipherMode opmode, Java.Security.IKey? key, Java.Security.AlgorithmParameters? params);

[<Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/AlgorithmParameters;)V", "")>]
member this.Init : Javax.Crypto.CipherMode * Java.Security.IKey * Java.Security.AlgorithmParameters -> unit

參數

opmode

CipherMode

此加密的作業模式 （這是下列其中一項：ENCRYPT_MODE、 DECRYPT_MODEWRAP_MODE 或 UNWRAP_MODE）

key

IKey

加密金鑰

params

AlgorithmParameters

演算法參數

屬性

RegisterAttribute

例外狀況

InvalidKeyException

如果指定的索引鍵無法用來初始化這個加密實體，則為 。

InvalidAlgorithmParameterException

它指定的參數不適合此加密。

備註

使用金鑰和一組演演算法參數，初始化此加密。

加密會針對下列四個作業之一進行初始化：加密、解密、密鑰包裝或金鑰解除包裝，視的值 opmode而定。

如果此加密需要任何演算法參數且 params 為 null，則基礎加密實作應該會在加密或金鑰包裝初始化時產生必要的參數本身（使用提供者特定的預設值或隨機值），並在初始化解密或金鑰解除包裝時引發 InvalidAlgorithmParameterException 。 產生的參數可以使用 或 #getIV() getIV 來擷#getParameters() getParameters取 （如果參數為IV）。

如果此加密需要無法衍生自輸入參數的演算法參數，而且沒有合理的提供者特定預設值，初始化一定會失敗。

如果此加密（包括其基礎意見反應或填補配置）需要任何隨機位元組（例如，用於參數產生），則會使用 java.security.SecureRandom 安裝最高優先順序提供者的實作作為隨機性來源來取得它們。 （如果沒有已安裝的提供者提供 SecureRandom 的實作，則會使用系統提供的隨機來源。

請注意，初始化 Cipher 物件時，它會遺失所有先前取得的狀態。 換句話說，初始化 Cipher 相當於建立該加密的新實例，並將其初始化。

的 javax.crypto.Cipher.init(int, java.security.Key, java.security.AlgorithmParameters)Java 檔。

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

Init(CipherMode, Certificate, SecureRandom)

使用來自指定憑證的公鑰和隨機來源，初始化此加密。

[Android.Runtime.Register("init", "(ILjava/security/cert/Certificate;Ljava/security/SecureRandom;)V", "")]
public void Init (Javax.Crypto.CipherMode opmode, Java.Security.Cert.Certificate? certificate, Java.Security.SecureRandom? random);

[<Android.Runtime.Register("init", "(ILjava/security/cert/Certificate;Ljava/security/SecureRandom;)V", "")>]
member this.Init : Javax.Crypto.CipherMode * Java.Security.Cert.Certificate * Java.Security.SecureRandom -> unit

參數

opmode

CipherMode

此加密的作業模式 （這是下列其中一項：ENCRYPT_MODE、 DECRYPT_MODEWRAP_MODE 或 UNWRAP_MODE）

certificate

Certificate

憑證

random

SecureRandom

隨機性的來源

屬性

RegisterAttribute

例外狀況

InvalidKeyException

如果憑證中的公鑰無法用來初始化此加密實體，則為 。

備註

使用來自指定憑證的公鑰和隨機來源，初始化此加密。

加密會針對下列四個作業之一進行初始化：加密、解密、密鑰包裝或金鑰解除包裝，視的值 opmode而定。

如果憑證的類型為 X.509，且金鑰使用延伸模組欄位標示為重要，且金鑰使用延伸模組欄位的值表示憑證及其對應的私鑰不應該用於 的值所表示opmode的作業，InvalidKeyException則會擲回 。

如果此加密需要任何無法衍生自指定 certificate中公鑰的演演算法參數，則基礎加密實作應該會在初始化加密或金鑰包裝時產生必要的參數本身（使用提供者特定的預設值或隨機值），並在初始化解密或金鑰解除包裝時引發 InvalidKeyException 。 產生的參數可以使用 或 #getIV() getIV 來擷#getParameters() getParameters取 （如果參數為IV）。

如果此加密需要無法衍生自輸入參數的演算法參數，而且沒有合理的提供者特定預設值，初始化一定會失敗。

如果此加密（包括其基礎意見反應或填補配置）需要任何隨機位元組（例如，用於參數產生），則會從 random取得它們。

請注意，初始化 Cipher 物件時，它會遺失所有先前取得的狀態。 換句話說，初始化 Cipher 相當於建立該加密的新實例，並將其初始化。

的 javax.crypto.Cipher.init(int, java.security.cert.Certificate, java.security.SecureRandom)Java 檔。

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

Init(CipherMode, IKey)

使用金鑰初始化此加密。

[Android.Runtime.Register("init", "(ILjava/security/Key;)V", "")]
public void Init (Javax.Crypto.CipherMode opmode, Java.Security.IKey? key);

[<Android.Runtime.Register("init", "(ILjava/security/Key;)V", "")>]
member this.Init : Javax.Crypto.CipherMode * Java.Security.IKey -> unit

參數

opmode

CipherMode

此加密的作業模式 （這是下列其中一項：ENCRYPT_MODE、 DECRYPT_MODEWRAP_MODE 或 UNWRAP_MODE）

key

IKey

金鑰

屬性

RegisterAttribute

例外狀況

InvalidKeyException

如果指定的索引鍵無法用來初始化這個加密實體，則為 。

備註

使用金鑰初始化此加密。

加密會針對下列四個作業之一進行初始化：加密、解密、密鑰包裝或金鑰解除包裝，視的值 opmode而定。

如果此加密需要任何無法衍生自指定 key之演算法參數，則基礎加密實作應該在加密或金鑰包裝初始化時產生必要的參數本身（使用提供者特定的預設值或隨機值），並在初始化解密或金鑰解除包裝時引發 InvalidKeyException 。 產生的參數可以使用 或 #getIV() getIV 來擷#getParameters() getParameters取 （如果參數為IV）。

如果此加密需要無法衍生自輸入參數的演算法參數，而且沒有合理的提供者特定預設值，初始化一定會失敗。

如果此加密（包括其基礎意見反應或填補配置）需要任何隨機位元組（例如，用於參數產生），則會使用 java.security.SecureRandom 安裝最高優先順序提供者的實作作為隨機性來源來取得它們。 （如果沒有已安裝的提供者提供 SecureRandom 的實作，則會使用系統提供的隨機來源。

請注意，初始化 Cipher 物件時，它會遺失所有先前取得的狀態。 換句話說，初始化 Cipher 相當於建立該加密的新實例，並將其初始化。

的 javax.crypto.Cipher.init(int, java.security.Key)Java 檔。

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

Init(CipherMode, Certificate)

使用來自指定憑證的公鑰，初始化此加密。

[Android.Runtime.Register("init", "(ILjava/security/cert/Certificate;)V", "")]
public void Init (Javax.Crypto.CipherMode opmode, Java.Security.Cert.Certificate? certificate);

[<Android.Runtime.Register("init", "(ILjava/security/cert/Certificate;)V", "")>]
member this.Init : Javax.Crypto.CipherMode * Java.Security.Cert.Certificate -> unit

參數

opmode

CipherMode

此加密的作業模式 （這是下列其中一項：ENCRYPT_MODE、 DECRYPT_MODEWRAP_MODE 或 UNWRAP_MODE）

certificate

Certificate

憑證

屬性

RegisterAttribute

例外狀況

InvalidKeyException

如果憑證中的公鑰無法用來初始化此加密實體，則為 。

備註

使用來自指定憑證的公鑰，初始化此加密。

加密會針對下列四個作業之一進行初始化：加密、解密、密鑰包裝或金鑰解除包裝，視的值 opmode而定。

如果憑證的類型為 X.509，且金鑰使用延伸模組欄位標示為重要，且金鑰使用延伸模組欄位的值表示憑證及其對應的私鑰不應該用於 的值所表示opmode的作業，InvalidKeyException則會擲回 。

如果此加密需要任何無法衍生自指定憑證中公鑰的演演算法參數，基礎加密實作應該會產生必要的參數本身（使用提供者特定的預設值或隨機值），如果是初始化加密或密鑰包裝，則引發 InvalidKeyException ，如果它正在初始化以進行解密或密鑰解除包裝。 產生的參數可以使用 或 #getIV() getIV 來擷#getParameters() getParameters取 （如果參數為IV）。

如果此加密需要無法衍生自輸入參數的演算法參數，而且沒有合理的提供者特定預設值，初始化一定會失敗。

如果此加密（包括其基礎意見反應或填補配置）需要任何隨機位元組（例如，用於參數產生），則會使用 SecureRandom 安裝最高優先順序提供者的實作作為隨機性來源來取得它們。 （如果沒有已安裝的提供者提供 SecureRandom 的實作，則會使用系統提供的隨機來源。

請注意，初始化 Cipher 物件時，它會遺失所有先前取得的狀態。 換句話說，初始化 Cipher 相當於建立該加密的新實例，並將其初始化。

的 javax.crypto.Cipher.init(int, java.security.cert.Certificate)Java 檔。

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