Compartilhar via


Contar caracteres programaticamente em documentos

O primeiro caractere em um documento está na posição de caractere 0, que representa o ponto de inserção. A última posição de caractere é igual ao número total de caracteres no documento. Você pode determinar o número de caracteres em um documento usando a Count Characters propriedade da coleção.

Todos os caracteres no documento são contados, incluindo espaços, marcas de parágrafo e outros caracteres que normalmente estão ocultos. Mesmo um novo documento em branco retorna uma contagem de um caractere porque contém uma marca de parágrafo.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO para Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Para exibir o número de caracteres em uma personalização em nível de documento

  1. Selecione o documento inteiro.

    Word.Range rng = this.Content; 
    rng.Select();
    
  2. Exibir o número de caracteres no documento em uma caixa de mensagem.

    MessageBox.Show("Characters: " + this.Characters.Count.ToString());
    

Para exibir o número de caracteres em um suplemento VSTO

  1. Selecione o documento inteiro. O exemplo a seguir seleciona o documento ativo.

    Word.Range rng = this.Application.ActiveDocument.Content;
    rng.Select();
    
  2. Exibir o número de caracteres no documento em uma caixa de mensagem.

    MessageBox.Show("Characters: " + 
        this.Application.ActiveDocument.Characters.Count.ToString());