Compartilhar via


Especificar uma contagem de ocorrências

Aplica-se: SQL Server

Uma contagem de ocorrências de ponto de interrupção é um contador que o depurador do Transact-SQL incrementa 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.

Para controlar quantas vezes um ponto de interrupção é atingido, sem a interrupção da execução, especifique uma contagem de ocorrências com um valor 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 de 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.

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 selecione Condições… no menu de atalho.

    -ou-

    Na janela Pontos de Interrupção, clique com o botão direito do mouse no glifo do ponto de interrupção e selecione Configurações no menu de atalho.

  2. Selecione a opção Condições e selecione Contagem de ocorrências na lista suspensa.

  3. Selecione a opção de quebra na lista suspensa: =, É um múltiplo de ou >=.

  4. Digite um inteiro para especificar a contagem de ocorrências na caixa de texto.

  5. Selecione o comportamento para quando a contagem de ocorrências for atingida.

    Opção Comportamento
    Ações Para obter mais informações, consulte Especificar uma ação de ponto de interrupção.
    Desativar o ponto de interrupção depois de atingido Desabilita o ponto de interrupção quando a contagem de ocorrências é atingida.
    Ativar apenas quando o seguinte ponto de interrupção for atingido Selecione um ponto de interrupção definido.
  6. Selecione Fechar para implementar as alterações.

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 selecione Condições… no menu de atalho.

    -ou-

    Na janela Pontos de Interrupção, clique com o botão direito do mouse no glifo do ponto de interrupção e selecione Configurações no menu de atalho.

  2. Selecione o X à direita do inteiro especificado para a contagem de ocorrências para remover a configuração e definir a contagem de ocorrências atual como zero.

  3. Selecione Fechar para implementar a alteração.