Runtime.LoadLibrary(String) Méthode

Référence

Définition

Espace de noms:: Java.Lang

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Charge la bibliothèque native spécifiée par l’argument libname .

[Android.Runtime.Register("loadLibrary", "(Ljava/lang/String;)V", "GetLoadLibrary_Ljava_lang_String_Handler")]
public virtual void LoadLibrary(string? libname);

[<Android.Runtime.Register("loadLibrary", "(Ljava/lang/String;)V", "GetLoadLibrary_Ljava_lang_String_Handler")>]
abstract member LoadLibrary : string -> unit
override this.LoadLibrary : string -> unit

Paramètres

libname: String

nom de la bibliothèque.

Attributs: RegisterAttribute

Exceptions

UnsatisfiedLinkError

si la bibliothèque ne peut pas être chargée, soit parce qu’elle est introuvable, soit parce qu’il y a quelque chose de mal avec elle.

Remarques

Charge la bibliothèque native spécifiée par l’argument libname . L’argument libname ne doit contenir aucun préfixe spécifique à la plateforme, l’extension de fichier ou le chemin d’accès. Si une bibliothèque native appelée libname est liée statiquement à la machine virtuelle, la fonction JNI_OnLoad_libname exportée par la bibliothèque est appelée. Pour plus d’informations, consultez la spécification JNI.

Sinon, l’argument libname est chargé à partir d’un emplacement de bibliothèque système et mappé à une image de bibliothèque native de manière dépendante de l’implémentation.

Tout d’abord, s’il existe un gestionnaire de sécurité, sa checkLink méthode est appelée avec l’argument libname comme argument. Cela peut entraîner une exception de sécurité.

La méthode System#loadLibrary(String) est le moyen conventionnel et pratique d’appeler cette méthode. Si les méthodes natives doivent être utilisées dans l’implémentation d’une classe, une stratégie standard consiste à placer le code natif dans un fichier de bibliothèque (l’appeler LibFile) puis à placer un initialiseur statique : <blockquote>

static { System.loadLibrary("LibFile"); }

</blockquote> dans la déclaration de classe. Lorsque la classe est chargée et initialisée, l’implémentation de code native nécessaire pour les méthodes natives sera ensuite chargée.

Si cette méthode est appelée plusieurs fois avec le même nom de bibliothèque, les deuxième et les appels suivants sont ignorés.

Documentation Java pour java.lang.Runtime.loadLibrary(java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

Partager via