Migração da versão 2.0 para a 2.1

A versão 2.1 do DotNetBrowser traz algumas melhorias tanto para os recursos internos quanto para a API pública da biblioteca. A versão do engine foi atualizada para Chromium 79. Este guia mostra como tornar o código do seu aplicativo escrito com o DotNetBrowser versão 2.0 compatível com a versão 2.1.

Por quê migrar?

Recomendamos que atualize o seu código para a versão mais recente, uma vez que todas as novas funcionalidades, atualizações do Chromium, suporte de novos sistemas operativos e versões do .NET Framework, correções de erros, correções de segurança, melhorias de desempenho e de utilização de memória são aplicadas sobre a versão mais recente.

Quanto tempo demora?

De acordo com a nossa experiência, a atualização para uma nova versão principal pode demorar de algumas horas a alguns dias, dependendo do número de funcionalidades que utiliza na sua aplicação. Como é habitual, recomendamos vivamente que teste o seu software após a atualização em todos os ambientes que suporta.

Obter ajuda

Caso não tenha encontrado a resposta neste guia e necessite de assistência com a migração, por favor, contate-nos. Ficaremos felizes em ajudar.

Principais alterações

Handler do Baixador

A propriedade StartDownloadHandler foi transferida da interface IDownloads para a interface IBrowser.

v2.0

engine.Downloads.StartDownloadHandler = 
    new Handler<StartDownloadParameters, StartDownloadResponse>((p) =>
    {
        return StartDownloadResponse.DownloadTo(Path.Combine(Path.GetTempPath(),
            p.Download.Info.SuggestedFileName));
    });

engine.Downloads.StartDownloadHandler = 
    New Handler(Of StartDownloadParameters, StartDownloadResponse)(Function(p)
        Return StartDownloadResponse.DownloadTo(Path.Combine(Path.GetTempPath(),
            p.Download.Info.SuggestedFileName))
    End Function)

v2.1

browser.StartDownloadHandler = 
    new Handler<StartDownloadParameters, StartDownloadResponse>((p) =>
    {
        return StartDownloadResponse.DownloadTo(Path.Combine(Path.GetTempPath(),
            p.Download.Info.SuggestedFileName));
    });

browser.StartDownloadHandler = 
    New Handler(Of StartDownloadParameters, StartDownloadResponse)(Function(p)
        Return StartDownloadResponse.DownloadTo(Path.Combine(Path.GetTempPath(),
            p.Download.Info.SuggestedFileName))
    End Function)

Funcionalidade abandonada

Na nova versão, a seguinte funcionalidade já não é suportada:

• O evento INetwork.TransactionStarted. Em vez disso, você pode utilizar o INetwork.StartTransactionHandler.
• O evento INetwork.BytesReceived. Em vez disso, você você pode utilizar o evento INetwork.ResponseBytesReceived.
• O evento INetwork.BytesSent.
• A propriedade Url já não está disponível emCanAccessFileParametersutilizada por INetwork.CanAccessFileHandler.