FileChannel.Force(Boolean) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Força todas as atualizações para o arquivo deste canal a serem gravadas no dispositivo de armazenamento que o contém.
[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 -> unitParâmetros
- metaData
- Boolean
Se true esse método for necessário para forçar alterações no conteúdo e nos metadados do arquivo a serem gravados no armazenamento; caso contrário, ele só precisará forçar alterações de conteúdo a serem gravadas
- Atributos
Exceções
se esse canal já estiver fechado.
se ocorrer outro erro de E/S.
Comentários
Força todas as atualizações para o arquivo deste canal a serem gravadas no dispositivo de armazenamento que o contém.
Se o arquivo desse canal residir em um dispositivo de armazenamento local, quando esse método retornar, será garantido que todas as alterações feitas no arquivo desde que esse canal foi criado ou, desde que esse método foi invocado pela última vez, terão sido gravadas nesse dispositivo. Isso é útil para garantir que as informações críticas não sejam perdidas no caso de uma falha do sistema.
Se o arquivo não residir em um dispositivo local, essa garantia não será feita.
O metaData parâmetro pode ser usado para limitar o número de operações de E/S que esse método é necessário para executar. Passar false para esse parâmetro indica que somente as atualizações para o conteúdo do arquivo precisam ser gravadas no armazenamento; passar true indica que as atualizações para o conteúdo e os metadados do arquivo devem ser gravadas, o que geralmente requer pelo menos mais uma operação de E/S. Se esse parâmetro realmente tem algum efeito depende do sistema operacional subjacente e, portanto, não é especificado.
Invocar esse método pode fazer com que uma operação de E/S ocorra mesmo que o canal tenha sido aberto apenas para leitura. Alguns sistemas operacionais, por exemplo, mantêm uma hora de último acesso como parte dos metadados de um arquivo e desta vez são atualizados sempre que o arquivo é lido. Se isso é feito ou não é realmente dependente do sistema e, portanto, não é especificado.
Esse método só é garantido para forçar alterações feitas no arquivo desse canal por meio dos métodos definidos nessa classe. Ele pode ou não forçar alterações que foram feitas modificando o conteúdo de um MappedByteBuffer <i>mapped byte buffer</i> obtido invocando o #map map método. Invocar o MappedByteBuffer#force force método do buffer de bytes mapeado forçará alterações feitas no conteúdo do buffer a serem gravadas.
Documentação Java para java.nio.channels.FileChannel.force(boolean).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.