Freigeben über

DocumentBase.SaveAs-Methode

  • Artikel

Speichert das Dokument unter einem neuen Namen oder Format. Einige der Argumente für diese Methode entsprechen den Optionen im Dialogfeld Speichern unter.

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

Syntax

'Declaration
Public Sub SaveAs ( _
    ByRef fileName As Object, _
    ByRef fileFormat As Object, _
    ByRef lockComments As Object, _
    ByRef password As Object, _
    ByRef addToRecentFiles As Object, _
    ByRef writePassword As Object, _
    ByRef readOnlyRecommended As Object, _
    ByRef embedTrueTypeFonts As Object, _
    ByRef saveNativePictureFormat As Object, _
    ByRef saveFormsData As Object, _
    ByRef saveAsAOCELetter As Object, _
    ByRef encoding As Object, _
    ByRef insertLineBreaks As Object, _
    ByRef allowSubstitutions As Object, _
    ByRef lineEnding As Object, _
    ByRef addBiDiMarks As Object _
)

public void SaveAs(
    ref Object fileName,
    ref Object fileFormat,
    ref Object lockComments,
    ref Object password,
    ref Object addToRecentFiles,
    ref Object writePassword,
    ref Object readOnlyRecommended,
    ref Object embedTrueTypeFonts,
    ref Object saveNativePictureFormat,
    ref Object saveFormsData,
    ref Object saveAsAOCELetter,
    ref Object encoding,
    ref Object insertLineBreaks,
    ref Object allowSubstitutions,
    ref Object lineEnding,
    ref Object addBiDiMarks
)

Parameter

  • fileName
    Typ: System.Object%
    Der Name für das Dokument.Standardmäßig werden der aktuelle Ordner und der Dateiname verwendet.Wenn das Dokument noch nicht gespeichert wurde, wird der Standardname verwendet (z. B. Doc1.doc).Wenn ein Dokument mit dem angegebenen Dateinamen bereits vorhanden ist, wird das Dokument überschrieben, ohne dass der Benutzer zur Bestätigung aufgefordert wird.
  • fileFormat
    Typ: System.Object%
    Das Format, in dem das Dokument gespeichert wird.Kann jeder WdSaveFormat-Wert sein.Um ein Dokument in einem anderen Format zu speichern, geben Sie den entsprechenden Wert für die SaveFormat-Eigenschaft an.
  • lockComments
    Typ: System.Object%
    true, wenn das Dokument für Kommentare gesperrt werden soll.Die Standardeinstellung ist false.
  • password
    Typ: System.Object%
    Eine Kennwortzeichenfolge zum Öffnen des Dokuments.(Siehe Hinweise unten.)
  • addToRecentFiles
    Typ: System.Object%
    true, wenn das Dokument der Liste der zuletzt geöffneten Dateien im Menü Datei hinzugefügt werden soll.Die Standardeinstellung ist true.
  • writePassword
    Typ: System.Object%
    Eine Kennwortzeichenfolge zum Speichern von Änderungen im Dokument.(Siehe Hinweise unten.)
  • readOnlyRecommended
    Typ: System.Object%
    true, wenn Microsoft Office Word den Schreibschutzmodus beim Öffnen eines Dokuments vorschlagen soll.Die Standardeinstellung ist false.
  • embedTrueTypeFonts
    Typ: System.Object%
    true, wenn TrueType-Schriftarten mit dem Dokument gespeichert werden sollen.Wenn diese Einstellung ausgelassen wird, nimmt das EmbedTrueTypeFonts-Argument den Wert der EmbedTrueTypeFonts-Eigenschaft an.
  • saveNativePictureFormat
    Typ: System.Object%
    Falls Grafiken von einer anderen Plattform importiert wurden (z. B. Macintosh) true, damit nur die Windows-Version der importierten Grafiken gespeichert wird.
  • saveFormsData
    Typ: System.Object%
    true, wenn die von einem Benutzer in ein Formular eingegebenen Daten als Datensatz gespeichert werden sollen.
  • saveAsAOCELetter
    Typ: System.Object%
    Wenn das Dokument ein angefügtes Adressfeld besitzt true, wenn das Dokument als AOCE-Brief gespeichert werden soll (das Adressfeld wird gespeichert).
  • encoding
    Typ: System.Object%
    MsoEncoding.Die Codepage bzw. der Zeichensatz, der für Dokumente verwendet wird, die als codierte Textdateien gespeichert wurden.Standardmäßig wird die Systemcodepage verwendet.
  • insertLineBreaks
    Typ: System.Object%
    Wenn das Dokument als Textdatei gespeichert wurde true, damit am Ende jeder Textzeile ein Zeilenumbruch eingefügt wird.
  • allowSubstitutions
    Typ: System.Object%
    Wenn das Dokument als Textdatei gespeichert wurde true, damit Word bestimmte Symbole durch Text ersetzen kann, der dem Symbol ähnelt.Beispiel: Anzeigen des Copyrightsymbols als (c).Die Standardeinstellung ist false.
  • lineEnding
    Typ: System.Object%
    Die Weise, in der Word Zeilenumbrüche und Absatzmarken in einem als Textdatei gespeicherten Dokument markiert.Kann jeder WdLineEndingType-Wert sein.
  • addBiDiMarks
    Typ: System.Object%
    true, wenn der Ausgabedatei Steuerzeichen hinzugefügt werden sollen, um das bidirektionale Layout des Texts im Originaldokument zu erhalten.

