Type.GetProperty Yöntem

Tanım

Geçerli öğesinin belirli bir özelliğini alır Type .Gets a specific property of the current Type.

Aşırı Yüklemeler

GetProperty(String)

Belirtilen ada sahip ortak özelliği arar.Searches for the public property with the specified name.

GetProperty(String, BindingFlags)

Belirtilen bağlama kısıtlamalarını kullanarak belirtilen özelliği arar.Searches for the specified property, using the specified binding constraints.

GetProperty(String, Type)

Belirtilen ad ve dönüş türüyle ortak özelliği arar.Searches for the public property with the specified name and return type.

GetProperty(String, Type[])

Parametreleri belirtilen bağımsız değişken türleriyle eşleşen belirtilen public özelliğini arar.Searches for the specified public property whose parameters match the specified argument types.

GetProperty(String, Type, Type[])

Parametreleri belirtilen bağımsız değişken türleriyle eşleşen belirtilen public özelliğini arar.Searches for the specified public property whose parameters match the specified argument types.

GetProperty(String, Type, Type[], ParameterModifier[])

Parametreleri belirtilen bağımsız değişken türleri ve değiştiricilerine uyan belirtilen public özelliğini arar.Searches for the specified public property whose parameters match the specified argument types and modifiers.

GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])

Belirtilen bağlama kısıtlamalarını kullanarak parametreleri belirtilen bağımsız değişken türleri ve değiştiriciler ile eşleşen belirtilen özelliği arar.Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.

GetProperty(String)

Belirtilen ada sahip ortak özelliği arar.Searches for the public property with the specified name.

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name);
public System.Reflection.PropertyInfo? GetProperty (string name);
public System.Reflection.PropertyInfo GetProperty (string name);
member this.GetProperty : string -> System.Reflection.PropertyInfo
abstract member GetProperty : string -> System.Reflection.PropertyInfo
override this.GetProperty : string -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String) As PropertyInfo

Parametreler

name
String

Alınacak genel özelliğin adını içeren dize.The string containing the name of the public property to get.

Döndürülenler

PropertyInfo

Bulunursa, belirtilen ada sahip ortak özelliği temsil eden bir nesne; Aksi takdirde, null .An object representing the public property with the specified name, if found; otherwise, null.

Uygulamalar

Özel durumlar

Belirtilen ada sahip birden fazla özellik bulundu.More than one property is found with the specified name.

name, null değeridir.name is null.

Örnekler

Aşağıdaki örnek, Type Kullanıcı tanımlı bir sınıfın nesnesini alır, bu sınıfın bir özelliğini alır ve özellik adını görüntüler.The following example retrieves the Type object of a user-defined class, retrieves a property of that class, and displays the property name.

using namespace System;
using namespace System::Reflection;
ref class MyClass
{
private:
   int myProperty;

public:

   property int MyProperty 
   {
      // Declare MyProperty.
      int get()
      {
         return myProperty;
      }

      void set( int value )
      {
         myProperty = value;
      }
   }
};

int main()
{
   try
   {
      // Get the Type object corresponding to MyClass.
      Type^ myType = MyClass::typeid;
      
      // Get the PropertyInfo object by passing the property name.
      PropertyInfo^ myPropInfo = myType->GetProperty( "MyProperty" );
      
      // Display the property name.
      Console::WriteLine( "The {0} property exists in MyClass.", myPropInfo->Name );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "The property does not exist in MyClass. {0}", e->Message );
   }
}

using System;
using System.Reflection;

class MyClass
{
    private int myProperty;
    // Declare MyProperty.
    public int MyProperty
    {
        get
        {
            return myProperty;
        }
        set
        {
            myProperty=value;
        }
    }
}
public class MyTypeClass
{
    public static void Main(string[] args)
    {
        try
        {
            // Get the Type object corresponding to MyClass.
            Type myType=typeof(MyClass);
            // Get the PropertyInfo object by passing the property name.
            PropertyInfo myPropInfo = myType.GetProperty("MyProperty");
            // Display the property name.
            Console.WriteLine("The {0} property exists in MyClass.", myPropInfo.Name);
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("The property does not exist in MyClass." + e.Message);
        }
    }
}
Imports System.Reflection
Class MyClass1
    Private myProperty1 As Integer
    ' Declare MyProperty.

    Public Property MyProperty() As Integer
        Get
            Return myProperty1
        End Get
        Set(ByVal Value As Integer)
            myProperty1 = Value
        End Set
    End Property
End Class

Public Class MyTypeClass
    Public Shared Sub Main(ByVal args() As String)
        Try
            ' Get Type Object corresponding to MyClass.
            Dim myType As Type = GetType(MyClass1)
            ' Get PropertyInfo object by passing property name.
            Dim myPropInfo As PropertyInfo = myType.GetProperty("MyProperty")
            ' Display Name propety to console.
            Console.WriteLine("The {0} property exists in MyClass.", myPropInfo.Name)
        Catch e As NullReferenceException
            Console.WriteLine("The property does not exist in MyClass.", e.Message.ToString())
        End Try
    End Sub
End Class

Dahili olarak, bu özellik meta verilerde "öğe" adıyla adlandırılır.Internally, this property is referred to in the metadata by the name "Item." PropertyInfoYansıma kullanma girişimleri, özelliği doğru bir şekilde döndürmek için bu dahili adı belirtmelidir PropertyInfo .Any attempt to get PropertyInfo using reflection must specify this internal name in order to correctly return the PropertyInfo property.

Açıklamalar

Arama name büyük/küçük harfe duyarlıdır.The search for name is case-sensitive. Arama, genel statik ve genel örnek özelliklerini içerir.The search includes public static and public instance properties.

