Bookmark.InsertFile-Methode

Artikel
08/10/2011

Fügt die gesamte oder einen Teil der angegebenen Datei in das Bookmark-Steuerelement ein.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
Sub InsertFile ( _
    FileName As String, _
    ByRef Range As Object, _
    ByRef ConfirmConversions As Object, _
    ByRef Link As Object, _
    ByRef Attachment As Object _
)

void InsertFile(
    string FileName,
    ref Object Range,
    ref Object ConfirmConversions,
    ref Object Link,
    ref Object Attachment
)

Parameter

FileName
Typ: System.String
Der Pfad und der Dateiname der einzufügenden Datei.Wenn Sie keinen Pfad angeben, geht Microsoft Office Word davon aus, dass sich die Datei im aktuellen Ordner befindet.

Range
Typ: System.Object%
Wenn die angegebene Datei ein Word-Dokument ist, verweist dieser Parameter auf ein Lesezeichen.Wenn die Datei ein anderer Dateityp ist (z. B. ein Microsoft Office Excel-Arbeitsblatt), verweist dieser Parameter auf einen benannten Bereich oder einen Zellenbereich (z. B. R1C1:R3C4).

ConfirmConversions
Typ: System.Object%
true, um von Word aufgefordert zu werden, die Konvertierung zu bestätigen, wenn Sie Dateien in Formaten einfügen, die nicht dem Format eines Word-Dokuments entsprechen.

Link
Typ: System.Object%
true, um die Datei mit einem wdFieldIncludeText-Feld einzufügen.

Attachment
Typ: System.Object%
true, um die Datei als Anhang in eine E-Mail-Nachricht einzufügen.

Hinweise

Durch Aufrufen dieser Methode wird möglicherweise das Bookmark-Steuerelement gelöscht.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird dem Dokument ein Lesezeichen-Steuerelement hinzugefügt und anschließend eine Datei in das Lesezeichen eingefügt. Dieses Beispiel setzt voraus, dass im Stammverzeichnis von C:\ ein Dokument mit dem Namen Sales.doc vorhanden ist.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub BookmarkInsertFile()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.InsertFile(FileName:="C:\Sales.doc", _
        ConfirmConversions:=False, Link:=False, _
        Attachment:=False)

End Sub

private void BookmarkInsertFile()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");

    string FileName = "C:\\Sales.doc";
    object ConfirmConversions = false;
    object Link = false;
    object Attachment = false;

    bookmark1.InsertFile(FileName, ref missing, ref ConfirmConversions,
        ref Link, ref Attachment);
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Bookmark Schnittstelle

Microsoft.Office.Tools.Word-Namespace

Freigeben über