Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método RegistryKey.GetValue (String, Object, RegistryValueOptions)

 

Publicado: octubre de 2016

Recupera el valor asociado al nombre y a las opciones de recuperación especificados. Si no se encuentra el nombre, devuelve el valor predeterminado que se proporcione.

Espacio de nombres:   Microsoft.Win32
Ensamblado:  mscorlib (en mscorlib.dll)

[ComVisibleAttribute(false)]
public object GetValue(
	string name,
	object defaultValue,
	RegistryValueOptions options
)

Parámetros

name
Type: System.String

Nombre del valor que se va a recuperar. Esta cadena no distingue entre mayúsculas y minúsculas.

defaultValue
Type: System.Object

Valor que se devuelve si name no existe.

options
Type: Microsoft.Win32.RegistryValueOptions

Uno de los valores de enumeración que especifica el procesamiento opcional del valor recuperado.

Valor devuelto

Type: System.Object

Valor asociado a name, que se procesa según el valor especificado para options, o defaultValue si no se encuentra name.

Exception Condition
SecurityException

El usuario no tiene los permisos necesarios para leer la clave del registro.

ObjectDisposedException

El RegistryKey que contiene los valores especificados se cierra el valor (no hay acceso a las claves cerradas).

IOException

El RegistryKey que contiene los valores especificados valor se ha marcado para su eliminación.

ArgumentException

options no es válido RegistryValueOptions valor; por ejemplo, un valor no válido se convierte en RegistryValueOptions.

UnauthorizedAccessException

El usuario no tiene los derechos necesarios en el registro.

Utilice esta sobrecarga para especificar un procesamiento especial del valor recuperado. Por ejemplo, puede especificar RegistryValueOptions.DoNotExpandEnvironmentNames al recuperar un valor del registro de tipo RegistryValueKind.ExpandString recuperar la cadena sin expandir variables de entorno incrustadas.

Utilice la defaultValue parámetro para especificar el valor devuelto si name no existe.

System_CAPS_noteNota

Una clave del registro puede tener un valor que no esté asociado a ningún nombre. Cuando este valor sin nombre se muestra en el editor del registro, la cadena "(predeterminado)" aparece en lugar del nombre. Para recuperar este valor sin nombre, especifique null o una cadena vacía ("") para name.

GetValue no admite leer valores de tipo REG_NONE o REG_LINK. En ambos casos, el valor predeterminado (null) se devuelve en lugar del valor real.

El ejemplo de código siguiente crea una clave de prueba, agrega un valor a una variable de entorno incrustadas y recupera el valor en formato expandido y no expandido.

using System;
using Microsoft.Win32;
using Microsoft.VisualBasic;

public class Example
{
    public static void Main()
    {
        // Delete and recreate the test key.
        Registry.CurrentUser.DeleteSubKey("RegistryValueOptionsExample", false);
        RegistryKey rk = 
            Registry.CurrentUser.CreateSubKey("RegistryValueOptionsExample");

        // Add a value that contains an environment variable.
        rk.SetValue("ExpandValue", "The path is %PATH%", RegistryValueKind.ExpandString);

        // Retrieve the value, first without expanding the environment 
        // variable and then expanding it.
        Console.WriteLine("Unexpanded: \"{0}\"", 
            rk.GetValue("ExpandValue", "No Value", 
            RegistryValueOptions.DoNotExpandEnvironmentNames));
        Console.WriteLine("Expanded: \"{0}\"", rk.GetValue("ExpandValue"));
    } //Main
} //Example

RegistryPermission

to read from the registry. Associated enumeration: F:System.Security.Permissions.RegistryPermissionAccess.Read

EnvironmentPermission

to read a registry key of type REG_EXPAND_SZ. Associated enumeration: F:System.Security.Permissions.PermissionState.Unrestricted

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: