StorageManager.GetAllocatableBytes(UUID) Metodo

Definizione

Spazio dei nomi:: Android.OS.Storage

Assembly:: Mono.Android.dll

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.

Restituisce il numero massimo di nuovi byte che l'app può allocare per se stessa nel volume di archiviazione specificato.

[Android.Runtime.Register("getAllocatableBytes", "(Ljava/util/UUID;)J", "GetGetAllocatableBytes_Ljava_util_UUID_Handler", ApiSince=26)]
public virtual long GetAllocatableBytes(Java.Util.UUID storageUuid);

[<Android.Runtime.Register("getAllocatableBytes", "(Ljava/util/UUID;)J", "GetGetAllocatableBytes_Ljava_util_UUID_Handler", ApiSince=26)>]
abstract member GetAllocatableBytes : Java.Util.UUID -> int64
override this.GetAllocatableBytes : Java.Util.UUID -> int64

Parametri

storageUuid: UUID

UUID del volume di archiviazione in cui si sta valutando l'allocazione dello spazio su disco, poiché lo spazio allocato può variare notevolmente a seconda del dispositivo di archiviazione sottostante. È possibile ottenere l'UUID per un percorso specifico usando #getUuidForPath(File).

Valori restituiti

Int64

numero massimo di nuovi byte che l'app chiamante può allocare usando #allocateBytes(UUID, long) o #allocateBytes(FileDescriptor, long).

Attributi: RegisterAttribute

Commenti

Restituisce il numero massimo di nuovi byte che l'app può allocare per se stessa nel volume di archiviazione specificato. Questo valore è in genere maggiore di File#getUsableSpace(), poiché il sistema può essere disposto a eliminare i file memorizzati nella cache per soddisfare una richiesta di allocazione. È quindi possibile allocare spazio per se stessi usando #allocateBytes(UUID, long) o #allocateBytes(FileDescriptor, long).

Questo metodo è meglio usato come controllo preliminare, ad esempio decidere se c'è spazio sufficiente per archiviare un intero album musicale prima di allocare spazio per ogni file audio nell'album. I tentativi di allocare spazio su disco oltre il valore restituito avranno esito negativo.

Se il valore restituito non è sufficientemente grande per i dati da rendere persistenti, è possibile avviare #ACTION_MANAGE_STORAGE con le #EXTRA_UUID opzioni e #EXTRA_REQUESTED_BYTES per coinvolgere l'utente nella liberare spazio su disco.

Se si alloca progressivamente una quantità di spazio di archiviazione non associato, ad esempio durante la registrazione di un video, è consigliabile evitare di chiamare questo metodo più volte ogni 30 secondi.

Nota: se l'app usa la funzionalità manifesto android:sharedUserId , lo spazio allocato per tutti i pacchetti nell'UID condiviso viene monitorato insieme come singola unità.

per android.os.storage.StorageManager.getAllocatableBytes(java.util.UUID).

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.

Si applica a