Método DocumentBase.SaveAs
Salva o documento com um novo nome ou formato. Alguns dos argumentos para esse método correspondem às opções de Salvar como caixa de diálogo.
Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Sintaxe
'Declaração
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
)
Parâmetros
- fileName
Tipo: System.Object%
O nome do documento.O padrão é o nome de arquivo e pasta atual.Se nunca tiver sido salvo o documento, o nome padrão é usado (por exemplo, doc1).Se um documento com o nome de arquivo especificado já existir, o documento será sobrescrito sem que o usuário seja alertado antes.
- fileFormat
Tipo: System.Object%
O formato no qual o documento for salvo.Pode ser qualquer WdSaveFormat valor.Para salvar um documento em outro formato, especifique o valor apropriado para o SaveFormat propriedade.
- lockComments
Tipo: System.Object%
true para bloquear o documento para comentários.The default is false.
- password
Tipo: System.Object%
Uma seqüência de senha para abrir o documento.(Consulte comentários abaixo).
- addToRecentFiles
Tipo: System.Object%
true Para adicionar o documento à lista de arquivos usados recentemente sobre o arquivo menu.The default is true.
- writePassword
Tipo: System.Object%
Uma seqüência de senha para salvar as alterações no documento.(Consulte comentários abaixo).
- readOnlyRecommended
Tipo: System.Object%
true Microsoft Office de ter o Word sugira o status somente leitura sempre que o documento for aberto.The default is false.
- embedTrueTypeFonts
Tipo: System.Object%
true Para salvar as fontes TrueType com o documento.Se omitido, o EmbedTrueTypeFonts argumento supõe que o valor da EmbedTrueTypeFonts propriedade.
- saveNativePictureFormat
Tipo: System.Object%
Se os elementos gráficos importados de outra plataforma (por exemplo, Macintosh), true para salvar apenas a versão do Windows de elementos gráficos importados.
- saveFormsData
Tipo: System.Object%
true Para salvar os dados inseridos pelo usuário em um formulário como um registro de dados.
- saveAsAOCELetter
Tipo: System.Object%
Se o documento tiver um Mensageiro anexado, true para salvar o documento como uma carta AOCE (o Mensageiro é salvo).
- encoding
Tipo: System.Object%
MsoEncoding .A página de código ou conjunto de caracteres a ser usado para documentos salvos como arquivos de texto codificado.O padrão é a página de código do sistema.
- insertLineBreaks
Tipo: System.Object%
Se o documento é salvo como um arquivo de texto, true para inserir quebras de linha no final de cada linha do texto.
- allowSubstitutions
Tipo: System.Object%
Se o documento é salvo como um arquivo de texto, true permite que o Word substitua alguns símbolos por texto similar.Por exemplo, exibindo o símbolo de direito autoral como (c).The default is false.
- lineEnding
Tipo: System.Object%
A maneira como o Word marca a linha e parágrafo quebras em documentos salvos como arquivos de texto.Pode ser qualquer WdLineEndingType valor.
- addBiDiMarks
Tipo: System.Object%
true adiciona caracteres de controle para o arquivo de saída para preservar o layout bidirecional do texto no documento original.
Comentários
Evite usar senhas embutidas em seus aplicativos. Se for necessária uma senha em um procedimento, solicite a senha do usuário, armazená-lo em uma variável e, em seguida, use a variável no seu código.
Optional Parameters
Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.
Exemplos
O seguinte exemplo de código usa a SaveAs método para salvar o documento no formato RTF, usando o novo nome de arquivo MeuArquivo. Para usar esse exemplo, executá-lo do ThisDocument a classe em um projeto de nível de documento.
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);
}
}
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.