StorageStreamTransaction Classe
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.
Representa uma transação de gravação para um fluxo de acesso aleatório.
public ref class StorageStreamTransaction sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageStreamTransaction final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageStreamTransaction : System.IDisposable
Public NotInheritable Class StorageStreamTransaction
Implements IDisposable
- Herança
- Atributos
- Implementações
Requisitos do Windows
Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
O exemplo de Acesso a Arquivos mostra como usar um objeto StorageStreamTransaction para executar uma operação de gravação transacionada em um arquivo.
try
{
if (file != null)
{
using (StorageStreamTransaction transaction = await file.OpenTransactedWriteAsync())
{
using (DataWriter dataWriter = new DataWriter(transaction.Stream))
{
dataWriter.WriteString("Swift as a shadow");
transaction.Stream.Size = await dataWriter.StoreAsync(); // reset stream size to override the file
await transaction.CommitAsync();
}
}
}
}
// Use catch blocks to handle errors
catch (FileNotFoundException)
{
// For example, handle a file not found error
}
No exemplo, file
é uma variável local que contém um StorageFile que representa o arquivo a ser gravado.
Propriedades
Stream |
Obtém o fluxo de acesso aleatório usado na transação. |
Métodos
Close() |
Libera recursos do sistema expostos pelo fluxo, indicando que a solicitação de dados está concluída. |
CommitAsync() |
Salve o fluxo no arquivo subjacente. |
Dispose() |
Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. |