Bir özelliğin en az bir genel erişimcisi varsa, o özellik yansıma için genel sayılır.A property is considered public to reflection if it has at least one accessor that is public. Aksi takdirde özellik private olarak kabul edilir ve BindingFlags.NonPublic | | kullanmanız gerekir BindingFlags.Instance BindingFlags.Static (Visual Basic ' de değerleri birleştirerek Or ).Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Geçerli, Type oluşturulmuş bir genel türü temsil ediyorsa, bu yöntem PropertyInfo uygun tür bağımsız değişkenleri ile değiştirilmiş tür parametreleri ile birlikte döndürür.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Geçerli, Type genel bir türün veya genel yöntemin tanımındaki bir tür parametresini temsil ediyorsa, bu yöntem sınıf kısıtlamasının özelliklerini arar.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

' De oluşan durumlar şunları AmbiguousMatchException içerir:Situations in which AmbiguousMatchException occurs include the following:

  • Bir tür, aynı ada ancak farklı sayıda parametreye sahip olan iki dizinli özellik içerir.A type contains two indexed properties that have the same name but different numbers of parameters. Belirsizliği çözümlemek için GetProperty yöntemin parametre türlerini belirten bir aşırı yüklemesini kullanın.To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • Türetilmiş bir tür, değiştirici kullanılarak devralınan bir özelliği aynı ada new (Visual Basic) gizleyen bir özellik bildirir Shadows .A derived type declares a property that hides an inherited property with the same name, by using the new modifier (Shadows in Visual Basic). Belirsizliği çözmek için, GetProperty(String, BindingFlags) yöntem aşırı yüklemesini kullanın ve BindingFlags.DeclaredOnly aramayı devralınmayan üyelere kısıtlamak için bayrağını ekleyin.To resolve the ambiguity, use the GetProperty(String, BindingFlags) method overload and add the BindingFlags.DeclaredOnly flag to restrict the search to members that are not inherited.

Dizin Oluşturucular ve Varsayılan ÖzelliklerIndexers and Default Properties

Visual Basic 2005, Visual C# 2005 ve Visual C++ 2005, dizinli özelliklere erişmek için Basitleştirilmiş sözdizimine sahiptir ve bir dizinli özelliğin türü için varsayılan değer olmasını sağlar.Visual Basic 2005, Visual C# 2005, and Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Örneğin, değişkeni myList bir öğesine başvuruyorsa ArrayList , sözdizimi myList[3] ( myList(3) Visual Basic), öğesini 3 diziniyle alır.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Özelliği aşırı yükleyebilirsiniz.You can overload the property.

C# ' de, bu özelliğe bir Dizin Oluşturucu denir ve ada göre başvuruda bulunulemez.In C#, this feature is called an indexer and cannot be referred to by name. Varsayılan olarak, bir C# Dizin Oluşturucusu meta verilerde "Item" adlı dizinli özellik olarak görünür.By default, a C# indexer appears in metadata as an indexed property named "Item". Ancak, bir sınıf kitaplığı geliştiricisi IndexerNameAttribute meta verilerde dizin oluşturucunun adını değiştirmek için özniteliğini kullanabilir.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Örneğin, String sınıfında adlı bir dizin oluşturucu vardır Chars[] .For example, the String class has an indexer named Chars[]. C# dışındaki diller kullanılarak oluşturulan dizinlenmiş özelliklerin Madde dışında adları da olabilir.Indexed properties created using languages other than C# can have names other than Item, as well.

Bir türün varsayılan özelliğe sahip olup olmadığını anlamak için, GetCustomAttributes(Type, Boolean) özniteliğini test etmek için yöntemini kullanın DefaultMemberAttribute .To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Tür varsa DefaultMemberAttribute , MemberName özelliği varsayılan özelliğin adını döndürür.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Ayrıca bkz.

Şunlara uygulanır

GetProperty(String, BindingFlags)

Belirtilen bağlama kısıtlamalarını kullanarak belirtilen özelliği arar.Searches for the specified property, using the specified binding constraints.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, System::Reflection::BindingFlags bindingAttr);
public System.Reflection.PropertyInfo? GetProperty (string name, System.Reflection.BindingFlags bindingAttr);
public System.Reflection.PropertyInfo GetProperty (string name, System.Reflection.BindingFlags bindingAttr);
abstract member GetProperty : string * System.Reflection.BindingFlags -> System.Reflection.PropertyInfo
override this.GetProperty : string * System.Reflection.BindingFlags -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, bindingAttr As BindingFlags) As PropertyInfo

Parametreler

name
String

Alınacak özelliğin adını içeren dize.The string containing the name of the property to get.

bindingAttr
BindingFlags

Aramanın nasıl yürütüldüğünü belirten numaralandırma değerlerinin bit düzeyinde birleşimi.A bitwise combination of the enumeration values that specify how the search is conducted.

-veya--or- Default dönün null .Default to return null.

Döndürülenler

PropertyInfo

Bulunursa, belirtilen gereksinimlerle eşleşen özelliği temsil eden bir nesne; Aksi takdirde, null .An object representing the property that matches the specified requirements, if found; otherwise, null.

Uygulamalar

Özel durumlar

Belirtilen ada sahip ve belirtilen bağlama kısıtlamalarıyla eşleşen birden fazla özellik bulundu.More than one property is found with the specified name and matching the specified binding constraints.

name, null değeridir.name is null.

Örnekler

Aşağıdaki örnek, Kullanıcı tanımlı bir sınıfın türünü alır, bu sınıfın bir özelliğini alır ve özellik adını belirtilen bağlama kısıtlamalarına uygun olarak görüntüler.The following example retrieves the type of a user-defined class, retrieves a property of that class and displays the property name in accordance with the specified binding constraints.

using namespace System;
using namespace System::Reflection;
ref class MyClass
{
private:
   int myProperty;

public:

   property int MyProperty 
   {
      // Declare MyProperty.
      int get()
      {
         return myProperty;
      }

      void set( int value )
      {
         myProperty = value;
      }
   }
};

int main()
{
   try
   {
      // Get Type object of MyClass.
      Type^ myType = MyClass::typeid;
      
      // Get the PropertyInfo by passing the property name and specifying the BindingFlags.
      PropertyInfo^ myPropInfo = myType->GetProperty( "MyProperty", static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance) );
      
      // Display Name propety to console.
      Console::WriteLine( "{0} is a property of MyClass.", myPropInfo->Name );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "MyProperty does not exist in MyClass. {0}", e->Message );
   }
}

using System;
using System.Reflection;
class MyClass
{
    private int myProperty;
    // Declare MyProperty.
    public int MyProperty
    {
        get
        {
            return myProperty;
        }
        set
        {
            myProperty=value;
        }
    }
}
public class MyTypeClass
{
    public static void Main(string[] args)
    {
        try
        {
            // Get Type object of MyClass.
            Type myType=typeof(MyClass);
            // Get the PropertyInfo by passing the property name and specifying the BindingFlags.
            PropertyInfo myPropInfo = myType.GetProperty("MyProperty", BindingFlags.Public | BindingFlags.Instance);
            // Display Name propety to console.
            Console.WriteLine("{0} is a property of MyClass.", myPropInfo.Name);
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("MyProperty does not exist in MyClass." +e.Message);
        }
    }
}

Imports System.Reflection
Module Module1
    Public Class MyClass1
        Private myProperty1 As Integer
        ' Declare MyProperty.
        Public Property MyProperty() As Integer
            Get
                Return myProperty1
            End Get
            Set(ByVal Value As Integer)
                myProperty1 = Value
            End Set
        End Property
        Public Shared Sub Main()
            Try
                ' Get a Type object corresponding to MyClass.
                Dim myType As Type = GetType(MyClass1)
                ' Get a PropertyInfo object by passing property name and specifying BindingFlags.
                Dim myPropInfo As PropertyInfo = myType.GetProperty("MyProperty", BindingFlags.Public Or BindingFlags.Instance)
                ' Display the Name property.
                Console.WriteLine("{0} is a property of MyClass.", myPropInfo.Name)
            Catch e As NullReferenceException
                Console.WriteLine("MyProperty does not exist in MyClass.", e.Message.ToString())
            End Try
        End Sub
    End Class
End Module 'Module1

Açıklamalar

Bir özelliğin en az bir genel erişimcisi varsa, o özellik yansıma için genel sayılır.A property is considered public to reflection if it has at least one accessor that is public. Aksi takdirde özellik private olarak kabul edilir ve BindingFlags.NonPublic | | kullanmanız gerekir BindingFlags.Instance BindingFlags.Static (Visual Basic ' de değerleri birleştirerek Or ).Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

BindingFlagsAramaya eklenecek özellikleri tanımlamak için aşağıdaki filtre bayrakları kullanılabilir:The following BindingFlags filter flags can be used to define which properties to include in the search:

  • BindingFlags.Instance BindingFlags.Static Dönüş almak için ya da ' i belirtmeniz gerekir.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • BindingFlags.PublicAramaya genel özellikler dahil etmek için belirtin.Specify BindingFlags.Public to include public properties in the search.

  • BindingFlags.NonPublicAramada ortak olmayan özellikleri (yani özel, iç ve korumalı özellikleri) dahil etmek için belirtin.Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • BindingFlags.FlattenHierarchyHiyerarşinin dahil edileceğini public ve protected statik üyelerini belirtin; private devralınan sınıflarda statik üyeler dahil değildir.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

BindingFlagsAramanın nasıl çalıştığını değiştirmek için aşağıdaki değiştirici bayrakları kullanılabilir:The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCase durumunu yok saymak için name .BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnly yalnızca ' de belirtilen özellikleri aramak için Type , yalnızca devralınmış özelliklerde değil.BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

Daha fazla bilgi edinmek için bkz. System.Reflection.BindingFlags.See System.Reflection.BindingFlags for more information.

Geçerli, Type oluşturulmuş bir genel türü temsil ediyorsa, bu yöntem PropertyInfo uygun tür bağımsız değişkenleri ile değiştirilmiş tür parametreleri ile birlikte döndürür.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Geçerli, Type genel bir türün veya genel yöntemin tanımındaki bir tür parametresini temsil ediyorsa, bu yöntem sınıf kısıtlamasının özelliklerini arar.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

' De oluşan durumlar şunları AmbiguousMatchException içerir:Situations in which AmbiguousMatchException occurs include the following:

  • Bir tür, aynı ada ancak farklı sayıda parametreye sahip olan iki dizinli özellik içerir.A type contains two indexed properties that have the same name but different numbers of parameters. Belirsizliği çözümlemek için GetProperty yöntemin parametre türlerini belirten bir aşırı yüklemesini kullanın.To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • Türetilmiş bir tür, new değiştiricisini (Visual Basic) kullanarak, devralınan bir özelliği aynı ada sahip bir şekilde gizleyen bir özellik bildirir Shadows .A derived type declares a property that hides an inherited property with the same name, using the new modifier (Shadows in Visual Basic). Belirsizliği çözmek için, BindingFlags.DeclaredOnly aramayı devralınmayan üyelere kısıtlamak için dahil edin.To resolve the ambiguity, include BindingFlags.DeclaredOnly to restrict the search to members that are not inherited.

Dizin Oluşturucular ve Varsayılan ÖzelliklerIndexers and Default Properties

Visual Basic 2005, Visual C# 2005 ve Visual C++ 2005, dizinli özelliklere erişmek için Basitleştirilmiş sözdizimine sahiptir ve bir dizinli özelliğin türü için varsayılan değer olmasını sağlar.Visual Basic 2005, Visual C# 2005, and Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Örneğin, değişkeni myList bir öğesine başvuruyorsa ArrayList , sözdizimi myList[3] ( myList(3) Visual Basic), öğesini 3 diziniyle alır.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Özelliği aşırı yükleyebilirsiniz.You can overload the property.

C# ' de, bu özelliğe bir Dizin Oluşturucu denir ve ada göre başvuruda bulunulemez.In C#, this feature is called an indexer and cannot be referred to by name. Varsayılan olarak, bir C# Dizin Oluşturucusu meta verilerde "Item" adlı dizinli özellik olarak görünür.By default, a C# indexer appears in metadata as an indexed property named "Item". Ancak, bir sınıf kitaplığı geliştiricisi IndexerNameAttribute meta verilerde dizin oluşturucunun adını değiştirmek için özniteliğini kullanabilir.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Örneğin, String sınıfında adlı bir dizin oluşturucu vardır Chars[] .For example, the String class has an indexer named Chars[]. C# dışındaki diller kullanılarak oluşturulan dizinlenmiş özelliklerin Madde dışında adları da olabilir.Indexed properties created using languages other than C# can have names other than Item, as well.

Bir türün varsayılan özelliğe sahip olup olmadığını anlamak için, GetCustomAttributes(Type, Boolean) özniteliğini test etmek için yöntemini kullanın DefaultMemberAttribute .To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Tür varsa DefaultMemberAttribute , MemberName özelliği varsayılan özelliğin adını döndürür.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Ayrıca bkz.

Şunlara uygulanır

GetProperty(String, Type)

Belirtilen ad ve dönüş türüyle ortak özelliği arar.Searches for the public property with the specified name and return type.

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType);
public System.Reflection.PropertyInfo? GetProperty (string name, Type? returnType);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType);
member this.GetProperty : string * Type -> System.Reflection.PropertyInfo
abstract member GetProperty : string * Type -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, returnType As Type) As PropertyInfo

Parametreler

name
String

Alınacak genel özelliğin adını içeren dize.The string containing the name of the public property to get.

returnType
Type

Özelliğinin dönüş türü.The return type of the property.

Döndürülenler

PropertyInfo

Bulunursa, belirtilen ada sahip ortak özelliği temsil eden bir nesne; Aksi takdirde, null .An object representing the public property with the specified name, if found; otherwise, null.

Uygulamalar

Özel durumlar

Belirtilen ada sahip birden fazla özellik bulundu.More than one property is found with the specified name.

namenull, veya returnType olur null .name is null, or returnType is null.

Örnekler

Aşağıdaki örnek, bir özelliği olan bir sınıfı tanımlar ve özelliğin adını ve türünü alır.The following example defines a class with one property and retrieves the name and type of the property.

using namespace System;
using namespace System::Reflection;
ref class MyClass1
{
private:
   String^ myMessage;

public:

   property String^ MyProperty1 
   {
      String^ get()
      {
         return myMessage;
      }

      void set( String^ value )
      {
         myMessage = value;
      }
   }
};

int main()
{
   try
   {
      Type^ myType = MyClass1::typeid;
      
      // Get the PropertyInfo Object* representing MyProperty1.
      PropertyInfo^ myStringProperties1 = myType->GetProperty( "MyProperty1", String::typeid );
      Console::WriteLine( "The name of the first property of MyClass1 is {0}.", myStringProperties1->Name );
      Console::WriteLine( "The type of the first property of MyClass1 is {0}.", myStringProperties1->PropertyType );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException : {0}", e->Message );
   }
   catch ( AmbiguousMatchException^ e ) 
   {
      Console::WriteLine( "AmbiguousMatchException : {0}", e->Message );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "Source : {0}", e->Source );
      Console::WriteLine( "Message : {0}", e->Message );
   }
   //Output:
   //The name of the first property of MyClass1 is MyProperty1.
   //The type of the first property of MyClass1 is System.String.

}

using System;
using System.Reflection;

class MyClass1
{
    String myMessage="Hello World.";
    public string MyProperty1
    {
        get
        {			
            return myMessage;
        }
        set
        {
            myMessage =value;
        }			
    }
}
class TestClass
{
    static void Main()
    {
        try
        {	
            Type myType = typeof(MyClass1);
            // Get the PropertyInfo object representing MyProperty1.
            PropertyInfo myStringProperties1 = myType.GetProperty("MyProperty1",
                typeof(string));
            Console.WriteLine("The name of the first property of MyClass1 is {0}.", myStringProperties1.Name);
            Console.WriteLine("The type of the first property of MyClass1 is {0}.", myStringProperties1.PropertyType);
        }
        catch(ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException :"+e.Message);
        }
        catch(AmbiguousMatchException e)
        {
            Console.WriteLine("AmbiguousMatchException :"+e.Message);
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("Source : {0}" , e.Source);
            Console.WriteLine("Message : {0}" , e.Message);
        }
    //Output:
    //The name of the first property of MyClass1 is MyProperty1.
    //The type of the first property of MyClass1 is System.String.
    }
}
Imports System.Reflection
Class MyClass1
    Private myMessage As [String] = "Hello World."
    Public Property MyProperty1() As String
        Get
            Return myMessage
        End Get
        Set(ByVal Value As String)
            myMessage = Value
        End Set
    End Property
End Class

Class TestClass
    Shared Sub Main()
        Try
            Dim myType As Type = GetType(MyClass1)
            ' Get the PropertyInfo object representing MyProperty1. 
            Dim myStringProperties1 As PropertyInfo = myType.GetProperty("MyProperty1", GetType(String))
            Console.WriteLine("The name of the first property of MyClass1 is {0}.", myStringProperties1.Name)
            Console.WriteLine("The type of the first property of MyClass1 is {0}.", myStringProperties1.PropertyType.ToString())
        Catch e As ArgumentNullException
            Console.WriteLine("ArgumentNullException :" + e.Message.ToString())
        Catch e As AmbiguousMatchException
            Console.WriteLine("AmbiguousMatchException :" + e.Message.ToString())
        Catch e As NullReferenceException
            Console.WriteLine("Source : {0}", e.Source.ToString())
            Console.WriteLine("Message : {0}", e.Message.ToString())
        End Try
    'Output:
    'The name of the first property of MyClass1 is MyProperty1.
    'The type of the first property of MyClass1 is System.String.

    End Sub
End Class

Açıklamalar

Bir özelliğin en az bir genel erişimcisi varsa, o özellik yansıma için genel sayılır.A property is considered public to reflection if it has at least one accessor that is public. Aksi takdirde özellik private olarak kabul edilir ve BindingFlags.NonPublic | | kullanmanız gerekir BindingFlags.Instance BindingFlags.Static (Visual Basic ' de değerleri birleştirerek Or ).Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Arama name büyük/küçük harfe duyarlıdır.The search for name is case-sensitive. Arama, genel statik ve genel örnek özelliklerini içerir.The search includes public static and public instance properties.

Geçerli, Type oluşturulmuş bir genel türü temsil ediyorsa, bu yöntem PropertyInfo uygun tür bağımsız değişkenleri ile değiştirilmiş tür parametreleri ile birlikte döndürür.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Geçerli, Type genel bir türün veya genel yöntemin tanımındaki bir tür parametresini temsil ediyorsa, bu yöntem sınıf kısıtlamasının özelliklerini arar.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Dizin Oluşturucular ve Varsayılan ÖzelliklerIndexers and Default Properties

Visual Basic 2005, Visual C# 2005 ve Visual C++ 2005, dizinli özelliklere erişmek için Basitleştirilmiş sözdizimine sahiptir ve bir dizinli özelliğin türü için varsayılan değer olmasını sağlar.Visual Basic 2005, Visual C# 2005, and Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Örneğin, değişkeni myList bir öğesine başvuruyorsa ArrayList , sözdizimi myList[3] ( myList(3) Visual Basic), öğesini 3 diziniyle alır.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Özelliği aşırı yükleyebilirsiniz.You can overload the property.

C# ' de, bu özelliğe bir Dizin Oluşturucu denir ve ada göre başvuruda bulunulemez.In C#, this feature is called an indexer and cannot be referred to by name. Varsayılan olarak, bir C# Dizin Oluşturucusu meta verilerde "Item" adlı dizinli özellik olarak görünür.By default, a C# indexer appears in metadata as an indexed property named "Item". Ancak, bir sınıf kitaplığı geliştiricisi IndexerNameAttribute meta verilerde dizin oluşturucunun adını değiştirmek için özniteliğini kullanabilir.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Örneğin, String sınıfında adlı bir dizin oluşturucu vardır Chars[] .For example, the String class has an indexer named Chars[]. C# dışındaki diller kullanılarak oluşturulan dizinlenmiş özelliklerin Madde dışında adları da olabilir.Indexed properties created using languages other than C# can have names other than Item, as well.

Bir türün varsayılan özelliğe sahip olup olmadığını anlamak için, GetCustomAttributes(Type, Boolean) özniteliğini test etmek için yöntemini kullanın DefaultMemberAttribute .To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Tür varsa DefaultMemberAttribute , MemberName özelliği varsayılan özelliğin adını döndürür.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Ayrıca bkz.

Şunlara uygulanır

GetProperty(String, Type[])

Parametreleri belirtilen bağımsız değişken türleriyle eşleşen belirtilen public özelliğini arar.Searches for the specified public property whose parameters match the specified argument types.

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, cli::array <Type ^> ^ types);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, cli::array <Type ^> ^ types);
public System.Reflection.PropertyInfo? GetProperty (string name, Type[] types);
public System.Reflection.PropertyInfo GetProperty (string name, Type[] types);
member this.GetProperty : string * Type[] -> System.Reflection.PropertyInfo
abstract member GetProperty : string * Type[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, types As Type()) As PropertyInfo

Parametreler

name
String

Alınacak genel özelliğin adını içeren dize.The string containing the name of the public property to get.

types
Type[]

TypeAlınacak dizinli özelliğin parametre sayısını, sırasını ve türünü temsil eden bir nesne dizisi.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

-veya--or- TypeDizine alınmamış bir özelliği almak için türün boş bir dizisi (yani, Type [] types = new Type [0]).An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

Döndürülenler

PropertyInfo

Bulunursa, parametreleri belirtilen bağımsız değişken türleriyle eşleşen public özelliğini temsil eden bir nesne; Aksi takdirde, null .An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

Uygulamalar

Özel durumlar

Belirtilen ada sahip ve belirtilen bağımsız değişken türleriyle eşleşen birden fazla özellik bulundu.More than one property is found with the specified name and matching the specified argument types.

name, null değeridir.name is null.

-veya--or- types, null değeridir.types is null.

types çok boyutludur.types is multidimensional.

Öğesi types null .An element of types is null.

Örnekler

Aşağıdaki örnek, Type Kullanıcı tanımlı bir sınıfın nesnesini alır, bu sınıfın özelliğini alır ve geçirilen bağımsız değişkenlerle belirtilen özelliğin özellik adını ve türünü görüntüler GetProperty .The following example retrieves the Type object of a user-defined class, retrieves the property of that class, and displays the property name and type of the property as specified by the arguments passed to GetProperty.

using namespace System;
using namespace System::Reflection;
ref class MyClass1
{
private:
   array<int, 2>^myArray;

public:

   property int Item [int, int]
   {

      // Declare an indexer.
      int get( int i, int j )
      {
         return myArray[ i,j ];
      }

      void set( int i, int j, int value )
      {
         myArray[ i,j ] = value;
      }

   }

};

int main()
{
   try
   {
      
      // Get the Type object.
      Type^ myType = MyClass1::typeid;
      array<Type^>^myTypeArr = gcnew array<Type^>(2);
      
      // Create an instance of a Type array.
      myTypeArr->SetValue( int::typeid, 0 );
      myTypeArr->SetValue( int::typeid, 1 );
      
      // Get the PropertyInfo object for the indexed property Item, which has two integer parameters.
      PropertyInfo^ myPropInfo = myType->GetProperty( "Item", myTypeArr );
      
      // Display the property.
      Console::WriteLine( "The {0} property exists in MyClass1.", myPropInfo );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "An exception occurred." );
      Console::WriteLine( "Source : {0}", e->Source );
      Console::WriteLine( "Message : {0}", e->Message );
   }

}

