RestrictionsManager Klasse

Definition

Namespace:: Android.Content

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet.

[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

Vererbung: Object

JavaObject

Object
RestrictionsManager

Attribute: RegisterAttribute

Hinweise

Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. Apps können auch Berechtigungsanforderungen an einen lokalen oder Remotegeräteadministrator senden, um standardmäßige App-spezifische Einschränkungen oder einen anderen Vorgang außer Kraft zu setzen, der explizite Autorisierung vom Administrator benötigt.

Apps können eine Reihe von Einschränkungen über eine XML-Datei verfügbar machen, die im Manifest angegeben ist.

Wenn der Benutzer über einen aktiven Einschränkungsanbieter verfügt, können zusätzlich zu den statisch auferlegten Einschränkungen dynamische Anforderungen gestellt werden. Dynamische Anforderungen sind appspezifisch und können über einen vordefinierten Satz von Anforderungstypen ausgedrückt werden.

Der RestrictionsManager leitet die dynamischen Anforderungen an den aktiven Einschränkungsanbieter weiter. Der Einschränkungsanbieter kann auf Anforderungen durch Aufrufen #notifyPermissionResponse(String, PersistableBundle)antworten, wenn eine Antwort vom Administrator des Geräts oder Benutzers empfangen wird. Die Antwort wird über eine geschützte Übertragung an die Anwendung zurückgeleitet #ACTION_PERMISSION_RESPONSE_RECEIVED.

Statische Einschränkungen werden durch eine XML-Datei angegeben, auf die durch ein Metadaten-Attribut im Manifest verwiesen wird. Auf diese Weise können Anwendungen sowie alle Webverwaltungskonsolen die Liste der verfügbaren Einschränkungen aus dem APK lesen.

Die Syntax des XML-Formats lautet wie folgt:

&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;

Die Attribute für jede Einschränkung hängen vom Einschränkungstyp ab.

<ul><li>key und titlerestrictionType sind obligatorisch.</li li><>entries und entryValues sind erforderlich, wenn restrictionType oder .choicemulti-select</li><>defaultValue ist optional, und sein Typ hängt vomrestrictionType< /li li-Typ><>hidden ab defaultValue und wird dem Administrator nicht angezeigt. Sie kann verwendet werden, um Daten zu übergeben, die nicht geändert werden können, z. B. einen Versionscode.</li li><>description soll die Einschränkung genauer beschreiben, damit der Administrator die Werte kontrolliert, wenn der Titel nicht ausreicht.</li></ul>

Nur Einschränkungen des Typs bundle und bundle_array können ein oder mehrere geschachtelte Einschränkungselemente aufweisen.

Fügen Sie im Abschnitt Ihres Manifests das Metadatentag hinzu, um auf die XML-Einschränkungsdatei application zu verweisen, wie unten gezeigt:

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

Java Dokumentation für android.content.RestrictionsManager.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Konstruktoren

Name	Beschreibung
RestrictionsManager(IntPtr, JniHandleOwnership)	Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen.

Felder

Name	Beschreibung
ActionPermissionResponseReceived	Sendeabsicht, die übermittelt wird, wenn eine Antwort für eine Berechtigungsanforderung empfangen wird.
ActionRequestLocalApproval	Aktivitätsabsicht, die optional vom Einschränkungsanbieterpaket implementiert wird, um eine Administrator-PIN oder ein Kennwort lokal auf dem Gerät herauszufordern.
ActionRequestPermission	Sendeabsicht, die an den Einschränkungsanbieter gesendet wurde, um eine Berechtigungsanforderung von einer App zu verarbeiten.
ExtraPackageName	Der Paketname der Anwendung, die die Anforderung stellt.
ExtraRequestBundle	Das Anforderungspaket, das in der `#ACTION_REQUEST_PERMISSION` Übertragung übergeben wurde.
ExtraRequestId	Die Anforderungs-ID, die in der `#ACTION_REQUEST_PERMISSION` Übertragung übergeben wurde.
ExtraRequestType	Der Anforderungstyp, der in der `#ACTION_REQUEST_PERMISSION` Übertragung übergeben wurde.
ExtraResponseBundle	Enthält eine Antwort des Administrators für eine bestimmte Anforderung.
MetaDataAppRestrictions	Name des Metadateneintrags im Manifest, der auf die XML-Datei verweist, die die verfügbaren Einschränkungen der Anwendung enthält.
RequestKeyApproveLabel	Schlüssel für die Schaltflächenbezeichnung für die Anforderungsgenehmigung, die im Anforderungspaket enthalten ist.
RequestKeyData	Schlüssel für Anforderungsdaten, die im Anforderungspaket enthalten sind.
RequestKeyDenyLabel	Schlüssel für die Schaltflächenbezeichnung der Anforderungsrückweisung im Anforderungspaket.
RequestKeyIcon	Schlüssel für das Anforderungssymbol, das im Anforderungspaket enthalten ist.
RequestKeyId	Schlüssel für die Anforderungs-ID, die im Anforderungspaket enthalten ist.
RequestKeyMessage	Schlüssel für die Anforderungsnachricht, die im Anforderungspaket enthalten ist.
RequestKeyNewRequest	Schlüssel zum Ausgeben einer neuen Anforderung, die im Anforderungspaket enthalten ist.
RequestKeyTitle	Schlüssel für den Anforderungstitel im Anforderungspaket.
RequestTypeApproval	Anforderungstyp für eine einfache Frage mit einem möglichen Titel und Symbol.
ResponseKeyErrorCode	Schlüssel für den optionalen Fehlercode im Antwortpaket, das an die Anwendung gesendet wird.
ResponseKeyMessage	Schlüssel für die optionale Nachricht im Antwortpaket, das an die Anwendung gesendet wird.
ResponseKeyResponseTimestamp	Schlüssel für den optionalen Zeitstempel, zu dem der Administrator auf die Berechtigungsanforderung geantwortet hat.
ResponseKeyResult	Schlüssel für das Antwortergebnis im Antwortpaket, das an die Anwendung gesendet wird, für eine Berechtigungsanforderung.

Eigenschaften

Name	Beschreibung
ApplicationRestrictions	Gibt alle verfügbaren anwendungsspezifischen Einschränkungen zurück, die für diese Anwendung gelten.
ApplicationRestrictionsPerAdmin	Gibt einen `List` Wert zurück, der für `Bundle` jeden Managing-Agent, der Einschränkungen für die aktuelle Anwendung festgelegt hat, enthält das Bundle alle für das aktuelle Paket festgelegten Anwendungseinschränkungen.
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
HasRestrictionsProvider	Wird von einer Anwendung aufgerufen, um zu überprüfen, ob ein aktiver Einschränkungsanbieter vorhanden ist.
JniIdentityHashCode	Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object)
JniManagedPeerState	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
JniPeerMembers	Ruft die JNI-Metadaten ab, die zum Aufrufen von Mitgliedern dieses Java Peers verwendet werden.
PeerReference	Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen.

