SaveSetting (Función)

Artículo
10/07/2008

Actualización: noviembre 2007

Guarda o crea una entrada para una aplicación en el Registro de Windows.

La característica My proporciona mayor productividad y rendimiento en las operaciones del Registro que si se utiliza SaveSetting. Para obtener más información, vea My.Computer.Registry (Objeto).

Public Sub SaveSetting( _
   ByVal AppName As String, _ 
   ByVal Section As String, _
   ByVal Key As String, _
   ByVal Setting As String _
)

Parámetros

AppName
Requerido. Expresión de tipo String que contiene el nombre de la aplicación o proyecto al que corresponde el valor.
Section
Requerido. Expresión de tipo String que contiene el nombre de la sección donde se va a guardar la clave.
Key
Requerido. Expresión de tipo String que contiene el nombre de la clave que se va a guardar.
Setting
Requerido. Expresión que contiene el valor que se va a asignar a Key.

Excepciones

Tipo de excepción	Número de error	Condición
ArgumentException	5	No se puede crear el Registro de clave o el usuario no ha iniciado la sesión.

Consulte la columna "Número de error" si está actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no estructurado. (Se puede comparar el número de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que sea posible, se debe considerar la sustitución de dicho control de errores por Información general sobre el control estructurado de excepciones de Visual Basic.

Comentarios

La función SaveSetting agrega la clave a HKEY_CURRENT_USER\Software\VB and VBA Program Settings.

Si por algún motivo no se puede guardar el valor de la clave, se produce un error

SaveSetting requiere que un usuario se conecte ya que funciona bajo la clave de Registro HKEY_LOCAL_USER, que no se activa hasta que un inicia la sesión de forma interactiva.

Los valores de configuración del Registro a los que se va a tener acceso mediante un proceso no interactivo (como Mtx.exe) deben almacenarse bajo las claves del Registro HKEY_LOCAL_MACHINE\Software\ o HKEY_USER\DEFAULT\Software.

SaveSetting requiere un Permiso de Registro de Write y Create.

Ejemplo

En el siguiente ejemplo primero se utiliza la función SaveSetting para crear entradas en el Registro de Windows para la aplicación MyApp y, a continuación, se utiliza la función DeleteSetting para quitarlas.

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp","Startup", "Left", "50")
' Remove Startup section and all its settings from registry.
DeleteSetting ("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting ("MyApp")