BackupDataOutput 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 l’interface structurée par le biais de laquelle une BackupAgent validation des informations dans le jeu de données de sauvegarde, via sa BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor)
onBackup() méthode.
[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- Héritage
- Attributs
Remarques
Fournit l’interface structurée par le biais de laquelle une BackupAgent validation des informations dans le jeu de données de sauvegarde, via sa BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() méthode. Les données écrites pour la sauvegarde sont présentées sous la forme d’un ensemble de paires clé/valeur dans lesquelles chaque enregistrement de données binaires « value » est nommé avec une chaîne « key ».
Pour valider un enregistrement de données dans le transport de sauvegarde, la méthode de BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() l’agent écrit d’abord un « en-tête d’entité » qui fournit la chaîne de clé pour l’enregistrement et la taille totale de la valeur binaire pour l’enregistrement. Une fois l’en-tête écrit, l’agent écrit ensuite la valeur d’entité binaire elle-même. La valeur d’entité peut être écrite en plusieurs blocs si vous le souhaitez, tant que le nombre total d’octets écrits correspond à ce qui a été fourni à #writeEntityHeader(String, int) writeEntityHeader().
Les chaînes de clé d’entité sont considérées comme uniques dans le jeu de données de sauvegarde d’une application donnée. Si un agent de sauvegarde écrit une nouvelle entité sous une chaîne de clé existante, sa valeur remplace toute valeur précédente dans le magasin de données distant du transport. Vous pouvez supprimer un enregistrement entièrement du jeu de données distant en écrivant un nouvel en-tête d’entité à l’aide de la clé de l’enregistrement existant, mais en fournissant un paramètre négatif dataSize . Lorsque vous le faites, l’agent n’a pas besoin d’appeler #writeEntityData(byte[], int).
<exemple> h3</h3>
Voici un exemple illustrant un moyen de sauvegarder la valeur d’une variable String appelée mStringToBackUp:
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 documentation pour android.app.backup.BackupDataOutput.
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 |
|---|---|
| BackupDataOutput(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
Propriétés
| Nom | Description |
|---|---|
| Class |
Retourne la classe runtime de ce |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Fournit l’interface structurée par le biais de laquelle une |
| JniPeerMembers |
Fournit l’interface structurée par le biais de laquelle une |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| Quota |
Retourne le quota en octets pour l’opération de sauvegarde actuelle de l’application. |
| 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. |
| TransportFlags |
Retourne des indicateurs avec des informations supplémentaires sur le transport de sauvegarde. |
Méthodes
| Nom | Description |
|---|---|
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Fournit l’interface structurée par le biais de laquelle une |
| 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 l’interface structurée par le biais de laquelle une |
| Equals(Object) |
Fournit l’interface structurée par le biais de laquelle une |
| 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) |
| JavaFinalize() |
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) |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Fournit l’interface structurée par le biais de laquelle une |
| 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) |
| WriteEntityData(Byte[], Int32) |
Écrivez un bloc de données sous l’entité actuelle dans le transport de sauvegarde. |
| WriteEntityDataAsync(Byte[], Int32) |
Fournit l’interface structurée par le biais de laquelle une |
| WriteEntityHeader(String, Int32) |
Marquez le début d’un enregistrement dans le flux de données de sauvegarde. |
| WriteEntityHeaderAsync(String, Int32) |
Fournit l’interface structurée par le biais de laquelle une |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Fournit l’interface structurée par le biais de laquelle une |
| IJavaPeerable.Finalized() |
Fournit l’interface structurée par le biais de laquelle une |
| IJavaPeerable.JniObjectReferenceControlBlock |
Fournit l’interface structurée par le biais de laquelle une |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Fournit l’interface structurée par le biais de laquelle une |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Fournit l’interface structurée par le biais de laquelle une |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Fournit l’interface structurée par le biais de laquelle une |
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 l’interface structurée par le biais de laquelle une |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |