Exportar (0) Imprimir
Expandir todo

Attribute.Match (Método)

Actualización: noviembre 2007

Cuando se reemplaza en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.

Espacio de nombres:  System
Ensamblado:  mscorlib (en mscorlib.dll)

public virtual bool Match(
	Object obj
)
public boolean Match(
	Object obj
)
public function Match(
	obj : Object
) : boolean

Parámetros

obj
Tipo: System.Object
Object que se va a comparar con esta instancia de Attribute.

Valor devuelto

Tipo: System.Boolean
Es true si esta instancia es igual a obj; en caso contrario, es false.

Este método determina si un Attribute es igual a otro. La implementación predeterminada es la misma que Equals, que realiza la comparación de un valor y una referencia. Reemplace este método para implementar funcionalidad para valores de atributo, como indicadores o campos de bits, que constan de componentes con relevancia propia.

Por ejemplo, supongamos que existe un atributo cuyo valor es un campo binario dividido en un campo de bits de indicadores. Dos instancias de este atributo tienen un indicador en común mientras que todos los demás indicadores difieren. El método Equals no puede determinar si las dos instancias tienen el mismo indicador, pero el método Match sí puede.

En el siguiente ejemplo de código se muestra el uso de Match en el contexto de Attribute.

using System;
using System.Reflection;

namespace MatchCS {
	// A custom attribute to allow 2 authors per method.
	public class AuthorsAttribute : Attribute {
		public AuthorsAttribute(string name1, string name2) {
			authorName1 = name1;
			authorName2 = name2;
		}

		protected string authorName1;
		protected string authorName2;
	
		public string AuthorName1 {
			get { return authorName1; }
			set { authorName1 = AuthorName1; }
		}

		public string AuthorName2 {
			get { return authorName2; }
			set { authorName2 = AuthorName2; }
		}

		// Use the hash code of the string objects and xor them together.
		public override int GetHashCode() {
			return authorName1.GetHashCode() ^ authorName2.GetHashCode();
		}

		// Determine if the object is a match to this one.
		public override bool Match(object obj) {
			// Obviously a match.
			if (obj == this)
				return true;

			// Obviously we're not null, so no.
			if (obj == null)
				return false;

			if (obj is AuthorsAttribute)
				// Combine the hash codes and see if they're unchanged.
				return (((AuthorsAttribute)obj).GetHashCode() & GetHashCode())
					== GetHashCode();
			else
				return false;
		}
	}

	// Add some authors to methods of a class.
	public class TestClass1 {
		[Authors("William Shakespeare", "Herman Melville")]
		public void Method1()
		{}

		[Authors("Leo Tolstoy", "John Milton")]
		public void Method2()
		{}
	}

	// Add authors to a second class's methods.
	public class TestClass2 {
		[Authors("William Shakespeare", "Herman Melville")]
		public void Method1()
		{}

		[Authors("Leo Tolstoy", "John Milton")]
		public void Method2()
		{}

		[Authors("William Shakespeare", "John Milton")]
		public void Method3()
		{}
	}

	class DemoClass {
		static void Main(string[] args) {
			// Get the type for both classes to access their metadata.
			Type clsType1 = typeof(TestClass1);
			Type clsType2 = typeof(TestClass2);

			// Iterate through each method of the first class.
			foreach(MethodInfo mInfo1 in clsType1.GetMethods()) {
				// Check each method for the Authors attribute.
				AuthorsAttribute authAttr1 = (AuthorsAttribute)
					Attribute.GetCustomAttribute(mInfo1, 
					typeof(AuthorsAttribute));
				if (authAttr1 != null) {
					// Display the authors.
					Console.WriteLine("Method {0} was authored by {1} " +
										"and {2}.", mInfo1.Name, 
										authAttr1.AuthorName1, 
										authAttr1.AuthorName2);
					// Iterate through each method of the second class.
					foreach(MethodInfo mInfo2 in clsType2.GetMethods()) {
						// Check each method for the Authors attribute.
						AuthorsAttribute authAttr2 = (AuthorsAttribute)
							Attribute.GetCustomAttribute(mInfo2, 
							typeof(AuthorsAttribute));
						// Compare with the authors in the first class.
						if (authAttr2 != null && authAttr2.Match(authAttr1))
							Console.WriteLine("Method {0} in class {1} " +
								"was authored by the same team.",
								mInfo2.Name, clsType2.Name);
					}
					Console.WriteLine("");
				}
			}
		}
	}
}

