DocumentBase.SaveAs (Método)
Guarda el documento con un nuevo nombre o formato.Algunos de los argumentos de este método corresponden a las opciones del cuadro de diálogo Guardar como.
Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word.v4.0.Utilities (en Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Sintaxis
'Declaración
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%
Nombre del documento.El valor predeterminado es el nombre de archivo y la carpeta actuales.Si el documento no se había guardado nunca, se utiliza el nombre predeterminado (por ejemplo, Doc1.doc).Si ya existe un documento con el nombre de archivo especificado, el documento se sobrescribe sin preguntar antes al usuario.
- fileFormat
Tipo: System.Object%
Formato con el que se guarda el documento.Puede ser cualquier valor de WdSaveFormat.Para guardar un documento con otro formato, especifique el valor adecuado para la propiedad SaveFormat.
- lockComments
Tipo: System.Object%
true para bloquear el documento frente a los comentarios.El valor predeterminado es false.
- password
Tipo: System.Object%
Cadena que es una contraseña para abrir el documento.Vea la sección Comentarios más adelante.
- addToRecentFiles
Tipo: System.Object%
true para agregar el documento a la lista de archivos utilizados recientemente del menú Archivo.De manera predeterminada, es true.
- writePassword
Tipo: System.Object%
Cadena que es una contraseña para guardar cambios en el documento.Vea la sección Comentarios más adelante.
- readOnlyRecommended
Tipo: System.Object%
true para que Microsoft Office Word recomiende el estado de sólo lectura cada vez que se abre el documento.El valor predeterminado es false.
- embedTrueTypeFonts
Tipo: System.Object%
true para guardar las fuentes TrueType con el documento.Si se omite, el argumento EmbedTrueTypeFonts adquiere el valor de la propiedad EmbedTrueTypeFonts.
- saveNativePictureFormat
Tipo: System.Object%
Si los gráficos se importan desde otra plataforma (por ejemplo, Macintosh), true para guardar sólo la versión para Windows de los gráficos importados.
- saveFormsData
Tipo: System.Object%
true para guardar los datos escritos por un usuario en un formulario como registro de datos.
- saveAsAOCELetter
Tipo: System.Object%
Si el documento tiene un programa de correo electrónico asociado, true para guardar el documento como una carta AOCE (Apple's Open Collaboration Environment) y guardar también el programa de correo electrónico asociado.
- encoding
Tipo: System.Object%
MsoEncoding .Página de códigos o juego de caracteres que se usará en los documentos guardados como archivos de texto codificados.El valor predeterminado es la página de códigos del sistema.
- insertLineBreaks
Tipo: System.Object%
Si el documento se guarda como archivo de texto, true para insertar saltos de línea al final de cada línea de texto.
- allowSubstitutions
Tipo: System.Object%
Si el documento se guarda como archivo de texto, true permite que Word reemplace algunos símbolos con texto de aspecto similar.Por ejemplo, mostrando el símbolo de copyright como (c).El valor predeterminado es false.
- lineEnding
Tipo: System.Object%
Manera en que Word marca los saltos de línea y de párrafo en los documentos guardados como archivos de texto.Puede ser cualquier valor de WdLineEndingType.
- addBiDiMarks
Tipo: System.Object%
true agrega los caracteres de control al archivo de salida para conservar el diseño bidireccional del texto en el documento original.
Comentarios
Evite el uso de contraseñas incluidas en el código de las aplicaciones.Si se requiere una contraseña en un procedimiento, solicite al usuario la contraseña, almacénela en una variable y, a continuación, utilice la variable en el código.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
El ejemplo de código siguiente se utiliza el método de SaveAs para guardar el documento en formato RTF con el nuevo nombre de archivo myfile.docx.Para usar este ejemplo, ejecútelo desde la clase ThisDocument en un proyecto de nivel de documento.
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);
}
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.