DeleteSetting (Función)
Actualización: noviembre 2007
Elimina una sección o una clave de la entrada de 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 la función DeleteSetting . Para obtener más información, vea My.Computer.Registry (Objeto).
Public Sub DeleteSetting( _
ByVal AppName As String, _
Optional ByVal Section As String = Nothing, _
Optional ByVal Key As String = Nothing _
)
Parámetros
AppName
Requerido. Expresión de tipo String que contiene el nombre de la aplicación o el proyecto al que corresponde la sección o clave.Section
Requerido. Expresión de tipo String que contiene el nombre de la sección de la que se va a eliminar la clave. Si sólo se proporcionan AppName y Section, se eliminará la sección especificada junto con todas las claves relacionadas.Key
Opcional. Expresión de tipo Stringque contiene el nombre de la clave que se va a eliminar.
Excepciones
Tipo de excepción |
Número de error |
Condición |
|---|---|---|
Section, AppName o Key no existen. |
||
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
Si se especifican todos los argumentos, se eliminará el valor indicado. Se producirá un error en tiempo de ejecución si se intenta utilizar DeleteSetting con una sección o clave inexistente.
DeleteSetting requiere que un usuario se conecte ya que funciona bajo la clave del 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.
Ejemplo
En el siguiente ejemplo primero se utiliza el procedimiento SaveSetting para crear entradas en el Registro de Windows para la aplicación MyApp y, a continuación, se usa la función DeleteSetting para quitarlas. Ya que no se ha especificado un argumento Key, se elimina toda la sección Startup, incluido el nombre de sección y todas sus claves.
' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp","Startup", "Left", "50")
' Remove section and all its settings from registry.
DeleteSetting ("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting ("MyApp")
Notas para desarrolladores de dispositivos inteligentes
Esta función no es compatible.
Requisitos
Espacio de nombres: Microsoft.VisualBasic
Módulo: Interaction
Ensamblado: Visual Basic Runtime Library (en Microsoft.VisualBasic.dll)