StorageStreamTransaction Classe

  • Referência

Definição

Namespace:
Windows.Storage
Editar

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
Object Platform::Object IInspectable StorageStreamTransaction
Atributos
ContractVersionAttribute
Implementações
IClosable IDisposable

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.

Aplica-se a

Confira também