PropertyInfo Clase

Definición

Espacio de nombres:

System.Reflection

Ensamblados:

netstandard.dll, System.Runtime.dll

Source:

PropertyInfo.cs

Detecta los atributos de una propiedad y proporciona acceso a los metadatos de propiedad.

public ref class PropertyInfo abstract : System::Reflection::MemberInfo

public abstract class PropertyInfo : System.Reflection.MemberInfo

type PropertyInfo = class
    inherit MemberInfo

Public MustInherit Class PropertyInfo
Inherits MemberInfo

Herencia

Object

MemberInfo

PropertyInfo

Derivado

Microsoft.JScript.COMPropertyInfo

System.Reflection.Emit.PropertyBuilder

Ejemplos

En este ejemplo se muestra cómo usar varias clases de reflexión para analizar los metadatos contenidos en un ensamblado.

Nota:

Este ejemplo genera aproximadamente 55 000 líneas de datos, que puede redirigir a un archivo de texto en el símbolo del sistema, como se indica a continuación: example.exe > propertyinfo.txt

using System;
using System.Reflection;

class Module1
{
    public static void Main()
    {
        // This variable holds the amount of indenting that
        // should be used when displaying each line of information.
        Int32 indent = 0;
        // Display information about the EXE assembly.
        Assembly a = typeof(Module1).Assembly;
        Display(indent, "Assembly identity={0}", a.FullName);
        Display(indent+1, "Codebase={0}", a.CodeBase);

        // Display the set of assemblies our assemblies reference.

        Display(indent, "Referenced assemblies:");
        foreach (AssemblyName an in a.GetReferencedAssemblies() )
        {
             Display(indent + 1, "Name={0}, Version={1}, Culture={2}, PublicKey token={3}", an.Name, an.Version, an.CultureInfo.Name, (BitConverter.ToString (an.GetPublicKeyToken())));
        }
        Display(indent, "");

        // Display information about each assembly loading into this AppDomain.
        foreach (Assembly b in AppDomain.CurrentDomain.GetAssemblies())
        {
            Display(indent, "Assembly: {0}", b);

            // Display information about each module of this assembly.
            foreach ( Module m in b.GetModules(true) )
            {
                Display(indent+1, "Module: {0}", m.Name);
            }

            // Display information about each type exported from this assembly.

            indent += 1;
            foreach ( Type t in b.GetExportedTypes() )
            {
                Display(0, "");
                Display(indent, "Type: {0}", t);

                // For each type, show its members & their custom attributes.

                indent += 1;
                foreach (MemberInfo mi in t.GetMembers() )
                {
                    Display(indent, "Member: {0}", mi.Name);
                    DisplayAttributes(indent, mi);

                    // If the member is a method, display information about its parameters.

                    if (mi.MemberType==MemberTypes.Method)
                    {
                        foreach ( ParameterInfo pi in ((MethodInfo) mi).GetParameters() )
                        {
                            Display(indent+1, "Parameter: Type={0}, Name={1}", pi.ParameterType, pi.Name);
                        }
                    }

                    // If the member is a property, display information about the property's accessor methods.
                    if (mi.MemberType==MemberTypes.Property)
                    {
                        foreach ( MethodInfo am in ((PropertyInfo) mi).GetAccessors() )
                        {
                            Display(indent+1, "Accessor method: {0}", am);
                        }
                    }
                }
                indent -= 1;
            }
            indent -= 1;
        }
    }

    // Displays the custom attributes applied to the specified member.
    public static void DisplayAttributes(Int32 indent, MemberInfo mi)
    {
        // Get the set of custom attributes; if none exist, just return.
        object[] attrs = mi.GetCustomAttributes(false);
        if (attrs.Length==0) {return;}

        // Display the custom attributes applied to this member.
        Display(indent+1, "Attributes:");
        foreach ( object o in attrs )
        {
            Display(indent+2, "{0}", o.ToString());
        }
    }