using System;
using System.Reflection;
class MyClass1
{
    private int [,] myArray = {{1,2},{3,4}};
    // Declare an indexer.
    public int this [int i,int j]
    {
        get
        {
            return myArray[i,j];
        }
        set
        {
            myArray[i,j] = value;
        }
    }
}
public class MyTypeClass
{
    public static void Main(string[] args)
    {
        try
        {
            // Get the Type object.
            Type myType=typeof(MyClass1);
            Type[] myTypeArr = new Type[2];
            // Create an instance of a Type array.
            myTypeArr.SetValue(typeof(int),0);
            myTypeArr.SetValue(typeof(int),1);
            // Get the PropertyInfo object for the indexed property Item, which has two integer parameters.
            PropertyInfo myPropInfo = myType.GetProperty("Item", myTypeArr);
            // Display the property.
            Console.WriteLine("The {0} property exists in MyClass1.", myPropInfo.ToString());
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("An exception occurred.");
            Console.WriteLine("Source : {0}" , e.Source);
            Console.WriteLine("Message : {0}" , e.Message);
        }
    }
}
Imports System.Reflection

Module Module1
    Class MyClass1
        Private myArray As Integer(,) = {{1, 2}, {3, 4}}
        ' Declare an indexer.
        Default Public Property Item(ByVal i As Integer, ByVal j As Integer) As Integer
            Get
                Return myArray(i, j)
            End Get
            Set(ByVal Value As Integer)

                myArray(i, j) = Value
            End Set
        End Property
    End Class

    Public Class MyTypeClass
        Public Shared Sub Main()
            Try
                ' Get the Type Object.
                Dim myType As Type = GetType(MyClass1)
                Dim myTypeArr(1) As Type
                ' Create an instance of a Type array.
                myTypeArr.SetValue(GetType(Integer), 0)
                myTypeArr.SetValue(GetType(Integer), 1)
                ' Get the PropertyInfo object for the indexed property Item, which has two integer parameters. 
                Dim myPropInfo As PropertyInfo = myType.GetProperty("Item", myTypeArr)
                ' Display the property.
                Console.WriteLine("The {0} property exists in MyClass1.", myPropInfo.ToString())
            Catch e As NullReferenceException
                Console.WriteLine("An exception occurred.")
                Console.WriteLine("Source : {0}", e.Source.ToString())
                Console.WriteLine("Message : {0}", e.Message.ToString())
            End Try
        End Sub
    End Class
End Module 'Module1

Açıklamalar

