BackupDataOutput Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce l'interfaccia strutturata tramite cui un BackupAgent esegue il commit delle informazioni nel set di dati di backup tramite il relativo BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor)
onBackup() metodo.
[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
- Ereditarietà
- Attributi
Commenti
Fornisce l'interfaccia strutturata tramite cui un BackupAgent esegue il commit delle informazioni nel set di dati di backup tramite il relativo BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() metodo. I dati scritti per il backup vengono presentati come un set di coppie chiave/valore in cui ogni record di dati binario "value" viene denominato con una stringa "key".
Per eseguire il commit di un record di dati nel trasporto di backup, il metodo dell'agente BackupAgent#onBackup(ParcelFileDescriptor,BackupDataOutput,ParcelFileDescriptor) onBackup() scrive innanzitutto un'intestazione di entità che fornisce la stringa di chiave per il record e le dimensioni totali del valore binario per il record. Dopo aver scritto l'intestazione, l'agente scrive quindi il valore dell'entità binaria stessa. Il valore dell'entità può essere scritto in più blocchi, se necessario, purché il numero totale di byte scritti corrisponda a quello fornito a #writeEntityHeader(String, int) writeEntityHeader().
Le stringhe di chiave di entità vengono considerate univoche all'interno del set di dati di backup di una determinata applicazione. Se un agente di backup scrive una nuova entità in una stringa di chiave esistente, il relativo valore sostituirà qualsiasi valore precedente nell'archivio dati remoto del trasporto. È possibile rimuovere completamente un record dal set di dati remoti scrivendo una nuova intestazione di entità usando la chiave del record esistente, ma fornendo un parametro negativo dataSize . In questo caso, l'agente non deve chiamare #writeEntityData(byte[], int).
<h3>Esempio</h3>
Di seguito è riportato un esempio che illustra un modo per eseguire il backup del valore di una variabile String denominata 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);
...
}
per android.app.backup.BackupDataOutput.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Costruttori
| Nome | Descrizione |
|---|---|
| BackupDataOutput(IntPtr, JniHandleOwnership) |
Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime. |
Proprietà
| Nome | Descrizione |
|---|---|
| Class |
Restituisce la classe di runtime di questo |
| Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
| JniIdentityHashCode |
Ottiene il codice hash di identità assegnato a questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| JniManagedPeerState |
Ottiene gli ultimi flag di stato assegnati dal runtime. (Ereditato da JavaObject) |
| JniPeerMembers |
Ottiene i metadati JNI usati per accedere ai membri di questa associazione Java. |
| PeerReference |
Ottiene il riferimento all'oggetto JNI per questo peer Java. (Ereditato da Object) |
| Quota |
Restituisce la quota in byte per l'operazione di backup corrente dell'applicazione. |
| ThresholdClass |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
| ThresholdType |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
| TransportFlags |
Restituisce i flag con informazioni aggiuntive sul trasporto di backup. |
Metodi
| Nome | Descrizione |
|---|---|
| Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Delega la costruzione di questo peer al gestore dei valori del runtime. (Ereditato da JavaObject) |
| Dispose() |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| Dispose(Boolean) |
Rilascia le risorse contenute in questo peer Java. (Ereditato da Object) |
| DisposeUnlessReferenced() |
Chiede al gestore dei valori di eliminare il peer a meno che il mapping non mantenga la stessa istanza gestita. (Ereditato da JavaObject) |
| Equals(Object) |
Verifica se un altro peer gestito fa riferimento allo stesso oggetto Java. (Ereditato da JavaObject) |
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| GetHashCode() |
Restituisce un valore di codice hash per l'oggetto . (Ereditato da Object) |
| JavaFinalize() |
Obsoleti.
Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object) |
| Notify() |
Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| NotifyAll() |
Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Archivia un valore di riferimento nel blocco di controllo senza creare una copia di riferimento JNI. (Ereditato da JavaObject) |
| ToArray<T>() |
Crea una matrice gestita da questo wrapper di matrice Java. (Ereditato da Object) |
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto . (Ereditato da Object) |
| UnregisterFromRuntime() |
Annulla la registrazione di questo Java peer dal runtime di interoperabilità. (Ereditato da Object) |
| Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo una notifica o un'interruzione. (Ereditato da Object) |
| Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo una notifica o un'interruzione o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo una notifica o un'interruzione o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| WriteEntityData(Byte[], Int32) |
Scrivere un blocco di dati nell'entità corrente nel trasporto di backup. |
| WriteEntityDataAsync(Byte[], Int32) |
Viene eseguito WriteEntityData(Byte[], Int32) in un thread del pool di thread. |
| WriteEntityHeader(String, Int32) |
Contrassegnare l'inizio di un record nel flusso di dati di backup. |
| WriteEntityHeaderAsync(String, Int32) |
Viene eseguito WriteEntityHeader(String, Int32) in un thread del pool di thread. |
Implementazioni dell'interfaccia esplicita
| Nome | Descrizione |
|---|---|
| IJavaPeerable.Disposed() |
Contrassegna questo peer come eliminato e chiama |
| IJavaPeerable.Finalized() |
Contrassegna questo peer come eliminato e chiama |
| IJavaPeerable.JniObjectReferenceControlBlock |
Ottiene il puntatore nativo a blocchi di controllo utilizzato dal peer. (Ereditato da JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Archivia il codice hash di identità fornito dal runtime. (Ereditato da JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Sostituisce i flag di stato del peer gestito archiviati. (Ereditato da JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Aggiorna il riferimento peer e rilascia il blocco di controllo di un peer eliminato quando il riferimento non è valido. (Ereditato da JavaObject) |
Metodi di estensione
| Nome | Descrizione |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Ottiene il nome JNI del tipo dell'istanza |
| JavaAs<TResult>(IJavaPeerable) |
Provare a digitare |
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Riutilizza un peer gestito compatibile o ottiene un wrapper del tipo richiesto. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Provare a digitare |