Além da funcionalidade básica da captura de tela, o API do GrabzIt ASP.NET permite que os desenvolvedores verifiquem o status das capturas de tela existentes e definam os cookies que o GrabzIt usará para capturar capturas de tela para o desenvolvedor.

Status da captura de tela

Às vezes, um aplicativo pode precisar verificar o status de uma captura de tela, talvez para ver se foi feita ou se ainda está em cache.

GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

ScreenShotStatus status = grabzIt.GetStatus(screenShotId);

if (status.Processing)
{
    // screenshot has not yet been processed
}

if (status.Cached)
{
    // screenshot is still cached by GrabzIt
}

if (status.Expired)
{
    // screenshot is no longer on GrabzIt
    // Perhaps output status message?
    label.Text = status.Message;
}

Cookies

Alguns sites controlam a funcionalidade por meio de cookies. O GrabzIt permite que você defina seus próprios cookies definidos pelo desenvolvedor da seguinte maneira.

GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

// gets an array of cookies for google.com
GrabzItCookie[] cookies = grabzIt.Cookies("google.com");

# sets a cookie for the google.com domain
grabzIt.SetCookie("MyCookie", "google.com", "Any Value You Like");

# deletes the previously set cookie
grabzIt.DeleteCookie("MyCookie", "google.com");

Observe que o método de exclusão de cookies excluirá todos os cookies com o mesmo nome e domínio.

Exibir uma captura sem fazer o download

Embora seja recomendado que uma captura seja baixada para um servidor da Web antes de ser usada. É possível exibir qualquer tipo de captura no navegador de um usuário sem fazer o download primeiro no servidor da web.

Depois que a captura terminar, você poderá enviar os bytes da captura retornados pelo SaveTo método para a resposta junto com o tipo mime correto.

GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");

grabzIt.URLToImage("https://www.tesla.com");
GrabzItFile capture = grabzIt.SaveTo();

if (capture != null)
{
    Response.ContentType = "image/jpeg";
    Response.BinaryWrite(capture.Bytes);
}

Um exemplo de saída de captura para a resposta é mostrado acima para o URLToImage , mas funcionará com qualquer um dos métodos de conversão.