Udostępnij za pośrednictwem

Metoda DocumentBase.SaveAs —

  • Artykuł

Zapisuje dokument pod nową nazwą lub w nowym formacie.Niektóre argumenty dotyczące tej metody odpowiadają opcjom w oknie dialogowym Zapisz jako.

Przestrzeń nazw:  Microsoft.Office.Tools.Word
Zestaw:  Microsoft.Office.Tools.Word.v4.0.Utilities (w Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Składnia

'Deklaracja
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
)

Parametry

  • fileName
    Typ: System.Object%
    Nazwa dokumentu.Wartością domyślną jest bieżąca nazwa plików i folderów.Jeśli dokument nie został wcześniej zapisany, używana jest domyślna nazwa (na przykład Doc1.doc).Jeśli dokument o podanej nazwie pliku już istnieje, jest on zastępowany bez uprzedniego pytania użytkownika o zgodę.
  • fileFormat
    Typ: System.Object%
    Format, w którym jest zapisany dokument.Może to być dowolną wartością WdSaveFormat.Aby zapisać dokument w innym formacie, należy określić odpowiednią wartość dla SaveFormat właściwości.
  • lockComments
    Typ: System.Object%
    true , aby zablokować dokumenty pod kątem komentarzy.Wartość domyślna to false.
  • password
    Typ: System.Object%
    Ciąg hasła do otwarcia dokumentu. (Zobacz uwagi poniżej).
  • addToRecentFiles
    Typ: System.Object%
    true , aby dodać dokument do listy ostatnio używanych plików w menu pliku.Wartość domyślna to true.
  • writePassword
    Typ: System.Object%
    Ciąg hasła do zapisywania zmian w dokumencie. (Zobacz uwagi poniżej).
  • readOnlyRecommended
    Typ: System.Object%
    true , aby program Microsoft Office Word zalecał status tylko do odczytu przy każdym otwarciu dokumentu.Wartość domyślna to false.
  • embedTrueTypeFonts
    Typ: System.Object%
    true , aby zapisać czcionki TrueType w dokumencie.Jeżeli pominięto ten parametr, EmbedTrueTypeFonts argument przyjmuje wartość EmbedTrueTypeFonts właściwości.
  • saveNativePictureFormat
    Typ: System.Object%
    Jeżeli grafikę importowano z innej platformy (na przykład Macintosha), true umożliwia zapisanie importowanej grafiki w wersji wyłącznie dla systemu Windows.
  • saveFormsData
    Typ: System.Object%
    true , aby zapisać dane wprowadzane przez użytkownika w formularzu jako rejestr danych.
  • saveAsAOCELetter
    Typ: System.Object%
    Jeśli dokument ma dołączonego mailera, true umożliwia zapisanie dokumentu w postaci listu AOCE (mailer został zapisany).
  • encoding
    Typ: System.Object%
    MsoEncoding .Strona kodowa lub zestaw znaków na potrzeby dokumentów zapisywanych jako zakodowane pliki tekstowe.Wartość domyślna to systemowa strona kodowa.
  • insertLineBreaks
    Typ: System.Object%
    Jeśli dokument zostanie zapisany jako plik tekstowy, true umożliwia wstawianie podziałów wiersza na końcu każdego wiersza tekstu.
  • allowSubstitutions
    Typ: System.Object%
    Jeśli dokument zostanie zapisany jako plik tekstowy, true pozwala programowi Word na zastąpienie niektórych symboli podobnie wyglądającym tekstem.Na przykład wyświetlanie symbolu praw autorskich jako (c).Wartość domyślna to false.
  • lineEnding
    Typ: System.Object%
    Sposób, w jaki program Word oznacza przerwy między wierszami i akapitami w dokumentach zapisywanych jako pliki tekstowe.Może to być dowolną wartością WdLineEndingType.
  • addBiDiMarks
    Typ: System.Object%
    true dodaje znaki kontrolne do pliku wyjściowego w celu zachowania dwukierunkowy układu tekstu w dokumencie.

Uwagi

Unikaj używania haseł z góry ustalonych w aplikacjach.Jeśli hasło jest wymagane w procedurze, należy zażądać hasła od użytkownika, zachować je w zmiennej, a następnie użyć zmiennej w kodzie.

Parametry opcjonalne

Informacje na temat parametrów opcjonalnych można wyświetlić na Parametry opcjonalne w rozwiązaniach Office.

Przykłady

Następujący kod w przykładzie wykorzystano SaveAs metody, aby zapisać dokument w formacie RTF, przy użyciu myfile.docx nową nazwę pliku.Aby wykorzystać ten przykład, należy uruchomić go z klasy ThisDocument w projekcie na poziomie dokumentu.

Private Sub DocumentSaveAs()

    Me.SaveAs(FileName:="myfile.docx", 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.docx";
    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);
    }
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

DocumentBase Klasa

Przestrzeń nazw Microsoft.Office.Tools.Word