FileChannel.Force(Boolean) Méthode

Définition

Espace de noms:

Java.Nio.Channels

Assembly:

Mono.Android.dll

Force les mises à jour du fichier de ce canal à écrire sur l’appareil de stockage qui le contient.

[Android.Runtime.Register("force", "(Z)V", "GetForce_ZHandler")]
public abstract void Force (bool metaData);

[<Android.Runtime.Register("force", "(Z)V", "GetForce_ZHandler")>]
abstract member Force : bool -> unit

Paramètres

metaData

Boolean

Si true cette méthode est alors nécessaire pour forcer l’écriture des modifications dans le contenu et les métadonnées du fichier à écrire dans le stockage ; sinon, il n’est nécessaire que forcer l’écriture des modifications de contenu.

Attributs

RegisterAttribute

Exceptions

ClosedChannelException

si ce canal est déjà fermé.

IOException

si une autre erreur d’E/S se produit.

Remarques

Force les mises à jour du fichier de ce canal à écrire sur l’appareil de stockage qui le contient.

Si le fichier de ce canal réside sur un périphérique de stockage local, lorsque cette méthode retourne, il est garanti que toutes les modifications apportées au fichier depuis la création de ce canal, ou depuis que cette méthode a été appelée pour la dernière fois, ont été écrites sur cet appareil. Cela est utile pour s’assurer que les informations critiques ne sont pas perdues en cas de blocage du système.

Si le fichier ne réside pas sur un appareil local, aucune telle garantie n’est effectuée.

Le metaData paramètre peut être utilisé pour limiter le nombre d’opérations d’E/S requises pour effectuer cette méthode. Le passage de ce paramètre indique que seules les mises à jour du contenu du fichier doivent être écrites dans le stockage. Le passage false true indique que les mises à jour du contenu et des métadonnées du fichier doivent être écrites, ce qui nécessite généralement au moins une opération d’E/S supplémentaire. Si ce paramètre a réellement un effet dépendant du système d’exploitation sous-jacent et n’est donc pas spécifié.

L’appel de cette méthode peut entraîner l’exécution d’une opération d’E/S même si le canal n’a été ouvert que pour la lecture. Certains systèmes d’exploitation, par exemple, conservent une heure de dernier accès dans le cadre des métadonnées d’un fichier, et cette fois-ci est mise à jour chaque fois que le fichier est lu. Si cette opération est réellement effectuée dépend du système et n’est donc pas spécifiée.

Cette méthode est garantie uniquement pour forcer les modifications apportées au fichier de ce canal via les méthodes définies dans cette classe. Il peut ou non forcer les modifications qui ont été apportées en modifiant le contenu d’un MappedByteBuffer <i>mapped byte buffer</i> obtenu en appelant la #map map méthode. L’appel de la MappedByteBuffer#force force méthode de la mémoire tampon d’octet mappée force l’écriture des modifications apportées au contenu de la mémoire tampon.

Documentation Java pour java.nio.channels.FileChannel.force(boolean).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.