Bir özelliğin en az bir genel erişimcisi varsa, o özellik yansıma için genel sayılır.A property is considered public to reflection if it has at least one accessor that is public. Aksi takdirde özellik private olarak kabul edilir ve BindingFlags.NonPublic | | kullanmanız gerekir BindingFlags.Instance BindingFlags.Static (Visual Basic ' de değerleri birleştirerek Or ).Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Arama name büyük/küçük harfe duyarlıdır.The search for name is case-sensitive. Arama, genel statik ve genel örnek özelliklerini içerir.The search includes public static and public instance properties.

Geçerli, Type oluşturulmuş bir genel türü temsil ediyorsa, bu yöntem PropertyInfo uygun tür bağımsız değişkenleri ile değiştirilmiş tür parametreleri ile birlikte döndürür.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Geçerli, Type genel bir türün veya genel yöntemin tanımındaki bir tür parametresini temsil ediyorsa, bu yöntem sınıf kısıtlamasının özelliklerini arar.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Dizin Oluşturucular ve Varsayılan ÖzelliklerIndexers and Default Properties

Visual Basic 2005, Visual C# 2005 ve Visual C++ 2005, dizinli özelliklere erişmek için Basitleştirilmiş sözdizimine sahiptir ve bir dizinli özelliğin türü için varsayılan değer olmasını sağlar.Visual Basic 2005, Visual C# 2005, and Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Örneğin, değişkeni myList bir öğesine başvuruyorsa ArrayList , sözdizimi myList[3] ( myList(3) Visual Basic), öğesini 3 diziniyle alır.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Özelliği aşırı yükleyebilirsiniz.You can overload the property.

C# ' de, bu özelliğe bir Dizin Oluşturucu denir ve ada göre başvuruda bulunulemez.In C#, this feature is called an indexer and cannot be referred to by name. Varsayılan olarak, bir C# Dizin Oluşturucusu meta verilerde "Item" adlı dizinli özellik olarak görünür.By default, a C# indexer appears in metadata as an indexed property named "Item". Ancak, bir sınıf kitaplığı geliştiricisi IndexerNameAttribute meta verilerde dizin oluşturucunun adını değiştirmek için özniteliğini kullanabilir.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Örneğin, String sınıfında adlı bir dizin oluşturucu vardır Chars[] .For example, the String class has an indexer named Chars[]. C# dışındaki diller kullanılarak oluşturulan dizinlenmiş özelliklerin Madde dışında adları da olabilir.Indexed properties created using languages other than C# can have names other than Item, as well.

Bir türün varsayılan özelliğe sahip olup olmadığını anlamak için, GetCustomAttributes(Type, Boolean) özniteliğini test etmek için yöntemini kullanın DefaultMemberAttribute .To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Tür varsa DefaultMemberAttribute , MemberName özelliği varsayılan özelliğin adını döndürür.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Ayrıca bkz.

Şunlara uygulanır

GetProperty(String, Type, Type[])

Parametreleri belirtilen bağımsız değişken türleriyle eşleşen belirtilen public özelliğini arar.Searches for the specified public property whose parameters match the specified argument types.

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types);
public System.Reflection.PropertyInfo? GetProperty (string name, Type? returnType, Type[] types);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType, Type[] types);
member this.GetProperty : string * Type * Type[] -> System.Reflection.PropertyInfo
abstract member GetProperty : string * Type * Type[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type * Type[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, returnType As Type, types As Type()) As PropertyInfo

Parametreler

name
String

Alınacak genel özelliğin adını içeren dize.The string containing the name of the public property to get.

returnType
Type

Özelliğinin dönüş türü.The return type of the property.

types
Type[]

TypeAlınacak dizinli özelliğin parametre sayısını, sırasını ve türünü temsil eden bir nesne dizisi.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

-veya--or- TypeDizine alınmamış bir özelliği almak için türün boş bir dizisi (yani, Type [] types = new Type [0]).An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

Döndürülenler

PropertyInfo

Bulunursa, parametreleri belirtilen bağımsız değişken türleriyle eşleşen public özelliğini temsil eden bir nesne; Aksi takdirde, null .An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

Uygulamalar

Özel durumlar

Belirtilen ada sahip ve belirtilen bağımsız değişken türleriyle eşleşen birden fazla özellik bulundu.More than one property is found with the specified name and matching the specified argument types.

name, null değeridir.name is null.

-veya--or- types, null değeridir.types is null.

types çok boyutludur.types is multidimensional.

Öğesi types null .An element of types is null.

Açıklamalar

Bir özelliğin en az bir genel erişimcisi varsa, o özellik yansıma için genel sayılır.A property is considered public to reflection if it has at least one accessor that is public. Aksi takdirde özellik private olarak kabul edilir ve BindingFlags.NonPublic | | kullanmanız gerekir BindingFlags.Instance BindingFlags.Static (Visual Basic ' de değerleri birleştirerek Or ).Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Arama name büyük/küçük harfe duyarlıdır.The search for name is case-sensitive. Arama, genel statik ve genel örnek özelliklerini içerir.The search includes public static and public instance properties.

Geçerli, Type oluşturulmuş bir genel türü temsil ediyorsa, bu yöntem PropertyInfo uygun tür bağımsız değişkenleri ile değiştirilmiş tür parametreleri ile birlikte döndürür.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Geçerli, Type genel bir türün veya genel yöntemin tanımındaki bir tür parametresini temsil ediyorsa, bu yöntem sınıf kısıtlamasının özelliklerini arar.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Dizin Oluşturucular ve Varsayılan ÖzelliklerIndexers and Default Properties

Visual Basic 2005, Visual C# 2005 ve Visual C++ 2005, dizinli özelliklere erişmek için Basitleştirilmiş sözdizimine sahiptir ve bir dizinli özelliğin türü için varsayılan değer olmasını sağlar.Visual Basic 2005, Visual C# 2005, and Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Örneğin, değişkeni myList bir öğesine başvuruyorsa ArrayList , sözdizimi myList[3] ( myList(3) Visual Basic), öğesini 3 diziniyle alır.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Özelliği aşırı yükleyebilirsiniz.You can overload the property.

C# ' de, bu özelliğe bir Dizin Oluşturucu denir ve ada göre başvuruda bulunulemez.In C#, this feature is called an indexer and cannot be referred to by name. Varsayılan olarak, bir C# Dizin Oluşturucusu meta verilerde "Item" adlı dizinli özellik olarak görünür.By default, a C# indexer appears in metadata as an indexed property named "Item". Ancak, bir sınıf kitaplığı geliştiricisi IndexerNameAttribute meta verilerde dizin oluşturucunun adını değiştirmek için özniteliğini kullanabilir.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Örneğin, String sınıfında adlı bir dizin oluşturucu vardır Chars[] .For example, the String class has an indexer named Chars[]. C# dışındaki diller kullanılarak oluşturulan dizinlenmiş özelliklerin Madde dışında adları da olabilir.Indexed properties created using languages other than C# can have names other than Item, as well.

Bir türün varsayılan özelliğe sahip olup olmadığını anlamak için, GetCustomAttributes(Type, Boolean) özniteliğini test etmek için yöntemini kullanın DefaultMemberAttribute .To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Tür varsa DefaultMemberAttribute , MemberName özelliği varsayılan özelliğin adını döndürür.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Ayrıca bkz.

Şunlara uygulanır

GetProperty(String, Type, Type[], ParameterModifier[])

Parametreleri belirtilen bağımsız değişken türleri ve değiştiricilerine uyan belirtilen public özelliğini arar.Searches for the specified public property whose parameters match the specified argument types and modifiers.

public:
 System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.PropertyInfo? GetProperty (string name, Type? returnType, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType, Type[] types, System.Reflection.ParameterModifier[] modifiers);
member this.GetProperty : string * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
abstract member GetProperty : string * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, returnType As Type, types As Type(), modifiers As ParameterModifier()) As PropertyInfo

Parametreler

name
String

Alınacak genel özelliğin adını içeren dize.The string containing the name of the public property to get.

returnType
Type

Özelliğinin dönüş türü.The return type of the property.

types
Type[]

TypeAlınacak dizinli özelliğin parametre sayısını, sırasını ve türünü temsil eden bir nesne dizisi.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

-veya--or- TypeDizine alınmamış bir özelliği almak için türün boş bir dizisi (yani, Type [] types = new Type [0]).An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

ParameterModifierDizide karşılık gelen öğeyle ilişkili öznitelikleri temsil eden nesne dizisi types .An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. Varsayılan bağlayıcı bu parametreyi işlemez.The default binder does not process this parameter.

Döndürülenler

PropertyInfo

Bulunursa, belirtilen gereksinimlerle eşleşen public özelliğini temsil eden bir nesne; Aksi takdirde, null .An object representing the public property that matches the specified requirements, if found; otherwise, null.

Uygulamalar

Özel durumlar

Belirtilen ada sahip ve belirtilen bağımsız değişken türleri ve değiştiricilerini eşleştiren birden fazla özellik bulundu.More than one property is found with the specified name and matching the specified argument types and modifiers.

name, null değeridir.name is null.

-veya--or- types, null değeridir.types is null.

types çok boyutludur.types is multidimensional.

-veya--or- modifiers çok boyutludur.modifiers is multidimensional.

-veya--or- typesmodifiersaynı uzunlukta değildir.types and modifiers do not have the same length.

Öğesi types null .An element of types is null.

Örnekler

Aşağıdaki örnek Type öğesine karşılık gelen bir nesnesi edinir MyPropertyClass ve bu sınıfın dizinli özelliği yöntemine geçirilen bağımsız değişkenler kullanılarak alınır GetProperty .The following example obtains a Type object corresponding to MyPropertyClass, and the indexed property of this class is retrieved using the arguments passed to the GetProperty method.

using namespace System;
using namespace System::Reflection;
public ref class MyPropertyClass
{
private:
   array<int, 2>^ myPropertyArray;

public:

   property int Item [int, int]
   {
      // Declare an indexer.
      int get( int i, int j )
      {
         return myPropertyArray[ i,j ];
      }

      void set( int i, int j, int value )
      {
         myPropertyArray[ i,j ] = value;
      }

   }

};

int main()
{
   try
   {
      Type^ myType = MyPropertyClass::typeid;
      array<Type^>^myTypeArray = gcnew array<Type^>(2);
      
      // Create an instance of the Type array representing the number, order
      // and type of the parameters for the property.
      myTypeArray->SetValue( int::typeid, 0 );
      myTypeArray->SetValue( int::typeid, 1 );
      
      // Search for the indexed property whose parameters match the
      // specified argument types and modifiers.
      PropertyInfo^ myPropertyInfo = myType->GetProperty( "Item", int::typeid, myTypeArray, nullptr );
      Console::WriteLine( "{0}.{1} has a property type of {2}", myType->FullName, myPropertyInfo->Name, myPropertyInfo->PropertyType );
   }
   catch ( Exception^ ex ) 
   {
      Console::WriteLine( "An exception occurred {0}", ex->Message );
   }

}
using System;
using System.Reflection;
public class MyPropertyClass
{
    private int [,] myPropertyArray = new int[10,10];
    // Declare an indexer.
    public int this [int i,int j]
    {
        get
        {
            return myPropertyArray[i,j];
        }
        set
        {
            myPropertyArray[i,j] = value;
        }
    }
}
public class MyTypeClass
{
    public static void Main()
    {
        try
        {
            Type myType=typeof(MyPropertyClass);
            Type[] myTypeArray = new Type[2];
            // Create an instance of the Type array representing the number, order
            // and type of the parameters for the property.
            myTypeArray.SetValue(typeof(int),0);
            myTypeArray.SetValue(typeof(int),1);
            // Search for the indexed property whose parameters match the
            // specified argument types and modifiers.
            PropertyInfo myPropertyInfo = myType.GetProperty("Item",
                typeof(int),myTypeArray,null);
            Console.WriteLine(myType.FullName + "." + myPropertyInfo.Name +
                " has a property type of " + myPropertyInfo.PropertyType);
         }
        catch(Exception ex)
        {
            Console.WriteLine("An exception occurred " + ex.Message);
        }
    }
}
Imports System.Reflection

Public Class MyPropertyClass
    Private myPropertyArray(9, 9) As Integer
    ' Declare an indexer.
    Default Public Property Item(ByVal i As Integer, ByVal j As Integer) As Integer
        Get
            Return myPropertyArray(i, j)
        End Get
        Set(ByVal Value As Integer)
            myPropertyArray(i, j) = Value
        End Set
    End Property
End Class

Public Class MyTypeClass
    Public Shared Sub Main()
        Try
            Dim myType As Type = GetType(MyPropertyClass)
            Dim myTypeArray(1) As Type
            ' Create an instance of a Type array representing the number, order 
            ' and type of the parameters for the property.
            myTypeArray.SetValue(GetType(Integer), 0)
            myTypeArray.SetValue(GetType(Integer), 1)
            ' Search for the indexed property whose parameters match the
            ' specified argument types and modifiers.
            Dim myPropertyInfo As PropertyInfo = myType.GetProperty("Item", _
                  GetType(Integer), myTypeArray, Nothing)
            Console.WriteLine(myType.FullName + "." + myPropertyInfo.Name + _
                  " has a property  type of " + myPropertyInfo.PropertyType.ToString())
        Catch ex As Exception
            Console.WriteLine("An exception occurred " + ex.Message.ToString())
        End Try
    End Sub
End Class

Açıklamalar

Bir özelliğin en az bir genel erişimcisi varsa, o özellik yansıma için genel sayılır.A property is considered public to reflection if it has at least one accessor that is public. Aksi takdirde özellik private olarak kabul edilir ve BindingFlags.NonPublic | | kullanmanız gerekir BindingFlags.Instance BindingFlags.Static (Visual Basic ' de değerleri birleştirerek Or ).Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Varsayılan bağlayıcı işlem yapmaz ParameterModifier ( modifiers parametresi), ancak System.Reflection.Binder işlem yapan özel bir cilt yazmak için soyut sınıfı kullanabilirsiniz modifiers .Although the default binder does not process ParameterModifier (the modifiers parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers. ParameterModifier yalnızca COM birlikte çalışabilirliğine çağrı yapılırken kullanılır ve yalnızca başvuru ile geçirilen parametreler işlenir.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

Arama name büyük/küçük harfe duyarlıdır.The search for name is case-sensitive. Arama, genel statik ve genel örnek özelliklerini içerir.The search includes public static and public instance properties.

Geçerli, Type oluşturulmuş bir genel türü temsil ediyorsa, bu yöntem PropertyInfo uygun tür bağımsız değişkenleri ile değiştirilmiş tür parametreleri ile birlikte döndürür.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Geçerli, Type genel bir türün veya genel yöntemin tanımındaki bir tür parametresini temsil ediyorsa, bu yöntem sınıf kısıtlamasının özelliklerini arar.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Dizin Oluşturucular ve Varsayılan ÖzelliklerIndexers and Default Properties

Visual Basic 2005, Visual C# 2005 ve Visual C++ 2005, dizinli özelliklere erişmek için Basitleştirilmiş sözdizimine sahiptir ve bir dizinli özelliğin türü için varsayılan değer olmasını sağlar.Visual Basic 2005, Visual C# 2005, and Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Örneğin, değişkeni myList bir öğesine başvuruyorsa ArrayList , sözdizimi myList[3] ( myList(3) Visual Basic), öğesini 3 diziniyle alır.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Özelliği aşırı yükleyebilirsiniz.You can overload the property.

C# ' de, bu özelliğe bir Dizin Oluşturucu denir ve ada göre başvuruda bulunulemez.In C#, this feature is called an indexer and cannot be referred to by name. Varsayılan olarak, bir C# Dizin Oluşturucusu meta verilerde "Item" adlı dizinli özellik olarak görünür.By default, a C# indexer appears in metadata as an indexed property named "Item". Ancak, bir sınıf kitaplığı geliştiricisi IndexerNameAttribute meta verilerde dizin oluşturucunun adını değiştirmek için özniteliğini kullanabilir.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Örneğin, String sınıfında adlı bir dizin oluşturucu vardır Chars[] .For example, the String class has an indexer named Chars[]. C# dışındaki diller kullanılarak oluşturulan dizinlenmiş özelliklerin Madde dışında adları da olabilir.Indexed properties created using languages other than C# can have names other than Item, as well.

Bir türün varsayılan özelliğe sahip olup olmadığını anlamak için, GetCustomAttributes(Type, Boolean) özniteliğini test etmek için yöntemini kullanın DefaultMemberAttribute .To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Tür varsa DefaultMemberAttribute , MemberName özelliği varsayılan özelliğin adını döndürür.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Ayrıca bkz.

Şunlara uygulanır

GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])

