ref (Referencia de C#)

La palabra clave ref produce un argumento que se pasa por referencia, no por valor. El efecto de pasar por referencia es que cualquier cambio del parámetro en el método se refleja en la variable subyacente al argumento en el método de llamada. El valor de un parámetro de referencia es siempre igual al valor de la variable subyacente del argumento.

Nota
No confunda el concepto "pasar por referencia" con el concepto "tipos de referencia". Los dos conceptos no son iguales. ref puede modificar un parámetro de método sin tener en cuenta si es un tipo de valor o de referencia. No se produce la conversión boxing de un tipo de valor cuando se pasa por referencia.

Para usar un parámetro ref , la definición de método y el método de llamada deben explícitamente utilizar la palabra clave ref , como se muestra en el ejemplo siguiente.

    class RefExample
    {
        static void Method(ref int i)
        {
            // Rest the mouse pointer over i to verify that it is an int.
            // The following statement would cause a compiler error if i
            // were boxed as an object.
            i = i + 44;
        }

        static void Main()
        {
            int val = 1;
            Method(ref val);
            Console.WriteLine(val);

            // Output: 45
        }
    }

Un argumento que se pasa a un parámetro ref debe inicializar antes de que pase. Esto difiere de los parámetros out , cuyos argumentos no tienen que explícitamente inicializar antes de que se pasan. Para obtener más información, vea out.

Los miembros de una clase no pueden tener firmas que sólo difieren ref y out. Se produce un error del compilador si la única diferencia entre dos miembros de un tipo es que uno de ellos tiene un parámetro ref y otro tiene un parámetro out . El código siguiente, por ejemplo, no se compila.

class CS0663_Example
{
    // Compiler error CS0663: "Cannot define overloaded 
    // methods that differ only on ref and out".
    public void SampleMethod(out int i) { }
    public void SampleMethod(ref int i) { }
}

Sin embargo, la sobrecarga se puede hacer cuando un método tiene ref o parámetro out y el otro tiene un parámetro de valor, como se muestra en el ejemplo siguiente.

    class RefOverloadExample
    {
        public void SampleMethod(int i) { }
        public void SampleMethod(ref int i) { }
    }

En otras situaciones que requieren la firma coincidente, por ejemplo ocultar o reemplazar, ref y out es parte de la firma y no coincide.

Las propiedades no son variables. Son métodos, y no se pueden pasar a los parámetros ref .

Para obtener información sobre cómo pasar matrices, vea Pasar matrices mediante Ref y Out (Guía de programación de C#).

No puede usar palabras clave ref y out para los siguientes tipos de métodos:

• Métodos Async, que se define utilizando el modificador async .

• Métodos de iterador, que incluyen una instrucción retorno de producción o yield break .