Activity.RequestPermissions Méthode

Définition

Espace de noms:: Android.App

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.

Surcharges

Nom	Description
RequestPermissions(String[], Int32)	Demande des autorisations à accorder à cette application.
RequestPermissions(String[], Int32, Int32)	Demande des autorisations à accorder à cette application.

RequestPermissions(String[], Int32)

Demande des autorisations à accorder à cette application.

[Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;I)V", "", ApiSince=23)]
public void RequestPermissions(string[] permissions, int requestCode);

[<Android.Runtime.Register("requestPermissions", "([Ljava/lang/String;I)V", "", ApiSince=23)>]
member this.RequestPermissions : string[] * int -> unit

Paramètres

permissions: String[]

Autorisations demandées. Doit être non null et non vide.

requestCode: Int32

Code de requête spécifique de l’application à mettre en correspondance avec un résultat signalé à #onRequestPermissionsResult. Doit être >= 0.

Attributs: RegisterAttribute

Remarques

Demande des autorisations à accorder à cette application. Ces autorisations doivent être demandées dans votre manifeste, elles ne doivent pas être accordées à votre application et doivent avoir un niveau de protection dangereux, qu’elles soient déclarées par la plateforme ou par une application tierce. Les autorisations normales PermissionInfo.PROTECTION_NORMAL sont accordées au moment de l’installation si elles sont demandées dans le manifeste. Les autorisations de signature PermissionInfo.PROTECTION_SIGNATURE sont accordées au moment de l’installation si elles sont demandées dans le manifeste et que la signature de votre application correspond à la signature de l’application déclarant les autorisations.

Appel de shouldShowRequestPermissionRationale(String) avant d’appeler cette API pour vérifier si le système recommande d’afficher une interface utilisateur logique avant de demander une autorisation.

Si votre application n’a pas les autorisations demandées, l’utilisateur reçoit l’interface utilisateur pour l’accepter. Une fois que l’utilisateur a accepté ou rejeté les autorisations demandées, vous recevrez un rappel sur onRequestPermissionsResult(int, String, int) indiquant si les autorisations ont été accordées ou non.

Notez que la demande d’autorisation ne garantit pas qu’elle sera accordée et que votre application doit pouvoir s’exécuter sans avoir cette autorisation.

Cette méthode peut démarrer une activité permettant à l’utilisateur de choisir les autorisations à accorder et celles à rejeter. Par conséquent, vous devez être préparé à ce que votre activité puisse être suspendue et reprise. En outre, l’octroi d’autorisations peut nécessiter un redémarrage de votre application. Dans ce cas, le système recréera la pile d’activités avant de remettre le résultat à onRequestPermissionsResult(int, String, int).

Lorsque vous vérifiez si vous disposez d’une autorisation, vous devez utiliser checkSelfPermission(String).

Vous ne pouvez pas demander une autorisation si votre activité définit noHistory sur true, car dans ce cas, l’activité ne recevrait pas de rappels de résultats, notamment onRequestPermissionsResult(int, String, int).

Les exemples d’autorisations montrent comment utiliser cette méthode pour demander des autorisations au moment de l’exécution.

Voir aussi :

Throws : IllegalArgumentException si requestCode est négatif.

Référence Android pour android.app.Activity.requestPermissions.

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

S’applique à

RequestPermissions(String[], Int32, Int32)