Belirtilen bağlama kısıtlamalarını kullanarak parametreleri belirtilen bağımsız değişken türleri ve değiştiriciler ile eşleşen belirtilen özelliği arar.Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, Type ^ returnType, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.PropertyInfo? GetProperty (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, Type? returnType, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
public System.Reflection.PropertyInfo GetProperty (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, Type returnType, Type[] types, System.Reflection.ParameterModifier[] modifiers);
abstract member GetProperty : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, bindingAttr As BindingFlags, binder As Binder, returnType As Type, types As Type(), modifiers As ParameterModifier()) As PropertyInfo

Parametreler

name
String

Alınacak özelliğin adını içeren dize.The string containing the name of the property to get.

bindingAttr
BindingFlags

Aramanın nasıl yürütüldüğünü belirten numaralandırma değerlerinin bit düzeyinde birleşimi.A bitwise combination of the enumeration values that specify how the search is conducted.

-veya--or- Default dönün null .Default to return null.

binder
Binder

Aşırı yüklenmiş yöntem seçimi, bağımsız değişken türlerinin uygulatılması ve yansıtma yoluyla bir üyenin çağrılması işlemlerini içerebilen; özellikler kümesini tanımlayan ve bağlama işlemine olanak veren bir nesne.An object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.

-veya--or- Öğesini kullanmak için null bir başvuru ( Nothing Visual Basic) DefaultBinder .A null reference (Nothing in Visual Basic), to use the DefaultBinder.

returnType
Type

Özelliğinin dönüş türü.The return type of the property.

types
Type[]

TypeAlınacak dizinli özelliğin parametre sayısını, sırasını ve türünü temsil eden bir nesne dizisi.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

-veya--or- TypeDizine alınmamış bir özelliği almak için türün boş bir dizisi (yani, Type [] types = new Type [0]).An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

ParameterModifierDizide karşılık gelen öğeyle ilişkili öznitelikleri temsil eden nesne dizisi types .An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. Varsayılan bağlayıcı bu parametreyi işlemez.The default binder does not process this parameter.

Döndürülenler

PropertyInfo

Bulunursa, belirtilen gereksinimlerle eşleşen özelliği temsil eden bir nesne; Aksi takdirde, null .An object representing the property that matches the specified requirements, if found; otherwise, null.

Uygulamalar

Özel durumlar

Belirtilen ada sahip ve belirtilen bağlama kısıtlamalarıyla eşleşen birden fazla özellik bulundu.More than one property is found with the specified name and matching the specified binding constraints.

name, null değeridir.name is null.

-veya--or- types, null değeridir.types is null.

types çok boyutludur.types is multidimensional.

-veya--or- modifiers çok boyutludur.modifiers is multidimensional.