    // Display a formatted string indented by the specified amount.
    public static void Display(Int32 indent, string format, params object[] param)

    {
        Console.Write(new string(' ', indent*2));
        Console.WriteLine(format, param);
    }
}

//The output shown below is abbreviated.
//
//Assembly identity=ReflectionCS, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null
//  Codebase=file:///C:/Documents and Settings/test/My Documents/Visual Studio 2005/Projects/Reflection/Reflection/obj/Debug/Reflection.exe
//Referenced assemblies:
//  Name=mscorlib, Version=2.0.0.0, Culture=, PublicKey token=B7-7A-5C-56-19-34-E0-89
//
//Assembly: mscorlib, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//  Module: mscorlib.dll
//
//  Type: System.Object
//    Member: GetType
//    Member: ToString
//    Member: Equals
//      Parameter: Type=System.Object, Name=obj
//    Member: Equals
//      Parameter: Type=System.Object, Name=objA
//      Parameter: Type=System.Object, Name=objB
//    Member: ReferenceEquals
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=System.Object, Name=objA
//      Parameter: Type=System.Object, Name=objB
//    Member: GetHashCode
//    Member: .ctor
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//
//  Type: System.ICloneable
//    Member: Clone
//
//  Type: System.Collections.IEnumerable
//    Member: GetEnumerator
//      Attributes:
//        System.Runtime.InteropServices.DispIdAttribute
//
//  Type: System.Collections.ICollection
//    Member: CopyTo
//      Parameter: Type=System.Array, Name=array
//      Parameter: Type=System.Int32, Name=index
//    Member: get_Count
//    Member: get_SyncRoot
//    Member: get_IsSynchronized
//    Member: Count
//      Accessor method: Int32 get_Count()
//    Member: SyncRoot
//      Accessor method: System.Object get_SyncRoot()
//    Member: IsSynchronized
//      Accessor method: Boolean get_IsSynchronized()
//
//  Type: System.Collections.IList
//    Member: get_Item
//      Parameter: Type=System.Int32, Name=index
//    Member: set_Item
//      Parameter: Type=System.Int32, Name=index
//      Parameter: Type=System.Object, Name=value
//    Member: Add
//      Parameter: Type=System.Object, Name=value
//    Member: Contains
//      Parameter: Type=System.Object, Name=value
//    Member: Clear
//    Member: get_IsReadOnly
//    Member: get_IsFixedSize
//    Member: IndexOf
//      Parameter: Type=System.Object, Name=value
//    Member: Insert
//      Parameter: Type=System.Int32, Name=index
//      Parameter: Type=System.Object, Name=value
//    Member: Remove
//      Parameter: Type=System.Object, Name=value
//    Member: RemoveAt
//      Parameter: Type=System.Int32, Name=index
//    Member: Item
//      Accessor method: System.Object get_Item(Int32)
//      Accessor method: Void set_Item(Int32, System.Object)
//    Member: IsReadOnly
//      Accessor method: Boolean get_IsReadOnly()
//    Member: IsFixedSize
//      Accessor method: Boolean get_IsFixedSize()
//
//  Type: System.Array
//    Member: IndexOf
//      Parameter: Type=T[], Name=array
//      Parameter: Type=T, Name=value
//    Member: AsReadOnly
//      Parameter: Type=T[], Name=array
//    Member: Resize
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=T[]&, Name=array
//      Parameter: Type=System.Int32, Name=newSize
//    Member: BinarySearch
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=T[], Name=array
//      Parameter: Type=T, Name=value
//    Member: BinarySearch
//      Attributes:
//        System.Runtime.ConstrainedExecution.ReliabilityContractAttribute
//      Parameter: Type=T[], Name=array
//      Parameter: Type=T, Name=value
//      Parameter: Type=System.Collections.Generic.IComparer`1[T], Name=comparer

Imports System.Reflection

