Gewusst wie: Aktualisieren von Text in Lesezeichen

Článek
04/28/2010

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp Projekte auf Dokumentebene Projekte auf Anwendungsebene Microsoft Office-Version Word 2003 Word 2007 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

Projekte auf Dokumentebene
Projekte auf Anwendungsebene

Microsoft Office-Version

Word 2003
Word 2007

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Sie können Text in ein Platzhalterlesezeichen in einem Microsoft Office Word-Dokument einfügen, sodass Sie den Text später abfragen oder Text in einem Lesezeichen ersetzen können. Wenn Sie eine Anpassung auf Dokumentebene entwickeln, können Sie auch Text in einem Microsoft.Office.Tools.Word.Bookmark-Steuerelement aktualisieren, das an Daten gebunden ist. Weitere Informationen finden Sie unter Binden von Daten an Steuerelemente.

Es gibt zwei verschiedene Bookmark-Objekttypen:

Ein Microsoft.Office.Tools.Word.Bookmark-Hoststeuerelement.

Microsoft.Office.Tools.Word.Bookmark-Steuerelemente erweitern systemeigene Microsoft.Office.Interop.Word.Bookmark-Objekte, indem sie die Datenbindung aktivieren und Ereignisse verfügbar machen. Weitere Informationen zu Hoststeuerelementen finden Sie unter Übersicht über Hostelemente und Hoststeuerelemente.
Ein systemeigenes Microsoft.Office.Interop.Word.Bookmark-Objekt.

Microsoft.Office.Interop.Word.Bookmark-Objekte verfügen nicht über Ereignisse oder Datenbindungsfähigkeiten.

Wenn Sie einem Lesezeichen Text zuordnen, unterscheidet sich das Verhalten zwischen einem Microsoft.Office.Interop.Word.Bookmark und einem Microsoft.Office.Tools.Word.Bookmark. Weitere Informationen finden Sie unter Bookmark-Steuerelement.

Verwenden von Hoststeuerelementen

So aktualisieren Sie Inhalte mit einem Bookmark-Steuerelement

Erstellen Sie eine Prozedur, die sowohl ein bookmark-Argument für den Namen des Lesezeichens als auch ein newText-Argument für die Zeichenfolge akzeptiert, die der Text-Eigenschaft zugewiesen werden soll.

Hinweis:
Durch Zuweisen von Text zu einer Bookmark.Text-Eigenschaft oder Bookmark.FormattedText-Eigenschaft eines Microsoft.Office.Tools.Word.Bookmark-Steuerelements wird das Lesezeichen nicht gelöscht.

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)
{

Weisen Sie die newText-Zeichenfolge der Text-Eigenschaft des Microsoft.Office.Tools.Word.Bookmark zu.
```
    bookmark.Text = newText
End Sub
```
```
    bookmark.Text = newText;
}
```

Verwenden von Word-Objekten

So aktualisieren Sie Lesezeicheninhalte mit einem Bookmark-Objekt in Word

Erstellen Sie eine Prozedur mit einem bookmark-Argument für den Namen des Microsoft.Office.Interop.Word.Bookmark und einem newText-Argument für die Zeichenfolge, die der Range.Text-Eigenschaft des Lesezeichens zugewiesen werden soll.

Hinweis:

Durch Zuweisen von Text zu einem systemeigenen Microsoft.Office.Interop.Word.Bookmark-Objekt in Word wird das Lesezeichen gelöscht.
```
Friend Sub BookMarkReplaceNative( _
    ByVal bookmark As Word.Bookmark, _
    ByVal newText As String)
```
```
internal void BookMarkReplaceNative(
    Word.Bookmark bookmark, 
    string newText)
{
```

Hinweis:
Durch Zuweisen von Text zu einem systemeigenen Microsoft.Office.Interop.Word.Bookmark-Objekt in Word wird das Lesezeichen gelöscht.

Weisen Sie der Range.Text-Eigenschaft des Lesezeichens die Zeichenfolge newText zu, wodurch das Lesezeichen automatisch gelöscht wird. Fügen Sie dann das Lesezeichen wieder der Bookmarks-Auflistung hinzu.

Das folgende Codebeispiel kann in einer Anpassung auf Dokumentebene verwendet werden.

    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); 
}

Das folgende Codebeispiel kann in einem Add-In auf Anwendungsebene verwendet werden. In diesem Beispiel wird das aktive Dokument verwendet.

    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);
}

Siehe auch

Aufgaben

Gewusst wie: Einfügen von Text in Word-Dokumente

Konzepte

Übersicht über das Word-Objektmodell

Bookmark-Steuerelement

Sdílet prostřednictvím