Propiedad System.PrivateProfileString (Word)

  • Artículo

Devuelve o establece un valor string en un archivo de configuración o el registro de Microsoft Windows. String de lectura y escritura.

Sintaxis

expresión. PrivateProfileString( _FileName_ , _Section_ , _Key_ )

Expresión Expresión que devuelve un objeto 'System'.

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
FileName Necesario String Nombre del archivo de configuración. Si no se especifica ninguna ruta de acceso, se toma la carpeta de Windows.
Section Obligatorio String Nombre de la sección del archivo de configuración que contiene Key. En un archivo de configuración de Windows, el nombre de la sección aparece entre corchetes antes de las claves asociadas (no incluya los corchetes con Section). Si devuelve el valor de una entrada del Registro de Windows, Section debería ser la ruta de acceso completa a la subclave e incluir el subárbol, por ejemplo, "HKEY_CURRENT_USER\Software\Microsoft\Office\versión\Word\Options".
Key Obligatorio String Configuración de clave o el valor de una entrada del Registro que desee recuperar. En un archivo de configuración de Windows, el nombre de la clave va seguido de un signo igual (=) y del valor. Si devuelve el valor de una entrada del Registro de Windows, Key debería ser el nombre de una entrada de la subclave especificada en Section, por ejemplo, "STARTUP-PATH".

Comentarios

Puede escribir macros que usen un archivo de configuración para guardar y recuperar valores. Por ejemplo, puede guardar el nombre del documento activo al salir de Microsoft Word para que pueda volver a abrirse automáticamente la próxima vez que inicie Word. Un archivo de configuración es un archivo de texto con información organizada como la del archivo WIN.INI de Windows 3.x.

Ejemplo:

En este ejemplo se establece el nombre del documento actual con el valor de LastFile bajo el título MacroSettings en el archivo Settings.txt.

System.PrivateProfileString("C:\Settings.txt", "MacroSettings", _ 
 "LastFile") = ActiveDocument.FullName

En este ejemplo se devuelve el valor LastFile de Settings.txt y, a continuación, se abre el documento guardado en LastFile.

LastFile = System.PrivateProfileString("C:\Settings.Txt", _ 
 "MacroSettings", "LastFile") 
If LastFile <> "" Then Documents.Open FileName:=LastFile

En este ejemplo, se muestra el valor de la entrada EmailName del registro de Windows.

aName = System.PrivateProfileString("", _ 
 "HKEY_CURRENT_USER\Software\Microsoft\" _ 
 & "Windows\CurrentVersion\Internet Settings", "EmailName") 
MsgBox aName

Consulte también

Objeto del sistema

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.