Module Module1
    Sub Main()
        ' This variable holds the amount of indenting that 
        ' should be used when displaying each line of information.
        Dim indent As Int32 = 0
        ' Display information about the EXE assembly.
        Dim a As Assembly = GetType(Module1).Assembly
        Display(indent, "Assembly identity={0}", a.FullName)
        Display(indent + 1, "Codebase={0}", a.CodeBase)

        ' Display the set of assemblies our assemblies reference.
        Dim an As AssemblyName
        Display(indent, "Referenced assemblies:")
        For Each an In a.GetReferencedAssemblies()
            Display(indent + 1, "Name={0}, Version={1}, Culture={2}, PublicKey token={3}", _
                an.Name, an.Version, an.CultureInfo.Name, BitConverter.ToString(an.GetPublicKeyToken))
        Next
        Display(indent, "")

        ' Display information about each assembly loading into this AppDomain.
        For Each a In AppDomain.CurrentDomain.GetAssemblies()
            Display(indent, "Assembly: {0}", a)

            ' Display information about each module of this assembly.
            Dim m As [Module]
            For Each m In a.GetModules(True)
                Display(indent + 1, "Module: {0}", m.Name)
            Next

            ' Display information about each type exported from this assembly.
            Dim t As Type
            indent += 1
            For Each t In a.GetExportedTypes()
                Display(0, "")
                Display(indent, "Type: {0}", t)

                ' For each type, show its members & their custom attributes.
                Dim mi As MemberInfo
                indent += 1
                For Each mi In t.GetMembers()
                    Display(indent, "Member: {0}", mi.Name)
                    DisplayAttributes(indent, mi)

                    ' If the member is a method, display information about its parameters.
                    Dim pi As ParameterInfo
                    If mi.MemberType = MemberTypes.Method Then
                        For Each pi In CType(mi, MethodInfo).GetParameters()
                            Display(indent + 1, "Parameter: Type={0}, Name={1}", pi.ParameterType, pi.Name)
                        Next
                    End If

                    ' If the member is a property, display information about the property's accessor methods.
                    If mi.MemberType = MemberTypes.Property Then
                        Dim am As MethodInfo
                        For Each am In CType(mi, PropertyInfo).GetAccessors()
                            Display(indent + 1, "Accessor method: {0}", am)
                        Next
                    End If
                Next
                indent -= 1
            Next
            indent -= 1
        Next
    End Sub

    ' Displays the custom attributes applied to the specified member.
    Sub DisplayAttributes(ByVal indent As Int32, ByVal mi As MemberInfo)
        ' Get the set of custom attributes; if none exist, just return.
        Dim attrs() As Object = mi.GetCustomAttributes(False)
        If attrs.Length = 0 Then Return

        ' Display the custom attributes applied to this member.
        Display(indent + 1, "Attributes:")
        Dim o As Object
        For Each o In attrs
            Display(indent + 2, "{0}", o.ToString())
        Next
    End Sub

    ' Display a formatted string indented by the specified amount.
    Sub Display(ByVal indent As Int32, ByVal format As String, ByVal ParamArray params() As Object)
        Console.Write(New String(" "c, indent * 2))
        Console.WriteLine(format, params)
    End Sub
End Module