/*
 * Output:
 * Method Method1 was authored by William Shakespeare and Herman Melville.
 * Method Method1 in class TestClass2 was authored by the same team.
 *
 * Method Method2 was authored by Leo Tolstoy and John Milton.
 * Method Method2 in class TestClass2 was authored by the same team.
 */


package MatchJSL;

import System.*;
import System.Reflection.*;

// A custom attribute to allow 2 authors per method.
/** @attribute AttributeUsage(AttributeTargets.Method, AllowMultiple = true)
 */
public class AuthorsAttribute extends Attribute
{
    public AuthorsAttribute(String name1, String name2)
    {
        authorName1 = name1;
        authorName2 = name2;
    } //AuthorsAttribute

    protected String authorName1;
    protected String authorName2;

    /** @property 
     */
    public String get_AuthorName1()
    {
        return authorName1;
    } //get_AuthorName1

    /** @property 
     */
    public void set_AuthorName1(String value)
    {
        authorName1 = value;
    } //set_AuthorName1

    /** @property 
     */
    public String get_AuthorName2()
    {
        return authorName2;
    } //get_AuthorName2

    /** @property 
     */
    public void set_AuthorName2(String value)
    {
        authorName2 = value;
    } //set_AuthorName2

    // Use the hash code of the string objects and xor them together.
    public int GetHashCode()
    {
        return authorName1.GetHashCode() ^ authorName2.GetHashCode();
    } //GetHashCode

    // Determine if the object is a match to this one.
    public boolean Match(Object obj)
    {
        // Obviously a match.
        if (obj.Equals(this)) {
            return true;
        }
        // Obviously we're not null, so no.
        if (obj == null) {
            return false;
        }

        if (obj instanceof AuthorsAttribute) {
            // Combine the hash codes and see if they're unchanged.
            return (((AuthorsAttribute)obj).GetHashCode() & GetHashCode())
                == GetHashCode();
        }
        else {
            return false;
        }
    } //Match
} //AuthorsAttribute

// Add some authors to methods of a class.
public class TestClass1
{
    /** @attribute Authors("William Shakespeare", "Herman Melville")
     */
    public void Method1()
    {
    } //Method1

    /** @attribute Authors("Leo Tolstoy", "John Milton")
     */
    public void Method2()
    {
    } //Method2
} //TestClass1

// Add authors to a second class's methods.
public class TestClass2
{
    /** @attribute Authors("William Shakespeare", "Herman Melville")
     */
    public void Method1()
    {
    } //Method1

    /** @attribute Authors("Leo Tolstoy", "John Milton")
     */
    public void Method2()
    {
    } //Method2

    /** @attribute Authors("William Shakespeare", "John Milton")
     */
    public void Method3()
    {
    } //Method3
} //TestClass2

class DemoClass
{
    public static void main(String[] args)
    {
        // Get the type for both classes to access their metadata.
        Type clsType1 = TestClass1.class.ToType();
        Type clsType2 = TestClass2.class.ToType();

        // Iterate through each method of the first class.
        for (int iCtr1 = 0; iCtr1 < clsType1.GetMethods().get_Length(); 
            iCtr1++) {
            MethodInfo mInfo1 = 
                (MethodInfo)clsType1.GetMethods().get_Item(iCtr1);

            // Check each method for the Authors attribute.
            AuthorsAttribute authAttr1 = 
                (AuthorsAttribute)Attribute.GetCustomAttribute(mInfo1, 
                AuthorsAttribute.class.ToType());
            if (authAttr1 != null) {
                // Display the authors.
                Console.WriteLine("Method {0} was authored by {1} " 
                    + "and {2}.", mInfo1.get_Name(), 
                    authAttr1.get_AuthorName1(), authAttr1.get_AuthorName2());

                // Iterate through each method of the second class.
                for (int iCtr2 = 0; iCtr2 < clsType1.GetMethods().get_Length(); 
                    iCtr2++) {
                    MethodInfo mInfo2 = (MethodInfo)clsType1.GetMethods().
                        get_Item(iCtr2);

                    // Check each method for the Authors attribute.
                    AuthorsAttribute authAttr2 = (AuthorsAttribute)Attribute.
                        GetCustomAttribute(mInfo2, 
                        AuthorsAttribute.class.ToType());

                    // Compare with the authors in the first class.
                    if (authAttr2 != null && authAttr2.Match(authAttr1)) {
                        Console.WriteLine("Method {0} in class {1} " 
                            + "was authored by the same team.", 
                            mInfo2.get_Name(), clsType2.get_Name());
                    }
                }
                Console.WriteLine("");
            }
        }
    } //main
} //DemoClass

