DocumentBase.SaveAs – metoda
Uloží dokument s novým názvem nebo formátem.Některé argumenty pro tuto metodu odpovídají volbám v dialogovém okně Uložit jako.
Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word.v4.0.Utilities (v Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Syntaxe
'Deklarace
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%
Název dokumentuVýchozí hodnota je název aktuální složky a souboru.Pokud dokument ještě nebyl uložen, použije se výchozí název (například Doc1.doc).Pokud dokument se zadaným názvem již existuje, je dokument přepsán, aniž by se nejprve zobrazila výzva.
- fileFormat
Typ: System.Object%
Formát, ve kterém se dokument uloží.Může mít libovolnou hodnotu WdSaveFormat.Chcete-li dokument uložit v jiném formátu, zadejte příslušnou hodnotu pro SaveFormat vlastnost.
- lockComments
Typ: System.Object%
true pro uzamčení dokumentu pro komentářeVýchozí hodnota je false.
- password
Typ: System.Object%
Řetězec hesla pro otevření dokumentu (Viz poznámky níže)
- addToRecentFiles
Typ: System.Object%
true pro přidání dokumentu na seznam naposledy použitých souborů v nabídce Soubor.Výchozí hodnota je true.
- writePassword
Typ: System.Object%
Řetězec hesla pro uložení změn v dokumentu (Viz poznámky níže)
- readOnlyRecommended
Typ: System.Object%
true chcete-li, aby aplikace Microsoft Office Word vždy při otevření dokumentu navrhla stav jen pro čtení.Výchozí hodnota je false.
- embedTrueTypeFonts
Typ: System.Object%
true chcete-li uložit písma TrueType s dokumentem.Pokud je tento argument vynechán, EmbedTrueTypeFonts předpokládá argument hodnota EmbedTrueTypeFonts vlastnost.
- saveNativePictureFormat
Typ: System.Object%
Pokud jste obrázky importovali z jiné platformy (například Macintosh), nastavením hodnoty true uložíte pouze verzi importovaných obrázků pro systém Windows.
- saveFormsData
Typ: System.Object%
true chcete-li uložit data zadaná uživatelem do formuláře ve formě datového záznamu.
- saveAsAOCELetter
Typ: System.Object%
Pokud je k dokumentu připojen poštovní modul, nastavte hodnotu true pro uložení dokumentu ve formátu dopisu AOCE (poštovní modul se uloží).
- encoding
Typ: System.Object%
MsoEncoding .Znaková stránka nebo znaková sada, která se použije pro dokumenty uložené jako kódované textové soubory.Výchozí hodnota je znaková stránka systému.
- insertLineBreaks
Typ: System.Object%
Pokud je dokument uložen jako textový soubor, nastavením hodnoty true vložíte na konec každého řádku textu zalomení řádku.
- allowSubstitutions
Typ: System.Object%
Pokud je dokument uložen jako textový soubor, hodnota true umožní aplikaci Word nahradit některé symboly textem, který vypadá podobně.Například zobrazení symbolu copyright (c)Výchozí hodnota je false.
- lineEnding
Typ: System.Object%
Způsob, jakým aplikace Word označí zalomení řádku a odstavce v dokumentech uložených jako textové soubory.Může mít libovolnou hodnotu WdLineEndingType.
- addBiDiMarks
Typ: System.Object%
true Přidá řídicích znaků do výstupního souboru, chcete-li zachovat rozložení obousměrného textu v původním dokumentu.
Poznámky
V aplikacích nedoporučujeme používat pevně kódovaná hesla.Pokud je v postupu vyžadováno heslo, požádejte o heslo uživatele, uložte je v proměnné a proměnnou použijte ve svém kódu.
Volitelné parametry
Informace o volitelných parametrech naleznete v tématu Volitelné parametry v řešeních pro systém Office.
Příklady
Následující příklad kódu používá SaveAs metodu k uložení dokumentu ve formátu RTF pomocí nového myfile.docx název souboru.Chcete-li tento příklad použít, spusťte jej ze třídy ThisDocument v projektu na úrovni 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);
}
}
Zabezpečení rozhraní .NET Framework
- Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.