'The output shown below is abbreviated.
'
'Assembly identity=Reflection, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null
'  Codebase=file:///C:/Reflection.exe
'Referenced assemblies:
'  Name=mscorlib, Version=1.0.5000.0, Culture=, PublicKey token=B7-7A-5C-56-19-34-E0-89
'  Name=Microsoft.VisualBasic, Version=7.0.5000.0, Culture=, PublicKey token=B0-3F-5F-7F-11-D5-0A-3A
'
'Assembly: mscorlib, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
'  Module: mscorlib.dll
'  Module: prc.nlp
'  Module: prcp.nlp
'  Module: ksc.nlp
'  Module: ctype.nlp
'  Module: xjis.nlp
'  Module: bopomofo.nlp
'  Module: culture.nlp
'  Module: region.nlp
'  Module: sortkey.nlp
'  Module: charinfo.nlp
'  Module: big5.nlp
'  Module: sorttbls.nlp
'  Module: l_intl.nlp
'  Module: l_except.nlp
'
'  Type: System.Object
'    Member: GetHashCode
'    Member: Equals
'      Parameter: Type=System.Object, Name=obj
'    Member: ToString
'    Member: Equals
'      Parameter: Type=System.Object, Name=objA
'      Parameter: Type=System.Object, Name=objB
'    Member: ReferenceEquals
'      Parameter: Type=System.Object, Name=objA
'      Parameter: Type=System.Object, Name=objB
'    Member: GetType
'    Member: .ctor
'
'  Type: System.ICloneable
'    Member: Clone
'
'  Type: System.Collections.IEnumerable
'    Member: GetEnumerator
'      Attributes:
'        System.Runtime.InteropServices.DispIdAttribute
'
'  Type: System.Collections.ICollection
'    Member: get_IsSynchronized
'    Member: get_SyncRoot
'    Member: get_Count
'    Member: CopyTo
'      Parameter: Type=System.Array, Name=array
'      Parameter: Type=System.Int32, Name=index
'    Member: Count
'      Accessor method: Int32 get_Count()
'    Member: SyncRoot
'      Accessor method: System.Object get_SyncRoot()
'    Member: IsSynchronized
'      Accessor method: Boolean get_IsSynchronized()
'

Comentarios

Las propiedades son lógicamente iguales que los campos. Una propiedad es un aspecto con nombre del estado de un objeto cuyo valor suele ser accesible a través get de los descriptores de acceso y set . Las propiedades pueden ser de solo lectura, en cuyo caso no se admite una rutina de conjunto.

Nota:

Para determinar si una propiedad es static, debe obtener el MethodInfo para el get descriptor de acceso o set , llamando al GetGetMethod método o GetSetMethod y examinando su IsStatic propiedad .

Varios métodos de esta clase suponen que el descriptor de acceso y set los get métodos de descriptor de acceso de una propiedad tienen determinados formatos. Las firmas de los get métodos y set deben coincidir con la siguiente convención:

• El tipo de valor devuelto del get método y el último argumento del set método deben ser idénticos. Este es el tipo de la propiedad .

• Los get métodos y set deben tener el mismo número, tipo y orden de índices.

Si no se sigue este formato, el comportamiento de los GetValue métodos y SetValue no está definido.

Al llamar a ICustomAttributeProvider.GetCustomAttributes cuando PropertyInfo el inherit parámetro de GetCustomAttributes no se true recorre la jerarquía de tipos. Use System.Attribute para heredar atributos personalizados.

Notas a los implementadores

Cuando hereda de PropertyInfo, debe invalidar los siguientes miembros: GetValue(Object, Object[]), SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo), GetAccessors(Boolean), GetGetMethod(Boolean), GetSetMethod(Boolean)y GetIndexParameters().

Constructores

Nombre	Description
PropertyInfo()	Inicializa una nueva instancia de la clase PropertyInfo.

Propiedades

Nombre	Description
Attributes	Obtiene los atributos de esta propiedad.
CanRead	Obtiene un valor que indica si se puede leer la propiedad.
CanWrite	Obtiene un valor que indica si la propiedad se puede escribir en.
CustomAttributes	Obtiene una colección que contiene los atributos personalizados de este miembro. (Heredado de MemberInfo)
DeclaringType	Obtiene la clase que declara este miembro. (Heredado de MemberInfo)
GetMethod	Obtiene el descriptor de get acceso de esta propiedad.
IsCollectible	Obtiene un valor que indica si este MemberInfo objeto hace referencia a uno o varios ensamblados contenidos en un objeto recopilable AssemblyLoadContext. (Heredado de MemberInfo)
IsSpecialName	Obtiene un valor que indica si la propiedad es el nombre especial.
MemberType	Obtiene un MemberTypes valor que indica que este miembro es una propiedad.
MetadataToken	Obtiene un valor que identifica un elemento de metadatos. (Heredado de MemberInfo)
Module	Obtiene el módulo en el que se define el tipo que declara el miembro representado por el actual MemberInfo . (Heredado de MemberInfo)
Name	Obtiene el nombre del miembro actual. (Heredado de MemberInfo)
PropertyType	Obtiene el tipo de esta propiedad.
ReflectedType	Obtiene el objeto de clase que se usó para obtener esta instancia de MemberInfo. (Heredado de MemberInfo)
SetMethod	Obtiene el descriptor de set acceso de esta propiedad.

Métodos

Nombre	Description
Equals(Object)	Devuelve un valor que indica si esta instancia es igual a un objeto especificado.
GetAccessors()	Devuelve una matriz cuyos elementos reflejan los descriptores de acceso públicos get y set de la propiedad reflejados por la instancia actual.
GetAccessors(Boolean)	Devuelve una matriz cuyos elementos reflejan el público y, si se especifican, descriptores de acceso y set no públicos get de la propiedad reflejada por la instancia actual.
GetConstantValue()	Devuelve un valor literal asociado a la propiedad por un compilador.
GetCustomAttributes(Boolean)	Cuando se reemplaza en una clase derivada, devuelve una matriz de todos los atributos personalizados aplicados a este miembro. (Heredado de MemberInfo)
GetCustomAttributes(Type, Boolean)	Cuando se reemplaza en una clase derivada, devuelve una matriz de atributos personalizados aplicados a este miembro y identificados por Type. (Heredado de MemberInfo)
GetCustomAttributesData()	Devuelve una lista de CustomAttributeData objetos que representan datos sobre los atributos que se han aplicado al miembro de destino. (Heredado de MemberInfo)
GetGetMethod()	Devuelve el descriptor de acceso público get para esta propiedad.
GetGetMethod(Boolean)	Cuando se invalida en una clase derivada, devuelve el descriptor de acceso público o no público get para esta propiedad.
GetHashCode()	Devuelve el código hash de esta instancia.
GetIndexParameters()	Cuando se reemplaza en una clase derivada, devuelve una matriz de todos los parámetros de índice de la propiedad .
GetModifiedPropertyType()	Obtiene el tipo modificado de este objeto de propiedad.
GetOptionalCustomModifiers()	Devuelve una matriz de tipos que representa los modificadores personalizados opcionales de la propiedad .
GetRawConstantValue()	Devuelve un valor literal asociado a la propiedad por un compilador.
GetRequiredCustomModifiers()	Devuelve una matriz de tipos que representa los modificadores personalizados necesarios de la propiedad .
GetSetMethod()	Devuelve el descriptor de acceso público set para esta propiedad.
GetSetMethod(Boolean)	Cuando se reemplaza en una clase derivada, devuelve el set descriptor de acceso para esta propiedad.
GetValue(Object, BindingFlags, Binder, Object[], CultureInfo)	Cuando se reemplaza en una clase derivada, devuelve el valor de propiedad de un objeto especificado que tiene la información específica del enlace, el índice y la referencia cultural especificados.
GetValue(Object, Object[])	Devuelve el valor de propiedad de un objeto especificado con valores de índice opcionales para las propiedades indexadas.
GetValue(Object)	Devuelve el valor de propiedad de un objeto especificado.
HasSameMetadataDefinitionAs(MemberInfo)	Detecta los atributos de una propiedad y proporciona acceso a los metadatos de propiedad. (Heredado de MemberInfo)
IsDefined(Type, Boolean)	Cuando se reemplaza en una clase derivada, indica si uno o varios atributos del tipo especificado o de sus tipos derivados se aplican a este miembro. (Heredado de MemberInfo)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
SetValue(Object, Object, BindingFlags, Binder, Object[], CultureInfo)	Cuando se reemplaza en una clase derivada, establece el valor de propiedad de un objeto especificado que tiene la información específica del enlace, el índice y la referencia cultural especificados.
SetValue(Object, Object, Object[])	Establece el valor de propiedad de un objeto especificado con valores de índice opcionales para las propiedades de índice.
SetValue(Object, Object)	Establece el valor de propiedad de un objeto especificado.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Operadores

Nombre	Description
Equality(PropertyInfo, PropertyInfo)	Indica si dos PropertyInfo objetos son iguales.
Inequality(PropertyInfo, PropertyInfo)	Indica si dos PropertyInfo objetos no son iguales.

Métodos de extensión

Nombre	Description
GetAccessors(PropertyInfo, Boolean)	Detecta los atributos de una propiedad y proporciona acceso a los metadatos de propiedad.
GetAccessors(PropertyInfo)	Detecta los atributos de una propiedad y proporciona acceso a los metadatos de propiedad.
GetCustomAttribute(MemberInfo, Type, Boolean)	Recupera un atributo personalizado de un tipo especificado que se aplica a un miembro especificado y, opcionalmente, inspecciona los antecesores de ese miembro.
GetCustomAttribute(MemberInfo, Type)	Recupera un atributo personalizado de un tipo especificado que se aplica a un miembro especificado.
GetCustomAttribute<T>(MemberInfo, Boolean)	Recupera un atributo personalizado de un tipo especificado que se aplica a un miembro especificado y, opcionalmente, inspecciona los antecesores de ese miembro.
GetCustomAttribute<T>(MemberInfo)	Recupera un atributo personalizado de un tipo especificado que se aplica a un miembro especificado.
GetCustomAttributes(MemberInfo, Boolean)	Recupera una colección de atributos personalizados que se aplican a un miembro especificado y, opcionalmente, inspecciona los antecesores de ese miembro.
GetCustomAttributes(MemberInfo, Type, Boolean)	Recupera una colección de atributos personalizados de un tipo especificado que se aplica a un miembro especificado y, opcionalmente, inspecciona los antecesores de ese miembro.
GetCustomAttributes(MemberInfo, Type)	Recupera una colección de atributos personalizados de un tipo especificado que se aplica a un miembro especificado.
GetCustomAttributes(MemberInfo)	Recupera una colección de atributos personalizados que se aplican a un miembro especificado.
GetCustomAttributes<T>(MemberInfo, Boolean)	Recupera una colección de atributos personalizados de un tipo especificado que se aplica a un miembro especificado y, opcionalmente, inspecciona los antecesores de ese miembro.
GetCustomAttributes<T>(MemberInfo)	Recupera una colección de atributos personalizados de un tipo especificado que se aplica a un miembro especificado.
GetGetMethod(PropertyInfo, Boolean)	Detecta los atributos de una propiedad y proporciona acceso a los metadatos de propiedad.
GetGetMethod(PropertyInfo)	Detecta los atributos de una propiedad y proporciona acceso a los metadatos de propiedad.
GetMetadataToken(MemberInfo)	Obtiene un token de metadatos para el miembro especificado, si está disponible.
GetSetMethod(PropertyInfo, Boolean)	Detecta los atributos de una propiedad y proporciona acceso a los metadatos de propiedad.
GetSetMethod(PropertyInfo)	Detecta los atributos de una propiedad y proporciona acceso a los metadatos de propiedad.
HasMetadataToken(MemberInfo)	Devuelve un valor que indica si un token de metadatos está disponible para el miembro especificado.
IsDefined(MemberInfo, Type, Boolean)	Indica si los atributos personalizados de un tipo especificado se aplican a un miembro especificado y, opcionalmente, se aplican a sus antecesores.
IsDefined(MemberInfo, Type)	Indica si los atributos personalizados de un tipo especificado se aplican a un miembro especificado.

Seguridad para subprocesos

Este tipo es seguro para subprocesos.