Hinweise

Verwenden Sie in Anwendungen keine hartcodierten Kennwörter. Wenn in einer Prozedur ein Kennwort erforderlich ist, fordern Sie es vom Benutzer an, speichern Sie es in einer Variablen, und verwenden Sie anschließend die Variable im Code.

Optionale Parameter

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

Beispiele

Im folgenden Codebeispiel wird das Dokument mithilfe der SaveAs-Methode unter dem neuen Dateinamen myfile.doc im RTF-Format gespeichert. Wenn Sie dieses Beispiel verwenden möchten, führen Sie es von der ThisDocument-Klasse in einem Projekt auf Dokumentebene aus.

Private Sub DocumentSaveAs()

    Me.SaveAs(FileName:="myfile.doc", FileFormat:=Word.WdSaveFormat.wdFormatRTF, _
        LockComments:=False, AddToRecentFiles:=True, ReadOnlyRecommended:=False, _
        EmbedTrueTypeFonts:=False, SaveNativePictureFormat:=True, _
        SaveFormsData:=True, SaveAsAOCELetter:=False, _
        Encoding:=Office.MsoEncoding.msoEncodingUSASCII, _
        InsertLineBreaks:=False, AllowSubstitutions:=False, _
        LineEnding:=Word.WdLineEndingType.wdCRLF, _
        AddBiDiMarks:=False)
End Sub

private void DocumentSaveAs()
{
    object FileName = "myfile.doc";
    object FileFormat = Word.WdSaveFormat.wdFormatRTF;
    object LockComments = false;
    object AddToRecentFiles = true;
    object ReadOnlyRecommended = false;
    object EmbedTrueTypeFonts = false;
    object SaveNativePictureFormat = true;
    object SaveFormsData = true;
    object SaveAsAOCELetter = false;
    object Encoding = Office.MsoEncoding.msoEncodingUSASCII;
    object InsertLineBreaks = false;
    object AllowSubstitutions = false;
    object LineEnding = Word.WdLineEndingType.wdCRLF;
    object AddBiDiMarks = false;

    if (this.SaveFormat == (int)Word.WdSaveFormat.wdFormatDocument)
    {
        this.SaveAs(ref FileName, ref FileFormat, ref LockComments,
            ref missing, ref AddToRecentFiles, ref missing,
            ref ReadOnlyRecommended, ref EmbedTrueTypeFonts,
            ref SaveNativePictureFormat, ref SaveFormsData,
            ref SaveAsAOCELetter, ref Encoding, ref InsertLineBreaks,
            ref AllowSubstitutions, ref LineEnding, ref AddBiDiMarks);
    }
}

.NET Framework-Sicherheit

Siehe auch

Referenz

DocumentBase Klasse

Microsoft.Office.Tools.Word-Namespace