Compartilhar via


Especificar uma contagem de ocorrências

Uma contagem de ocorrências de ponto de interrupção é um contador incrementado pelo depurador do Transact-SQL a cada vez que o ponto de interrupção é atingido. Se a contagem de ocorrências especificada for atingida, e qualquer condição de ponto de interrupção especificada for atendida, o depurador executará a ação especificada para o ponto de interrupção.

Considerações sobre a contagem de ocorrências

Por padrão, a execução é interrompida sempre que um ponto de interrupção é atingido. Você pode escolher uma das seguintes opções:

  • Interromper sempre (o padrão).

  • Interromper quando a contagem de ocorrências for igual a um valor especificado.

  • Interromper quando a contagem de ocorrências for igual a um múltiplo do valor especificado.

  • Interromper quando a contagem de ocorrências for maior ou igual ao valor especificado.

As contagens de ocorrências de ponto de interrupção são incrementadas dentro do escopo de uma sessão de depuração. Todas as contagens de ocorrências são definidas como zero no início de cada sessão de depuração.

Se você desejar controlar quantas vezes um ponto de interrupção é atingido sem ter a execução do ponto de interrupção, especifique uma contagem de ocorrências com um valor muito alto para que o ponto de interrupção nunca interrompa.

A ação padrão de um ponto de interrupção é interromper a execução quando a contagem de ocorrências e a condição do ponto de interrupção são atendidas. Para obter mais informações sobre como especificar outra ações, consulte Especificar uma ação de ponto de interrupção.

Para especificar uma contagem de ocorrências

  1. Na janela do editor, clique com o botão direito do mouse no glifo do ponto de interrupção e clique em Contagem de Ocorrências no menu de atalho.

    - ou -

    Na janela Pontos de Interrupção, clique com o botão direito do mouse no glifo de ponto de interrupção e clique em Contagem de Ocorrências no menu de atalho.

  2. Na caixa de diálogo Contagem de Ocorrências de Ponto de interrupção, selecione o comportamento desejado na caixa Quando o ponto de interrupção for atingido.

    Se você escolher qualquer configuração diferente de Interromper Sempre, uma caixa de texto será exibida à direita da lista. Digite um inteiro na caixa de texto para especificar a contagem de ocorrências desejada.

  3. Clique em OK para implementar as alterações ou em Cancelar para sair sem aplicar as alterações.

Para exibir ou redefinir a contagem de ocorrências atual

  1. Na janela do editor, clique com o botão direito do mouse no glifo do ponto de interrupção e clique em Contagem de Ocorrências no menu de atalho.

    - ou -

    Na janela Pontos de Interrupção, clique com o botão direito do mouse no glifo de ponto de interrupção e clique em Contagem de Ocorrências no menu de atalho.

  2. Na caixa de diálogo Contagem de Ocorrências de Ponto de interrupção, Contagem de ocorrências atual: é exibido imediatamente acima do botão Redefinir.

  3. Clique em Redefinir se desejar definir a contagem de ocorrências atual como zero.

  4. Clique em OK ou em Cancelar para sair do diálogo.

Consulte também

Tarefas

Especificar uma condição de ponto de interrupção