Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

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

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
Tipo: System.String
Nombre del valor que se va a recuperar. Esta cadena no distingue entre mayúsculas y minúsculas.
defaultValue
Tipo: System.Object
Valor que se devuelve si name no existe.
options
Tipo: Microsoft.Win32.RegistryValueOptions
Uno de los valores de enumeración que especifica el procesamiento opcional del valor recuperado.

Valor devuelto

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

ExcepciónCondición
SecurityException

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

ObjectDisposedException

El objeto RegistryKey que contiene el valor especificado está cerrado (no se puede tener acceso a claves cerradas).

IOException

El objeto RegistryKey que contiene el valor especificado se ha marcado para su eliminación.

ArgumentException

options no es un valor RegistryValueOptions válido; por ejemplo, un valor no válido se convierte a 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 para recuperar la cadena sin expandir las variables de entorno incrustadas.

Utilice el parámetro defaultValue para especificar el valor que se debe devolver si name no existe.

NotaNota

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 "(Valor predeterminado)" aparece en lugar de un nombre. Para recuperar este valor sin nombre, especifique null o la cadena vacía ("") para name.

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

En el siguiente ejemplo de código se crea una clave de prueba, se agrega un valor con una variable de entorno incrustada y se 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


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft