Android Guides | Samples

Javax.Crypto.Cipher.Init Method

Initializes this cipher instance with the specified key and a source of randomness.

Syntax

[Android.Runtime.Register("init", "(ILjava/security/Key;Ljava/security/SecureRandom;)V", "")]
public Void Init ([Android.Runtime.GeneratedEnum] CipherMode opmode, IKey key, SecureRandom random)

Parameters

opmode
the operation this cipher instance should be initialized for (one of: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE or UNWRAP_MODE).
key
the input key for the operation.
random
the source of randomness to use.

Exceptions

TypeReason
InvalidKeyExceptionif the specified key can not be used to initialize this cipher instance.
InvalidParameterExceptionif the specified opmode is invalid.

Remarks

Initializes this cipher instance with the specified key and a source of randomness.

The cipher is initialized for the specified operational mode (one of: encryption, decryption, key wrapping or key unwrapping) depending on opmode.

If this cipher instance needs any algorithm parameters or random values that the specified key can not provide, the underlying implementation of this cipher is supposed to generate the required parameters (using its provider or random values). Random values are generated using random;

When a cipher instance is initialized by a call to any of the init methods, the state of the instance is overridden, means it is equivalent to creating a new instance and calling it init method.

[Android Documentation]

Requirements

Namespace: Javax.Crypto
Assembly: Mono.Android (in Mono.Android.dll)
Assembly Versions: 0.0.0.0
Since: Added in API level 1