-veya--or- typesmodifiersaynı uzunlukta değildir.types and modifiers do not have the same length.

Öğesi types null .An element of types is null.

Açıklamalar

Bir özelliğin en az bir genel erişimcisi varsa, o özellik yansıma için genel sayılır.A property is considered public to reflection if it has at least one accessor that is public. Aksi takdirde özellik private olarak kabul edilir ve BindingFlags.NonPublic | | kullanmanız gerekir BindingFlags.Instance BindingFlags.Static (Visual Basic ' de değerleri birleştirerek Or ).Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Varsayılan bağlayıcı işlem yapmaz ParameterModifier ( modifiers parametresi), ancak System.Reflection.Binder işlem yapan özel bir cilt yazmak için soyut sınıfı kullanabilirsiniz modifiers .Although the default binder does not process ParameterModifier (the modifiers parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers. ParameterModifier yalnızca COM birlikte çalışabilirliğine çağrı yapılırken kullanılır ve yalnızca başvuru ile geçirilen parametreler işlenir.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

Aşağıdaki tabloda, Get bir tür üzerinde yansıtılırken yöntemler tarafından bir temel sınıfın hangi üyelerinin döndürüldüğü gösterilmektedir.The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

Üye TürüMember Type StatikStatic Statik OlmayanNon-Static
OluşturucuConstructor HayırNo HayırNo
AlanField HayırNo Evet.Yes. Bir alan her zaman "ada ve imzaya göre gizle" özelliğindedir.A field is always hide-by-name-and-signature.
OlayEvent UygulanamazNot applicable Ortak tür sistemi kuralı, devralma işleminin özelliği uygulayan yöntemlerinkiyle aynı olmasıdır.The common type system rule is that the inheritance is the same as that of the methods that implement the property. Yansıma, özellikleri "ada ve imzaya göre gizle" şeklinde kullanır.Reflection treats properties as hide-by-name-and-signature. Aşağıdaki 2. nota bakın.See note 2 below.
YöntemMethod HayırNo Evet.Yes. Bir yöntem (sanal ve sanal olmayan) "ada göre gizle" veya "ada ve imzaya göre gizle" özelliğinde olabilir.A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
İç İçe TürNested Type HayırNo HayırNo
ÖzellikProperty UygulanamazNot applicable Ortak tür sistemi kuralı, devralma işleminin özelliği uygulayan yöntemlerinkiyle aynı olmasıdır.The common type system rule is that the inheritance is the same as that of the methods that implement the property. Yansıma, özellikleri "ada ve imzaya göre gizle" şeklinde kullanır.Reflection treats properties as hide-by-name-and-signature. Aşağıdaki 2. nota bakın.See note 2 below.
  1. "Ada ve imzaya göre gizle" özelliği, imzanın tüm parçalarını (özel değiştiriciler, dönüş türleri, parametre türleri, başlangıç/bitiş simgeleri ve yönetilmeyen çağrı kuralları dahil) dikkate alır.Hide-by-name-and-signature considers all of the parts of the signature, including custom modifiers, return types, parameter types, sentinels, and unmanaged calling conventions. Bu ikili bir karşılaştırmadır.This is a binary comparison.

  2. Yansıma için, özellikler ve olaylar "ada ve imzaya göre gizle" özelliğindedir.For reflection, properties and events are hide-by-name-and-signature. Bu temel sınıfta hem alma hem de ayarlama erişimcisine sahip bir özelliğiniz varsa, ancak türetilen sınıfın yalnızca bir alma erişimcisi varsa, türetilen sınıf özelliği temel sınıf özelliğini gizler ve siz de temel sınıfta ayarlayıcıya erişemezsiniz.If you have a property with both a get and a set accessor in the base class, but the derived class has only a get accessor, the derived class property hides the base class property, and you will not be able to access the setter on the base class.

  3. Özel öznitelikler ortak tür sisteminin parçası değildir.Custom attributes are not part of the common type system.

BindingFlagsAramaya eklenecek özellikleri tanımlamak için aşağıdaki filtre bayrakları kullanılabilir:The following BindingFlags filter flags can be used to define which properties to include in the search:

  • BindingFlags.Instance BindingFlags.Static Dönüş almak için ya da ' i belirtmeniz gerekir.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • BindingFlags.PublicAramaya genel özellikler dahil etmek için belirtin.Specify BindingFlags.Public to include public properties in the search.

  • BindingFlags.NonPublicAramada ortak olmayan özellikleri (yani özel, iç ve korumalı özellikleri) dahil etmek için belirtin.Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • BindingFlags.FlattenHierarchyHiyerarşinin dahil edileceğini public ve protected statik üyelerini belirtin; private devralınan sınıflarda statik üyeler dahil değildir.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

BindingFlagsAramanın nasıl çalıştığını değiştirmek için aşağıdaki değiştirici bayrakları kullanılabilir:The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCase durumunu yok saymak için name .BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnly yalnızca ' de belirtilen özellikleri aramak için Type , yalnızca devralınmış özelliklerde değil.BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

Daha fazla bilgi edinmek için bkz. System.Reflection.BindingFlags.See System.Reflection.BindingFlags for more information.

Geçerli, Type oluşturulmuş bir genel türü temsil ediyorsa, bu yöntem PropertyInfo uygun tür bağımsız değişkenleri ile değiştirilmiş tür parametreleri ile birlikte döndürür.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Geçerli, Type genel bir türün veya genel yöntemin tanımındaki bir tür parametresini temsil ediyorsa, bu yöntem sınıf kısıtlamasının özelliklerini arar.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Dizin Oluşturucular ve Varsayılan ÖzelliklerIndexers and Default Properties

Visual Basic 2005, Visual C# 2005 ve Visual C++ 2005, dizinli özelliklere erişmek için Basitleştirilmiş sözdizimine sahiptir ve bir dizinli özelliğin türü için varsayılan değer olmasını sağlar.Visual Basic 2005, Visual C# 2005, and Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Örneğin, değişkeni myList bir öğesine başvuruyorsa ArrayList , sözdizimi myList[3] ( myList(3) Visual Basic), öğesini 3 diziniyle alır.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Özelliği aşırı yükleyebilirsiniz.You can overload the property.

C# ' de, bu özelliğe bir Dizin Oluşturucu denir ve ada göre başvuruda bulunulemez.In C#, this feature is called an indexer and cannot be referred to by name. Varsayılan olarak, bir C# Dizin Oluşturucusu meta verilerde "Item" adlı dizinli özellik olarak görünür.By default, a C# indexer appears in metadata as an indexed property named "Item". Ancak, bir sınıf kitaplığı geliştiricisi IndexerNameAttribute meta verilerde dizin oluşturucunun adını değiştirmek için özniteliğini kullanabilir.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Örneğin, String sınıfında adlı bir dizin oluşturucu vardır Chars[] .For example, the String class has an indexer named Chars[]. C# dışındaki diller kullanılarak oluşturulan dizinlenmiş özelliklerin Madde dışında adları da olabilir.Indexed properties created using languages other than C# can have names other than Item, as well.

Bir türün varsayılan özelliğe sahip olup olmadığını anlamak için, GetCustomAttributes(Type, Boolean) özniteliğini test etmek için yöntemini kullanın DefaultMemberAttribute .To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Tür varsa DefaultMemberAttribute , MemberName özelliği varsayılan özelliğin adını döndürür.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Ayrıca bkz.

Şunlara uygulanır