RestrictionsManager Classe
Définition
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.
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur.
[Android.Runtime.Register("android/content/RestrictionsManager", DoNotGenerateAcw=true)]
public class RestrictionsManager : Java.Lang.Object
[<Android.Runtime.Register("android/content/RestrictionsManager", DoNotGenerateAcw=true)>]
type RestrictionsManager = class
inherit Object
- Héritage
- Attributs
Remarques
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. Les applications peuvent également envoyer des demandes d’autorisation à un administrateur d’appareil local ou distant pour remplacer les restrictions spécifiques à l’application par défaut ou toute autre opération nécessitant une autorisation explicite de l’administrateur.
Les applications peuvent exposer un ensemble de restrictions via un fichier XML spécifié dans le manifeste.
Si l’utilisateur dispose d’un fournisseur de restrictions actif, les requêtes dynamiques peuvent être effectuées en plus des restrictions imposées statiquement. Les requêtes dynamiques sont spécifiques à l’application et peuvent être exprimées via un ensemble prédéfini de types de requêtes.
RestrictionsManager transfère les requêtes dynamiques au fournisseur de restrictions actif. Le fournisseur de restrictions peut répondre aux demandes en appelant #notifyPermissionResponse(String, PersistableBundle), lorsqu’une réponse est reçue de l’administrateur de l’appareil ou de l’utilisateur. La réponse est relayée vers l’application via une diffusion protégée. #ACTION_PERMISSION_RESPONSE_RECEIVED
Les restrictions statiques sont spécifiées par un fichier XML référencé par un attribut de méta-données dans le manifeste. Cela permet aux applications ainsi qu’à toutes les consoles d’administration web de pouvoir lire la liste des restrictions disponibles à partir de l’apk.
La syntaxe du format XML est la suivante :
<?xml version="1.0" encoding="utf-8"?>
<restrictions xmlns:android="http://schemas.android.com/apk/res/android" >
<restriction
android:key="string"
android:title="string resource"
android:restrictionType=["bool" | "string" | "integer"
| "choice" | "multi-select" | "hidden"
| "bundle" | "bundle_array"]
android:description="string resource"
android:entries="string-array resource"
android:entryValues="string-array resource"
android:defaultValue="reference" >
<restriction ... />
...
</restriction>
<restriction ... />
...
</restrictions>
Les attributs de chaque restriction dépendent du type de restriction.
<ul><li>key, title et restrictionType sont obligatoires.</li li><>entries et entryValues sont obligatoires si restrictionType c’est choice ou .multi-select</li est><>defaultValue facultatif et son type dépend du restrictionType<type /li li><>hidden doit avoir un defaultValue et ne sera pas affiché à l’administrateur. Il peut être utilisé pour transmettre des données qui ne peuvent pas être modifiées, telles qu’un code de version.</li li><>description est destiné à décrire la restriction plus en détail à l’administrateur contrôlant les valeurs, si le titre n’est pas suffisant.</li></ul>
Seules les restrictions de type bundle et bundle_array peuvent avoir un ou plusieurs éléments de restriction imbriqués.
Dans la section de application votre manifeste, ajoutez la balise de méta-données pour pointer vers le fichier XML de restrictions, comme indiqué ci-dessous :
<application ... >
<meta-data android:name="android.content.APP_RESTRICTIONS"
android:resource="@xml/app_restrictions" />
...
</application>
Java documentation pour android.content.RestrictionsManager.
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.
Constructeurs
| Nom | Description |
|---|---|
| RestrictionsManager(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Champs
| Nom | Description |
|---|---|
| ActionPermissionResponseReceived |
Intention de diffusion remise lorsqu’une réponse est reçue pour une demande d’autorisation. |
| ActionRequestLocalApproval |
Intention d’activité qui est éventuellement implémentée par le package fournisseur de restrictions pour contester un code confidentiel administrateur ou un mot de passe localement sur l’appareil. |
| ActionRequestPermission |
Intention de diffusion envoyée au fournisseur de restrictions pour gérer une demande d’autorisation d’une application. |
| ExtraPackageName |
Nom du package de l’application effectuant la requête. |
| ExtraRequestBundle |
Bundle de demandes transmis dans la |
| ExtraRequestId |
ID de demande transmis dans la |
| ExtraRequestType |
Type de requête transmis dans la |
| ExtraResponseBundle |
Contient une réponse de l’administrateur pour une demande spécifique. |
| MetaDataAppRestrictions |
Nom de l’entrée de méta-données dans le manifeste qui pointe vers le fichier XML contenant les restrictions disponibles de l’application. |
| RequestKeyApproveLabel |
Clé pour l’étiquette du bouton d’approbation de demande contenue dans le bundle de demandes. |
| RequestKeyData |
Clé pour les données de requête contenues dans le bundle de requêtes. |
| RequestKeyDenyLabel |
Clé pour l’étiquette du bouton de rejet de demande contenue dans le bundle de demandes. |
| RequestKeyIcon |
Clé de l’icône de requête contenue dans le bundle de requêtes. |
| RequestKeyId |
Clé pour l’ID de requête contenu dans le bundle de requêtes. |
| RequestKeyMessage |
Clé pour le message de requête contenu dans le bundle de demandes. |
| RequestKeyNewRequest |
Clé pour l’émission d’une nouvelle requête, contenue dans le bundle de demandes. |
| RequestKeyTitle |
Clé pour le titre de la demande contenue dans le bundle de demandes. |
| RequestTypeApproval |
Type de requête pour une question simple, avec un titre et une icône possibles. |
| ResponseKeyErrorCode |
Clé du code d’erreur facultatif dans le bundle de réponses envoyé à l’application. |
| ResponseKeyMessage |
Clé du message facultatif dans le bundle de réponses envoyé à l’application. |
| ResponseKeyResponseTimestamp |
Clé de l’horodatage facultatif du moment où l’administrateur a répondu à la demande d’autorisation. |
| ResponseKeyResult |
Clé pour le résultat de la réponse dans le bundle de réponses envoyé à l’application, pour une demande d’autorisation. |
Propriétés
| Nom | Description |
|---|---|
| ApplicationRestrictions |
Retourne tout ensemble disponible de restrictions spécifiques à l’application applicables à cette application. |
| ApplicationRestrictionsPerAdmin |
Retourne une valeur contenant un |
| Class |
Retourne la classe runtime de ce |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| HasRestrictionsProvider |
Appelé par une application pour vérifier s’il existe un fournisseur de restrictions actif. |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| JniPeerMembers |
Obtient les métadonnées JNI utilisées pour appeler les membres de cet homologue Java. |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
Méthodes
| Nom | Description |
|---|---|
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| ConvertRestrictionsToBundle(IList<RestrictionEntry>) |
Convertit une liste de restrictions en bundle correspondant, à l’aide du mappage suivant : <table><tr><th>RestrictionEntry</th th><>Bundle</th></tr><tr><td> |
| CreateLocalApprovalIntent() | |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| Equals(Object) |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| GetManifestRestrictions(String) |
Analysez et retournez la liste des restrictions définies dans le manifeste du package spécifié, le cas échéant. |
| JavaFinalize() |
Obsolète.
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| NotifyPermissionResponse(String, PersistableBundle) |
Appelé par le fournisseur de restrictions pour fournir une réponse à une application. |
| RequestPermission(String, String, PersistableBundle) |
Appelé par une application pour demander l’autorisation d’une opération. |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. (Hérité de JavaObject) |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Fournit un mécanisme permettant aux applications d’interroger des restrictions imposées par une entité qui gère l’utilisateur. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |