共用方式為

HOW TO：更新書籤文字

  • 發行項

更新：2007 年 11 月

適用於

本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。

專案類型

  • 文件層級專案

  • 應用程式層級專案

Microsoft Office 版本

  • Word 2003

  • Word 2007

如需詳細資訊，請參閱依應用程式和專案類型提供的功能。

您可以將文字插入 Microsoft Office Word 文件中的預留位置書籤，以便在稍後擷取文字，或是取代書籤中的文字。如果您正在開發文件層級自訂，也可以透過繫結至資料的 Microsoft.Office.Tools.Word.Bookmark 控制項來更新文字。如需詳細資訊，請參閱將資料繫結至控制項。

書籤物件可以是下列兩種類型中的一種：

當您將文字指派給書籤時，Microsoft.Office.Interop.Word.Bookmark 和 Microsoft.Office.Tools.Word.Bookmark 之間的行為有所差異。如需詳細資訊，請參閱書籤控制項。

使用主控制項

若要使用書籤控制項更新書籤內容

  1. 建立一個採用兩個引數的程序：一個是代表書籤名稱的 bookmark 引數，另一個是代表要指派給 Text 屬性之字串的 newText 引數。

    注意事項：

    將文字指派給 Microsoft.Office.Tools.Word.Bookmark 控制項的 Bookmark.Text 或 Bookmark.FormattedText 屬性，不會造成書籤的刪除。

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

    static void BookMarkReplace(
    ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
    string newText)
{

  2. 將 newText 字串指派給 Microsoft.Office.Tools.Word.Bookmark 的 Text 屬性。

        bookmark.Text = newText
End Sub

        bookmark.Text = newText;
}

使用 Word 物件

若要使用 Word 書籤物件更新書籤內容

  1. 建立一個採用兩個引數的程序：一個是代表 Microsoft.Office.Interop.Word.Bookmark 名稱的 bookmark 引數，另一個是代表要指派給書籤之 Range.Text 屬性的 newText 引數。

    注意事項：

    將文字指派給原生 Word Microsoft.Office.Interop.Word.Bookmark 物件，會造成書籤的刪除。

    		 
    Friend Sub BookMarkReplaceNative( _
    ByVal bookmark As Word.Bookmark, _
    ByVal newText As String)

    internal void BookMarkReplaceNative(
    Word.Bookmark bookmark, 
    string newText)
{

  2. 將 newText 字串指派給書籤的 Range.Text 屬性，以自動刪除書籤。然後，將書籤重新加入至 Bookmarks 集合。

    下列程式碼範例可以用於文件層級自訂中。

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

    bookmark.Range.Text = newText

    Me.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

        object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    this.Bookmarks.Add(bookmarkName, ref rng); 
}

    下列程式碼範例可以用於應用程式層級的增益集中。本範例使用主動式文件。

        Dim rng As Object = bookmark.Range
    Dim bookmarkName As String = bookmark.Name

    bookmark.Range.Text = newText
    Me.Application.ActiveDocument.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

        object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    Word.Document document = this.Application.ActiveDocument;
    document.Bookmarks.Add(bookmarkName, ref rng);
}

請參閱

工作

HOW TO：將文字插入 Word 文件中

概念

Word 物件模型概觀

書籤控制項