StorageManager.GetAllocatableBytes(UUID) Método

Definición

Espacio de nombres:: Android.OS.Storage

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Devuelve el número máximo de bytes nuevos que la aplicación puede asignar para sí misma en el volumen de almacenamiento especificado.

[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

Parámetros

storageUuid: UUID

EL UUID del volumen de almacenamiento en el que está considerando asignar espacio en disco, ya que el espacio allocatable puede variar ampliamente en función del dispositivo de almacenamiento subyacente. El UUID de una ruta de acceso específica se puede obtener mediante #getUuidForPath(File).

Devoluciones

Int64

el número máximo de bytes nuevos que la aplicación que realiza la llamada puede asignar mediante #allocateBytes(UUID, long) o #allocateBytes(FileDescriptor, long).

Atributos: RegisterAttribute

Comentarios

Devuelve el número máximo de bytes nuevos que la aplicación puede asignar para sí misma en el volumen de almacenamiento especificado. Este valor suele ser mayor que File#getUsableSpace(), ya que el sistema puede estar dispuesto a eliminar archivos almacenados en caché para satisfacer una solicitud de asignación. Después, puede asignar espacio para usted mismo mediante #allocateBytes(UUID, long) o #allocateBytes(FileDescriptor, long).

Este método se usa mejor como una comprobación previa al vuelo, como decidir si hay suficiente espacio para almacenar un álbum de música completo antes de asignar espacio para cada archivo de audio del álbum. Se producirá un error en los intentos de asignar espacio en disco más allá del valor devuelto.

Si el valor devuelto no es lo suficientemente grande para los datos que desea conservar, puede iniciar #ACTION_MANAGE_STORAGE con las #EXTRA_UUID opciones y #EXTRA_REQUESTED_BYTES para ayudar a implicar al usuario en liberar espacio en disco.

Si va a asignar progresivamente una cantidad de espacio de almacenamiento sin enlazar (por ejemplo, al grabar un vídeo), debe evitar llamar a este método más de una vez cada 30 segundos.

Nota: si la aplicación usa la android:sharedUserId característica de manifiesto, se realiza un seguimiento de todos los paquetes de todos los paquetes del UID compartido como una sola unidad.

Java documentación para android.os.storage.StorageManager.getAllocatableBytes(java.util.UUID).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a