Share via


How to: Programmatically count characters in documents

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

The first character in a document is at character position 0, which represents the insertion point. The last character position is equal to the total number of characters in the document. You can determine the number of characters in a document by using the Count property of the Characters collection.

All characters in the document are counted, including spaces, paragraph marks, and other characters that are normally hidden. Even a new, blank document returns a count of one character because it contains a paragraph mark.

Applies to: The information in this topic applies to document-level projects and VSTO Add-in projects for Word. For more information, see Features available by Office application and project type.

To display the number of characters in a document-level customization

  1. Select the entire document.

    Dim rng As Word.Range = Me.Range(0, Me.Characters.Count)
    rng.Select()
    
    Word.Range rng = this.Content; 
    rng.Select();
    
  2. Display the number of characters in the document in a message box.

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

To display the number of characters in a VSTO Add-in

  1. Select the entire document. The following example selects the active document.

    Dim rng As Word.Range = Me.Application.ActiveDocument.Range( _
        0, Me.Application.ActiveDocument.Characters.Count)
    rng.Select()
    
    Word.Range rng = this.Application.ActiveDocument.Content;
    rng.Select();
    
  2. Display the number of characters in the document in a message box.

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

See also