DocumentBase.SaveAs2 Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Salva o documento com um novo nome ou formato. Alguns dos argumentos para este método correspondem às opções na caixa de diálogo Salvar Como.

public void SaveAs2 (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, ref object compatibilityMode);

member this.SaveAs2 : obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj * obj -> unit

Public Sub SaveAs2 (Optional ByRef fileName As Object, Optional ByRef fileFormat As Object, Optional ByRef lockComments As Object, Optional ByRef password As Object, Optional ByRef addToRecentFiles As Object, Optional ByRef writePassword As Object, Optional ByRef readOnlyRecommended As Object, Optional ByRef embedTrueTypeFonts As Object, Optional ByRef saveNativePictureFormat As Object, Optional ByRef saveFormsData As Object, Optional ByRef saveAsAOCELetter As Object, Optional ByRef encoding As Object, Optional ByRef insertLineBreaks As Object, Optional ByRef allowSubstitutions As Object, Optional ByRef lineEnding As Object, Optional ByRef addBiDiMarks As Object, Optional ByRef compatibilityMode As Object)

Parâmetros

fileName: Object

O nome do documento. O padrão é a pasta atual e o nome de arquivo. Caso o documento jamais tenha sido salvo, o nome padrão é usado (por exemplo, Doc1.doc). Caso já exista um documento com o nome de arquivo especificado, o documento é substituído sem o usuário ser solicitado antes.

fileFormat: Object

O formato no qual o documento é salvo. Pode ser qualquer valor WdSaveFormat. Para salvar um documento em outro formato, especifique o valor apropriado para a propriedade SaveFormat.

lockComments: Object

true para bloquear o documento para comentários. O padrão é false.

password: Object

Uma cadeia de caracteres de senha para abrir o documento. (Consulte os comentários abaixo.)

addToRecentFiles: Object

true para adicionar o documento à lista de arquivos usados recentemente no menu Arquivo. O padrão é true.

writePassword: Object

Uma cadeia de caracteres de senha para salvar alterações no documento. (Consulte os comentários abaixo.)

readOnlyRecommended: Object

true para que o Microsoft Office Word sugira status somente leitura sempre que o documento for aberto. O padrão é false.

embedTrueTypeFonts: Object

true para salvar fontes TrueType com o documento. Se omitido, o EmbedTrueTypeFonts argumento pressupõe o valor da EmbedTrueTypeFonts propriedade .

saveNativePictureFormat: Object

Caso gráficos tenham sido importados de outra plataforma (por exemplo, Macintosh), true para salvar apenas a versão dos gráficos importados da versão do Windows.

saveFormsData: Object

true para salvar os dados inseridos por um usuário em um formulário como um registro de dados.

saveAsAOCELetter: Object

Caso o documento tenha um mensageiro anexado, true para salvar o documento como uma carta AOCE (o mensageiro é salvo).

encoding: Object

MsoEncoding. A página de código ou o conjunto de caracteres a ser usado para documentos salvos como arquivos de texto codificados. O padrão é a página de código do sistema.

insertLineBreaks: Object

Caso o documento seja salvo como um arquivo de texto, true para inserir quebras de linha ao final de cada linha de texto.

allowSubstitutions: Object

Caso o documento seja salvo como um arquivo de texto, true permite que o Word substitua alguns símbolos por texto semelhante. Por exemplo, exibindo o símbolo de direitos autorais como (c). O padrão é false.

lineEnding: Object

A maneira como o Word marca as quebras de linha e de parágrafo em documentos salvos como arquivos de texto. Pode ser qualquer valor T:Microsoft.Office.Interop.Word.WdLineEndingType.

addBiDiMarks: Object

true adiciona caracteres de controle ao arquivo de saída para preservar o layout bidirecional do texto no documento original.

compatibilityMode: Object

Um dos Microsoft.Office.Interop.Word.WdCompatibilityMode valores que especifica o modo de compatibilidade que Word 2013 e Word 2010 usa ao abrir o documento.

Exceções

MissingMemberException

Esta propriedade é usada em um projeto do Word 2007.

Exemplos

O exemplo de código a seguir usa o <xref:Microsoft.Office.Tools.Word.DocumentBase.SaveAs%2A> método para salvar o documento no formato RTF usando o novo nome de arquivo myfile.docx. Para usar esse exemplo, execute-o na classe ThisDocument em um projeto no nível de documento.

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

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

Comentários

Evite usar senhas codificadas nos aplicativos. Caso uma senha seja necessária em um procedimento, solicite a senha junto ao usuário, armazene-a em uma variável e, em seguida, use a variável no código.

Observação

Esse método aparece no IntelliSense em projetos Word 2007 direcionados ao .NET Framework 4. No entanto, essa propriedade não pode ser usada em projetos do Word 2007.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Aplica-se a

Compartilhar via