Langue

RestrictionsManager Classe

Définition

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
RestrictionsManager
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 :

&lt;?xml version="1.0" encoding="utf-8"?&gt;
            &lt;restrictions xmlns:android="http://schemas.android.com/apk/res/android" &gt;
                &lt;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" &gt;
                        &lt;restriction ... /&gt;
                        ...
                &lt;/restriction&gt;
                &lt;restriction ... /&gt;
                ...
            &lt;/restrictions&gt;

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 :

&lt;application ... &gt;
                &lt;meta-data android:name="android.content.APP_RESTRICTIONS"
                              android:resource="@xml/app_restrictions" /&gt;
                ...
            &lt;/application&gt;

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 #ACTION_REQUEST_PERMISSION diffusion.

ExtraRequestId

ID de demande transmis dans la #ACTION_REQUEST_PERMISSION diffusion.

ExtraRequestType

Type de requête transmis dans la #ACTION_REQUEST_PERMISSION diffusion.

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 ListBundle agent de gestion qui a défini des restrictions pour l’application actuelle, le bundle contient toutes les restrictions d’application définies pour le package actuel.

Class

Retourne la classe runtime de ce Object.

(Hérité de Object)
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>RestrictionEntry#TYPE_BOOLEAN</td><>Bundle#putBoolean</td></tr tr tr><><td>RestrictionEntry#TYPE_CHOICE,RestrictionEntry#TYPE_MULTI_SELECT< /td><td>Bundle#putStringArray</td></tr><><td>RestrictionEntry#TYPE_INTEGER<><>Bundle#putInt</td/td></tr tr td/tr tr><><>RestrictionEntry#TYPE_STRING</td><td>Bundle#putString</td></tr tr><><tr td>RestrictionEntry#TYPE_BUNDLE</td/td><>Bundle#putBundle</tr>< tr><><td>RestrictionEntry#TYPE_BUNDLE_ARRAY</td><>Bundle#putParcelableArray</td/td></tr/tr/tr></table>

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 self.

JavaAs<TResult>(IJavaPeerable)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.

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 self le typeTResult, en vérifiant que le forçage est valide côté Java.

S’applique à