# How to: Update Bookmark Text

Visual Studio 2005

Note

Some code examples in this topic use the this or Me keyword or the `Globals` class in a way that is specific to document-level customizations, or they rely on features of document-level customizations such as host controls. These examples can be compiled only if you have the required applications installed. For more information, see Features Available by Product Combination.

Use the Text property of a Microsoft.Office.Tools.Word.Bookmark object to insert text into a placeholder bookmark in a Microsoft Office Word 2003 document so that you can retrieve the text at a later time, or to replace text in a bookmark. You can also use the Text property to update text in a Microsoft.Office.Tools.Word.Bookmark control that is bound to data. For more information, see Binding Data to Controls Overview.

The Bookmark object can be one of two types:

When you assign text to a bookmark, the behavior differs between a Microsoft.Office.Interop.Word.Bookmark and a Microsoft.Office.Tools.Word.Bookmark. For more information, see Bookmark Control.

# Using Host Controls

### To update bookmark contents using a Bookmark control

1. Create a procedure that takes a `bookmark` argument for the name of the bookmark, and a `newText` argument for the string that replaces the Text property.

Note

Assigning text to the Microsoft.Office.Tools.Word.Bookmark.Text or Microsoft.Office.Tools.Word.Bookmark.FormattedText property of a Microsoft.Office.Tools.Word.Bookmark control does not cause the bookmark to be deleted.

```Shared Sub BookMarkReplace( _
ByRef bookmark As Microsoft.Office.Tools.Word.Bookmark, _
ByVal newText As String)

```
2. Replace the Text property of the Microsoft.Office.Tools.Word.Bookmark.

```    bookmark.Text = newText
End Sub

```

# Using Word Objects

### To update bookmark contents using a Word Bookmark object

1. Create a procedure that has a `bookmark` argument for the name of the Microsoft.Office.Interop.Word.Bookmark, and a `newText` argument for the string that replaces the Microsoft.Office.Interop.Word.Range.Text property of the bookmark.

Note

Assigning text to a native Word Microsoft.Office.Interop.Word.Bookmark object causes the bookmark to be deleted.

```Friend Sub BookMarkReplaceNative( _
ByVal bookmark As Microsoft.Office.Interop.Word.Bookmark, _
ByVal newText As String)

```
2. Replace the Microsoft.Office.Interop.Word.Range.Text property of the bookmark, which also replaces the bookmark. Then re-add the bookmark to the Bookmarks collection.

```    Dim rng As Word.Range = bookmark.Range
Dim bookmarkName As String = bookmark.Name

bookmark.Range.Text = newText

End Sub

```

How to: Insert Text into Word Documents