/*
 * Output:
 * Method Method1 was authored by William Shakespeare and Herman Melville.
 * Method Method1 in class TestClass2 was authored by the same team.
 *
 * Method Method2 was authored by Leo Tolstoy and John Milton.
 * Method Method2 in class TestClass2 was authored by the same team.
 */


import System;
import System.Reflection;

package MatchJS {
    // A custom attribute to allow 2 authors per method.
    AttributeUsage(AttributeTargets.Method) public class AuthorsAttribute extends Attribute {
        public function AuthorsAttribute(name1 : String, name2 : String) {
            authorName1 = name1;
            authorName2 = name2;
        }

        protected var authorName1 : String;
        protected var authorName2 : String ;

        public function get AuthorName1() : String {
            return authorName1;
	}
        public function set AuthorName1( value: String ) {
            authorName1 = value;
        }

        public function get AuthorName2() : String {
            return authorName2;
        }

        public function set AuthorName2(value : String){
            authorName2 = AuthorName2;
        }

        // Use the hash code of the string objects and xor them together.
        public override function GetHashCode() : int {
	        return authorName1.GetHashCode() ^ authorName2.GetHashCode();
        }

        // Determine if the object is a match to this one.
        public override function Match(obj) : boolean {
            // Obviously a match.
            if (obj == this)
                return true;
            // Obviously we're not null, so no.
            if (obj == null)
                return false;

            if (obj instanceof AuthorsAttribute)
                // Combine the hash codes and see if they're unchanged.
                return (AuthorsAttribute(obj).GetHashCode() & GetHashCode())
                            == GetHashCode();
            else
                return false;
        }
    }

    // Add some authors to methods of a class.
    public class TestClass1 {
        Authors("William Shakespeare", "Herman Melville")
        public function Method1() : void 
        {}

        Authors("Leo Tolstoy", "John Milton")
        public function Method2() : void 
        {}
    }

    // Add authors to a second class's methods.
    public class TestClass2 {
        Authors("William Shakespeare", "Herman Melville")
        public function Method1() : void 
        {}

        Authors("Leo Tolstoy", "John Milton")
        public function Method2() : void
        {}

        Authors("William Shakespeare", "John Milton")
        public function Method3() : void 
        {}
    }

    class DemoClass {
        static function Main() : void {
            // Get the type for both classes to access their metadata.
            var clsType1 : Type = TestClass1;
            var clsType2 : Type = TestClass2;

            // Iterate through each method of the first class.
            var methods1 : MethodInfo[] = clsType1.GetMethods();
            for(var i : int in methods1) {
                var mInfo1 : MethodInfo = methods1[i];
                // Check each method for the Authors attribute.
                var authAttr1 : AuthorsAttribute = AuthorsAttribute(
	                Attribute.GetCustomAttribute(mInfo1, AuthorsAttribute));
                if (authAttr1 != null) {
	            // Display the authors.
	            Console.WriteLine("Method {0} was authored by {1} " +
						            "and {2}.", mInfo1.Name, 
						            authAttr1.AuthorName1, 
						            authAttr1.AuthorName2);
	            // Iterate through each method of the second class.
	            var methods2 : MethodInfo[] = clsType2.GetMethods()
	            for( var j : int in methods2) {
                        var mInfo2 : MethodInfo = methods2[j];
                        // Check each method for the Authors attribute.
                        var authAttr2 : AuthorsAttribute = AuthorsAttribute(
	                        Attribute.GetCustomAttribute(mInfo2, 
	                        AuthorsAttribute));
                        // Compare with the authors in the first class.
                        if (authAttr2 != null && authAttr2.Match(authAttr1))
	                        Console.WriteLine("Method {0} in class {1} " +
		                        "was authored by the same team.",
		                        mInfo2.Name, clsType2.Name);
	            }
	            Console.WriteLine("");
                }
            }
        }
    }
}

MatchJS.DemoClass.Main();

/*
 * Output:
 * Method Method1 was authored by William Shakespeare and Herman Melville.
 * Method Method1 in class TestClass2 was authored by the same team.
 *
 * Method Method2 was authored by Leo Tolstoy and John Milton.
 * Method Method2 in class TestClass2 was authored by the same team.
 */


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

XNA Framework

Compatible con: 2.0, 1.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft