BackupDataOutput Klasse
Definition
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 die strukturierte Schnittstelle bereit, über die ein BackupAgent Commit von Informationen zum Sicherungsdatensatz über seine BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor)
onBackup() Methode erfolgt.
[Android.Runtime.Register("android/app/backup/BackupDataOutput", DoNotGenerateAcw=true)]
public class BackupDataOutput : Java.Lang.Object[<Android.Runtime.Register("android/app/backup/BackupDataOutput", DoNotGenerateAcw=true)>]
type BackupDataOutput = class
inherit Object- Vererbung
- Attribute
Hinweise
Stellt die strukturierte Schnittstelle bereit, über die ein BackupAgent Commit von Informationen zum Sicherungsdatensatz über seine BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() Methode erfolgt. Daten, die für die Sicherung geschrieben werden, werden als eine Gruppe von "Entities", Schlüssel-Wert-Paaren dargestellt, in denen jeder binäre Datensatz "value" mit einer Zeichenfolge "key" benannt wird.
Um einen Datensatz auf den Sicherungstransport zu übernehmen, schreibt die Methode des Agents zunächst einen "Entitätsheader BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() ", der die Schlüsselzeichenfolge für den Datensatz und die Gesamtgröße des Binärwerts für den Datensatz bereitstellt. Nachdem der Header geschrieben wurde, schreibt der Agent dann den binären Entitätswert selbst. Der Entitätswert kann bei Bedarf in mehreren Blöcken geschrieben werden, solange die Gesamtanzahl der geschriebenen Bytes dem entspricht, was bereitgestellt #writeEntityHeader(String, int) writeEntityHeader()wurde.
Entitätsschlüsselzeichenfolgen gelten als eindeutig innerhalb des Sicherungsdatensatzes einer bestimmten Anwendung. Wenn ein Sicherungs-Agent eine neue Entität unter einer vorhandenen Schlüsselzeichenfolge schreibt, ersetzt der Wert jeden vorherigen Wert im Remotedatenspeicher des Transports. Sie können einen Datensatz vollständig aus dem Remotedatensatz entfernen, indem Sie einen neuen Entitätsheader mit dem Schlüssel des vorhandenen Datensatzes schreiben, aber einen negativen dataSize Parameter angeben. In diesem Fall muss der Agent nicht anrufen #writeEntityData(byte[], int).
<h3>(Beispiel</h3)>
Hier ist ein Beispiel, das eine Möglichkeit zeigt, den Wert einer Zeichenfolgenvariablen mStringToBackUpzu sichern:
static final String MY_STRING_KEY = "storedstring";
public void {@link BackupAgent#onBackup(ParcelFileDescriptor, BackupDataOutput, ParcelFileDescriptor) onBackup(ParcelFileDescriptor oldState, BackupDataOutput data, ParcelFileDescriptor newState)}
throws IOException {
...
byte[] stringBytes = mStringToBackUp.getBytes();
data.writeEntityHeader(MY_STRING_KEY, stringBytes.length);
data.writeEntityData(stringBytes, stringBytes.length);
...
}
Java Dokumentation für android.app.backup.BackupDataOutput.
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 |
|---|---|
| BackupDataOutput(IntPtr, JniHandleOwnership) |
Ein Konstruktor, der beim Erstellen verwalteter Darstellungen von JNI-Objekten verwendet wird; wird von der Laufzeit aufgerufen. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Class |
Gibt die Laufzeitklasse dieses Werts |
| Handle |
Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object) |
| JniIdentityHashCode |
Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object) |
| JniManagedPeerState |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| JniPeerMembers |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| PeerReference |
Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object) |
| Quota |
Gibt das Kontingent in Byte für den aktuellen Sicherungsvorgang der Anwendung zurück. |
| 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. |
| TransportFlags |
Gibt Flags mit zusätzlichen Informationen zum Sicherungstransport zurück. |
Methoden
| Name | Beschreibung |
|---|---|
| Clone() |
Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| 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 die strukturierte Schnittstelle bereit, über die ein |
| Equals(Object) |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| 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) |
| JavaFinalize() |
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) |
| SetHandle(IntPtr, JniHandleOwnership) |
Legt die Handle-Eigenschaft fest. (Geerbt von Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| 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) |
| WriteEntityData(Byte[], Int32) |
Schreiben Sie einen Datenabschnitt unter der aktuellen Entität in den Sicherungstransport. |
| WriteEntityDataAsync(Byte[], Int32) |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| WriteEntityHeader(String, Int32) |
Markieren Sie den Anfang eines Datensatzes im Sicherungsdatenstrom. |
| WriteEntityHeaderAsync(String, Int32) |
Stellt die strukturierte Schnittstelle bereit, über die ein |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IJavaPeerable.Disposed() |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| IJavaPeerable.Finalized() |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| IJavaPeerable.JniObjectReferenceControlBlock |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Stellt die strukturierte Schnittstelle bereit, über die ein |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ruft den JNI-Namen des Typs der Instanz |
| JavaAs<TResult>(IJavaPeerable) |
Versuchen Sie, die Eingabe |
| JavaCast<TResult>(IJavaObject) |
Führt eine android-laufzeitgecheckte Typkonvertierung aus. |
| JavaCast<TResult>(IJavaObject) |
Stellt die strukturierte Schnittstelle bereit, über die ein |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Versuchen Sie, die Eingabe |