Methoden

Name	Beschreibung
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
ConvertRestrictionsToBundle(IList<RestrictionEntry>)	Wandelt eine Liste der Einschränkungen in das entsprechende Bundle um, wobei die folgende Zuordnung verwendet wird: Table<tr th RestrictionEntry>/th<><Bundle>/th</tr><><td/td><></td></tr>`RestrictionEntry#TYPE_BOOLEAN`<><>`Bundle#putBoolean` td<><>, <></td>`RestrictionEntry#TYPE_CHOICE`td`RestrictionEntry#TYPE_MULTI_SELECT`<>/td</tr td/tr>`Bundle#putStringArray`<td><></td><td/td>`RestrictionEntry#TYPE_INTEGER`</td/tr><>`Bundle#putInt`td<><><><>`RestrictionEntry#TYPE_STRING`</td><td>`Bundle#putString`</td></tr><><td>`RestrictionEntry#TYPE_BUNDLE`</td><td/td>`Bundle#putBundle`</td></tr><><td/td>`RestrictionEntry#TYPE_BUNDLE_ARRAY`<>< td/td/td>`Bundle#putParcelableArray`</td></tr></table>
CreateLocalApprovalIntent()
Dispose()	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
Dispose(Boolean)	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
DisposeUnlessReferenced()	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
Equals(Object)	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetManifestRestrictions(String)	Analysieren und zurückgeben Sie ggf. die Liste der im Manifest für das angegebene Paket definierten Einschränkungen.
JavaFinalize()	Veraltet. Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
NotifyPermissionResponse(String, PersistableBundle)	Vom Einschränkungsanbieter aufgerufen, um eine Antwort auf eine Anwendung zu übermitteln.
RequestPermission(String, String, PersistableBundle)	Wird von einer Anwendung aufgerufen, um die Berechtigung für einen Vorgang anzufordern.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
ToArray<T>()	Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IJavaPeerable.Disposed()	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
IJavaPeerable.Finalized()	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet. (Geerbt von JavaObject)

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Stellt einen Mechanismus für Apps bereit, um Einschränkungen abzufragen, die von einer Entität auferlegt werden, die den Benutzer verwaltet.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: