Métodos de extensión (Guía de programación de C#

)
Visual Studio 2010 Otras versiones

y

Visual Studio 2008

Los métodos de extensión permiten "agregar" métodos a los tipos existentes sin necesidad de crear un nuevo tipo derivado y volver a compilar o sin necesidad de modificar el tipo original. Los métodos de extensión constituyen un tipo especial de método estático, pero se les llama como si se tratasen de métodos de instancia en el tipo extendido. En el caso del código de cliente escrito en C# y Visual Basic, no existe ninguna diferencia aparente entre llamar a un método de extensión y llamar a los métodos realmente definidos en un tipo. Los métodos de extensión más comunes son los operadores de consulta estándares LINQque agregan la funcionalidad de la consulta a los tipos System.Collections.Generic.IEnumerable<T> y los System.Collections.IEnumerable existentes. utilizar los operadores de consulta estándares, primero introdúzcalos en el ámbito con una directiva using System.Linq. Después, cualquier tipo que implemente IEnumerable<T> parecerá tener métodos de instancia como GroupBy, OrderBy, Average, etc. Puede ver estos métodos adicionales con la característica de finalización de instrucciones IntelliSense al escribir un "punto" después de una instancia de un tipo IEnumerable<T> como List<T> o Array. En el ejemplo siguiente se muestra cómo llamar al método de operador de consulta estándar OrderBy en una matriz de enteros. La expresión entre paréntesis es una expresión lambda. Muchos operadores de consulta estándar usan expresiones lambda como parámetros, pero no es obligatorio para los métodos de extensión. Para obtener más información, vea Expresiones lambda (Guía de programación de C#).

VB C# C++

En el ejemplo siguiente se muestra un método de extensión definido para la clase System.OrderBy(g => g). El primer parámetro especifica en qué tipo actúa el método y va precedido del modificador this.F# JScript class ExtensionMethods2 { static void Main() { int[] ints = { 10. 15. 26 }. 39.Write(i + " "). 45. foreach (var i in result) { System.String. var result = ints. 21. Observe que se define dentro de una clase estática no anidada y no genérica: VB C# C++ F# JScript . Los métodos de extensión sólo se incluyen en el ámbito cuando el espacio de nombres se importa explícitamente al código fuente con una directiva using. } } } //Output: 10 15 21 26 39 45 Los métodos de extensión se definen como métodos estáticos pero se llaman utilizando la sintaxis de los métodos de instancia.Console.

} } } El método de extensión WordCount se puede incluir en el ámbito con esta directiva using: using ExtensionMethods. no se requieren conocimientos especiales para usarlos desde el código de cliente. Dado que se llama a los métodos de extensión con sintaxis de método de instancia.Length.namespace ExtensionMethods { public static class MyExtensions { public static int WordCount(this String str) { return str. Sin embargo. Por lo tanto. agregue esta directiva using a su código: . para utilizar los operadores de consulta estándar. el lenguaje intermedio (IL) generado por el compilador convierte el código en una llamada en el método estático. simplemente agregue una directiva using para el espacio de nombres en el que se definen los métodos. Para obtener más información. no se infringe realmente el principio de encapsulación.Split(new char[] { ' '. int i = s. vea Cómo: Implementar e invocar un método de extensión personalizado (Guía de programación de C#). De hecho. También se puede llamar desde una aplicación con esta sintaxis: string s = "Hello Extension Methods".RemoveEmptyEntries). '.WordCount(). En general. '?' }. Para habilitar los métodos de extensión para un tipo determinado. los métodos de extensión no pueden tener acceso a las variables privadas del tipo que extienden. el método de extensión se invoca con sintaxis de método de instancia.'. StringSplitOptions. probablemente llamará a métodos de extensión con mayor frecuencia de lo que implementará los suyos propios. Por ejemplo. En el código.

using System.Linq. en caso de que exista.) Observará que los operadores de consulta estándar ahora aparecen en IntelliSense como métodos adicionales disponibles para la mayoría de los tipos IEnumerable<T>. buscará cualquier método de extensión definido para el tipo y establecerá el enlace con el primer método de extensión que encuentre. Nota Aunque no aparezcan operadores de consulta estándar en IntelliSense para String. si un tipo tiene un método denominado Process(int i) y hay un método de extensión con la misma firma.dll.Core. Si el compilador no encuentra un método de instancia con una firma coincidente. Nunca se llamará a un método de extensión que tenga el mismo nombre y firma que un método de interfaz o clase. B y C implementan la interfaz. establecerá el enlace con un método de extensión coincidente. pero no para invalidarlas. (Puede que tenga que agregar también una referencia a System. siguen estando disponibles. La clase estática Extensions contiene métodos de extensión definidos para cualquier tipo que implementa IMyInterface. Si no la encuentra. En el ejemplo siguiente se muestra cómo el compilador determina con qué método de extensión o método de instancia establecerá el enlace. Nunca se llama al método de extensión MethodB porque su nombre y firma coinciden exactamente con métodos ya implementados por las clases. En otras palabras. Ejemplo En el ejemplo siguiente se muestran las reglas que sigue el compilador de C# para determinar si debe establecer un enlace entre una llamada a método y un método de instancia del tipo o un método de extensión. Las clases A. el compilador siempre establecerá el enlace con el método de instancia. . Cuando el compilador encuentra una invocación de método. Enlazar métodos de extensión en tiempo de compilación Puede utilizar métodos de extensión para extender una clase o una interfaz. los métodos de extensión siempre tienen menos prioridad que los métodos de instancia definidos en el propio tipo. En tiempo de compilación. busca primero una coincidencia entre los métodos de instancia del tipo.

int i)"). } // This method is never called in ExtensionMethodsDemo1. public interface IMyInterface { // Any class that implements IMyInterface must define a method // that matches the following signature.WriteLine ("Extension. public static class Extension { public static void MethodA(this IMyInterface myInterface. string s)"). } } // Define namespace { using using extension methods for IMyInterface.MethodA(this IMyInterface myInterface. because each . DefineIMyInterface. Extensions System.WriteLine ("Extension.VB C# C++ F# JScript // Define an interface named IMyInterface. } public static void MethodA(this IMyInterface myInterface. namespace DefineIMyInterface { using System. int i) { Console. void MethodB(). string s) { Console.MethodA(this IMyInterface myInterface. // The following extension methods can be accessed by instances of any // class that implements IMyInterface.

MethodA with an int argument // -.WriteLine("C. so each call to MethodA resolves to .MethodA(object obj)").WriteLine("B.WriteLine("C. using DefineIMyInterface. call the following methods: // -. B b = new B(). namespace ExtensionMethodsDemo1 { using System. } public void MethodA(int i) { Console. using Extensions. A a = new A().WriteLine("B. B.WriteLine ("Extension. // A contains no MethodA. } public void MethodA(object obj) { Console.MethodB()"). and then use them to test // the extension methods. // For a. } } class B : IMyInterface { public void MethodB() { Console. and class C. public static void MethodB(this IMyInterface myInterface) { Console. b.MethodA with a string argument // -. class A : IMyInterface { public void MethodB() { Console. } } class ExtMethodDemo { static void Main(string[] args) { // Declare an instance of class A. } } class C : IMyInterface { public void MethodB() { Console. C c = new C(). and c.WriteLine("A.MethodB(this IMyInterface myInterface)"). and C implements a method named MethodB // that has a matching signature.// of the three classes A.MethodA(int i)"). } } } // Define three classes that implement IMyInterface. class B.MethodB()").MethodB()").MethodB with no argument.

Para obtener más información.MethodB() Extension. // Extension. Al utilizar un método de extensión para extender un tipo cuyo código fuente no se puede cambiar.MethodA(object. c. Si implementa métodos de extensión para un tipo determinado. // C contains an instance method that matches each of the following // method calls. c.MethodA(object) // C.MethodA(1). string s) A. // Extension.MethodA("hello"). // B. int i) Extension. debe hacerlo creando un nuevo tipo derivado del existente. sólo cuando sea necesario.MethodA(1). vea Herencia (Guía de programación de C#).// the extension method that has a matching signature. Siempre que sea posible.MethodB() // B has no matching method for the following call. a. recuerde los dos puntos siguientes: . string s) C.MethodB().MethodA(1).MethodA(int) b. but // class Extension does.MethodA("hello").MethodA(object.MethodB() // B has methods that match the signatures of the following // nethod calls. // B.MethodA(object) // C.MethodA(object.MethodB(). int) a. // A. // Extension.MethodA(this IMyInterface myInterface.MethodA(this IMyInterface myInterface. string) // A has a method that matches the signature of the following call // to MethodB. cuando el código de cliente debe extender un tipo existente.MethodA(object obj) C. corre el riesgo de que un cambio en la implementación del tipo interrumpa su método de extensión.MethodA(object obj) C. c. b.MethodB() B. a.MethodA(this IMyInterface myInterface.MethodA("hello").MethodB() */ // C. string) b. recomendamos que implemente métodos de extensión en contadas ocasiones. } } } /* Output: Extension.MethodB() Instrucciones generales En general.MethodA(int i) B.MethodB().

Por ejemplo. Los métodos de extensión se incluyen en el ámbito en el nivel de espacio de nombres.y y Nunca se llamará a un método de extensión si tiene la misma firma que un método definido en el tipo. si tiene varias clases estáticas que contienen métodos de extensión en un espacio de nombres único denominado Extensions. los incluirá a todos en el ámbito. la directiva using Extensions. Vea también Referencia Expresiones lambda (Guía de programación de C#) Conceptos Guía de programación de C# Información general sobre operadores de consulta estándar Otros recursos Conversion rules for Instance parameters and their impact Extension methods Interoperability between languages Extension methods and Curried Delegates Extension method Binding and Error reporting Historial de cambios .

Sign up to vote on this title
UsefulNot useful