Type.GetProperty Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá konkrétní vlastnost aktuálního Type.
Přetížení
| Name | Description |
|---|---|
| GetProperty(String, Type, Type[]) |
Vyhledá zadanou veřejnou vlastnost, jejíž parametry odpovídají zadaným typům argumentů. |
| GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]) |
Vyhledá zadanou vlastnost, jejíž parametry odpovídají zadaným typům argumentů a modifikátorům, pomocí zadaných omezení vazby. |
| GetProperty(String, Type, Type[], ParameterModifier[]) |
Vyhledá zadanou veřejnou vlastnost, jejíž parametry odpovídají zadaným typům argumentů a modifikátorům. |
| GetProperty(String, Type[]) |
Vyhledá zadanou veřejnou vlastnost, jejíž parametry odpovídají zadaným typům argumentů. |
| GetProperty(String, Type) |
Vyhledá veřejnou vlastnost se zadaným názvem a návratovým typem. |
| GetProperty(String, BindingFlags) |
Vyhledá zadanou vlastnost pomocí zadaných omezení vazby. |
| GetProperty(String) |
Vyhledá veřejnou vlastnost se zadaným názvem. |
GetProperty(String, Type, Type[])
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
Vyhledá zadanou veřejnou vlastnost, jejíž parametry odpovídají zadaným typům argumentů.
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);
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)]
public System.Reflection.PropertyInfo? GetProperty(string name, Type? returnType, Type[] types);
public System.Reflection.PropertyInfo GetProperty(string name, Type returnType, Type[] types);
public System.Reflection.PropertyInfo? GetProperty(string name, Type? returnType, Type[] types);
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)>]
member this.GetProperty : string * Type * Type[] -> System.Reflection.PropertyInfo
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
Parametry
- name
- String
Řetězec obsahující název veřejné vlastnosti, který chcete získat.
- returnType
- Type
Návratový typ vlastnosti.
- types
- Type[]
Pole objektů představujících Type číslo, pořadí a typ parametrů indexované vlastnosti získat.
nebo
Prázdné pole typu Type (to znamená Type[] types = new Type[0]) pro získání vlastnosti, která není indexována.
Návraty
Objekt představující veřejnou vlastnost, jejíž parametry odpovídají zadaným typům argumentů, pokud jsou nalezeny; v opačném případě . null
Implementuje
- Atributy
Výjimky
Byla nalezena více než jedna vlastnost se zadaným názvem a shodným se zadanými typy argumentů.
types je multidimenzionální.
types Prvek je null.
Poznámky
Vlastnost je považována za veřejnou pro reflexi, pokud má alespoň jeden přístup, který je veřejný. V opačném případě je vlastnost považována za soukromou a k jejímu získání je nutné použít BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (v jazyce Visual Basic zkombinovat hodnoty pomocí).Or
Hledání pro name rozlišuje malá a velká písmena. Hledání obsahuje veřejné statické a veřejné vlastnosti instance.
Pokud aktuální Type představuje vytvořený obecný typ, tato metoda vrátí PropertyInfo s parametry typu nahrazené odpovídajícími argumenty typu.
Pokud aktuální Type představuje parametr typu v definici obecného typu nebo obecné metody, tato metoda hledá vlastnosti omezení třídy.
Viz také
- PropertyInfo
- String
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
Platí pro
GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
Vyhledá zadanou vlastnost, jejíž parametry odpovídají zadaným typům argumentů a modifikátorům, pomocí zadaných omezení vazby.
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);
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicProperties | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)]
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);
public System.Reflection.PropertyInfo? GetProperty(string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, Type? returnType, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicProperties | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)>]
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
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
Parametry
- name
- String
Řetězec obsahující název vlastnosti, která se má získat.
- bindingAttr
- BindingFlags
Bitové kombinace hodnot výčtu, které určují způsob provedení hledání.
nebo
Default
nullvrátit .
- binder
- Binder
Objekt, který definuje sadu vlastností a umožňuje vazbu, která může zahrnovat výběr přetížené metody, převod typů argumentů a vyvolání člena prostřednictvím reflexe.
nebo
Odkaz null (Nothing v Visual Basic) pro použití DefaultBinder.
- returnType
- Type
Návratový typ vlastnosti.
- types
- Type[]
Pole objektů představujících Type číslo, pořadí a typ parametrů indexované vlastnosti získat.
nebo
Prázdné pole typu Type (to znamená Type[] types = new Type[0]) pro získání vlastnosti, která není indexována.
- modifiers
- ParameterModifier[]
Pole ParameterModifier objektů představující atributy přidružené k odpovídajícímu prvku v types poli. Výchozí pořadač tento parametr nezpracuje.
Návraty
Objekt představující vlastnost, která odpovídá zadaným požadavkům, pokud byl nalezen; v opačném případě . null
Implementuje
- Atributy
Výjimky
Nachází se více než jedna vlastnost se zadaným názvem a odpovídá zadaným omezením vazby.
types je multidimenzionální.
nebo
modifiers je multidimenzionální.
nebo
types a modifiers nemají stejnou délku.
types Prvek je null.
Poznámky
Následující pokyny platí pro všechna přetížení:
- Vlastnost je považována za veřejnou pro reflexi, pokud má alespoň jeden přístup, který je veřejný. V opačném případě je vlastnost považována za soukromou a k jejímu získání je nutné použít BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (v jazyce Visual Basic zkombinovat hodnoty pomocí).
Or - Pokud aktuální Type představuje vytvořený obecný typ, tato metoda vrátí PropertyInfo s parametry typu nahrazené odpovídajícími argumenty typu.
- Pokud aktuální Type představuje parametr typu v definici obecného typu nebo obecné metody, tato metoda hledá vlastnosti omezení třídy.
metoda GetProperty(String)
Hledání pro name rozlišuje malá a velká písmena. Hledání obsahuje veřejné statické a veřejné vlastnosti instance.
Situace, ve kterých nastává AmbiguousMatchException, zahrnují:
- Typ obsahuje dvě indexované vlastnosti, které mají stejný název, ale různá čísla parametrů. K vyřešení nejednoznačnosti použijte přetížení metody GetProperty, které určuje typy parametrů.
- Odvozený typ deklaruje vlastnost, která skryje zděděnou vlastnost se stejným názvem pomocí modifikátoru
new(Shadowsv jazyce Visual Basic). K vyřešení nejednoznačnosti použijte přetížení metody GetProperty(String, BindingFlags) a přidejte příznak BindingFlags.DeclaredOnly k omezení vyhledávání na členy, které nejsou děděné.
metoda GetProperty(String, BindingFlags)
BindingFlags Následující příznaky filtru lze použít k definování vlastností, které se mají zahrnout do hledání:
- Abyste získali vrácení, je nutné zadat buď
BindingFlags.InstanceneboBindingFlags.Static. - Zadejte
BindingFlags.Public, aby se do hledání zahrnuly veřejné vlastnosti. - Zadejte
BindingFlags.NonPublic, aby se do hledání zahrnuly neveřejné vlastnosti (tj. soukromé, interní a chráněné vlastnosti). - Určete
BindingFlags.FlattenHierarchy, aby se zahrnulypublicaprotectedstatické členy v hierarchii; aleprivatestatické členy v zděděných třídách nejsou zahrnuty.
Ke změně fungování vyhledávání můžete použít následující BindingFlags modifikační příznaky:
-
BindingFlags.IgnoreCaseignorovat případname. -
BindingFlags.DeclaredOnlyhledat pouze vlastnosti deklarované v objektu Type, nikoli vlastnosti, které byly jednoduše zděděny.
Situace, ve kterých nastává AmbiguousMatchException, zahrnují:
- Typ obsahuje dvě indexované vlastnosti, které mají stejný název, ale různá čísla parametrů. K vyřešení nejednoznačnosti použijte přetížení metody GetProperty, které určuje typy parametrů.
- Odvozený typ deklaruje vlastnost, která skryje zděděnou vlastnost se stejným názvem pomocí
newmodifikátoru (Shadowsv jazyce Visual Basic). Chcete-li vyřešit nejednoznačnost, zahrňte BindingFlags.DeclaredOnly omezení vyhledávání na členy, které nejsou zděděné.
GetProperty(System.String, System.Reflection.BindingFlags, System.Reflection.Binder, System.Type, System.Type[], System.Reflection.ParameterModifier[]) metoda
I když výchozí pořadač nezpracovává ParameterModifier ( modifiers parametr), můžete použít abstraktní System.Reflection.Binder třídu k zápisu vlastního pořadače, který zpracovává modifiers.
ParameterModifier se používá pouze při volání přes COM interop a jsou zpracovávány pouze parametry předané odkazem.
Následující tabulka ukazuje, jaké členy základní třídy jsou vráceny metodami Get při reflexi typu.
| Typ členu | Statický. | Nestatické |
|---|---|---|
| Konstruktor | No | No |
| Pole | No | Yes. Pole se vždy skryje podle názvu a signatury. |
| Event | Není relevantní | Běžné pravidlo systému typů je, že dědičnost je stejná jako u metod, které implementují vlastnost. Reflexe zachází s vlastnostmi jako se skrýváním podle názvu a podpisu. 2 |
| Metoda | No | Yes. Metodu (virtuální i ne virtuální) lze skrýt podle názvu nebo skrýt podle názvu a podpisu. |
| Vnořený typ | No | No |
| Property | Není relevantní | Běžné pravidlo systému typů je, že dědičnost je stejná jako u metod, které implementují vlastnost. Reflexe zachází s vlastnostmi jako se skrýváním podle názvu a podpisu. 2 |
Notes:
- Funkce skrytí podle jména a podpisu zohledňuje všechny části podpisu, včetně vlastních modifikátorů, návratových typů, typů parametrů, sentinelů a nespravovaných konvencí volání. Jedná se o binární porovnání.
- Pro reflexi jsou vlastnosti a události skryty podle názvu a podpisu. Pokud máte vlastnost s oběma přístupovými metodami get i set v základní třídě, ale odvozená třída má pouze přístupovou metodu get, odvozená třída překryje vlastnost základní třídy a nebudete mít přístup k nastavovací metodě základní třídy.
- Vlastní atributy nejsou součástí systému běžných typů.
BindingFlags Následující příznaky filtru lze použít k definování vlastností, které se mají zahrnout do hledání:
- Abyste získali vrácení, je nutné zadat buď
BindingFlags.InstanceneboBindingFlags.Static. - Zadejte
BindingFlags.Public, aby se do hledání zahrnuly veřejné vlastnosti. - Zadejte
BindingFlags.NonPublic, aby se do hledání zahrnuly neveřejné vlastnosti (tj. soukromé, interní a chráněné vlastnosti). - Určete
BindingFlags.FlattenHierarchy, aby se zahrnulypublicaprotectedstatické členy v hierarchii; aleprivatestatické členy v zděděných třídách nejsou zahrnuty.
Ke změně fungování vyhledávání můžete použít následující BindingFlags modifikační příznaky:
-
BindingFlags.IgnoreCaseignorovat případname. -
BindingFlags.DeclaredOnlyhledat pouze vlastnosti deklarované v objektu Type, nikoli vlastnosti, které byly jednoduše zděděny.
Indexery a výchozí vlastnosti
Jazyk Visual Basic, C# a C++ mají zjednodušenou syntaxi pro přístup k indexovaným vlastnostem a umožňují, aby jedna indexovaná vlastnost byla výchozím nastavením pro jeho typ. Pokud například proměnná myList odkazuje na ArrayList, syntaxe myList[3] (myList(3) v jazyce Visual Basic) získá prvek s indexem 3. Vlastnost můžete přetížit.
V jazyce C# se tato funkce nazývá indexer a nemůže být odkazována podle názvu. Ve výchozím nastavení se indexer jazyka C# zobrazí v metadatech jako indexovaná vlastnost s názvem Item. Vývojář knihovny tříd však může pomocí IndexerNameAttribute atributu změnit název indexeru v metadatech. Třída má například String indexer pojmenovaný Chars[]. Indexované vlastnosti vytvořené pomocí jiných jazyků než C# můžou mít jiné názvy než Itema také.
Chcete-li zjistit, zda typ má výchozí vlastnost, použijte metodu GetCustomAttributes(Type, Boolean) k otestování atributu DefaultMemberAttribute . Pokud typ obsahuje DefaultMemberAttribute, vlastnost MemberName vrátí název výchozí vlastnosti.
Viz také
- PropertyInfo
- String
- BindingFlags
- Binder
- DefaultBinder
- ParameterModifier
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
Platí pro
GetProperty(String, Type, Type[], ParameterModifier[])
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
Vyhledá zadanou veřejnou vlastnost, jejíž parametry odpovídají zadaným typům argumentů a modifikátorům.
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);
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)]
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);
public System.Reflection.PropertyInfo? GetProperty(string name, Type? returnType, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)>]
member this.GetProperty : string * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
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
Parametry
- name
- String
Řetězec obsahující název veřejné vlastnosti, který chcete získat.
- returnType
- Type
Návratový typ vlastnosti.
- types
- Type[]
Pole objektů představujících Type číslo, pořadí a typ parametrů indexované vlastnosti získat.
nebo
Prázdné pole typu Type (to znamená Type[] types = new Type[0]) pro získání vlastnosti, která není indexována.
- modifiers
- ParameterModifier[]
Pole ParameterModifier objektů představující atributy přidružené k odpovídajícímu prvku v types poli. Výchozí pořadač tento parametr nezpracuje.
Návraty
Objekt představující veřejnou vlastnost, která odpovídá zadaným požadavkům, pokud byl nalezen; v opačném případě . null
Implementuje
- Atributy
Výjimky
Nachází se více než jedna vlastnost se zadaným názvem a odpovídá zadaným typům argumentů a modifikátorům.
types je multidimenzionální.
nebo
modifiers je multidimenzionální.
nebo
types a modifiers nemají stejnou délku.
types Prvek je null.
Příklady
Následující příklad získá Type objekt odpovídající MyPropertyClassa indexovaná vlastnost této třídy je načtena pomocí argumentů předaných metodě GetProperty .
using System;
using System.Reflection;
public class MyPropertyClass
{
private readonly 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);
}
}
}
open System
type MyPropertyClass() =
let myPropertyArray = Array2D.zeroCreate<int> 10 10
// Declare an indexed property.
member _.Item
with get (i, j) =
myPropertyArray[i, j]
and set (i, j) value =
myPropertyArray[i, j] <- value
try
let myType = typeof<MyPropertyClass>
let myTypeArray = Array.zeroCreate<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.
let myPropertyInfo = myType.GetProperty("Item", typeof<int>, myTypeArray, null)
printfn $"{myType.FullName}.{myPropertyInfo.Name} has a property type of {myPropertyInfo.PropertyType}"
with ex ->
printfn $"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 MyTypeClass21
Public Shared Sub Run()
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
Poznámky
Vlastnost je považována za veřejnou pro reflexi, pokud má alespoň jeden přístup, který je veřejný. V opačném případě je vlastnost považována za soukromou a k jejímu získání je nutné použít BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (v jazyce Visual Basic zkombinovat hodnoty pomocí).Or
I když výchozí pořadač nezpracovává ParameterModifier ( modifiers parametr), můžete použít abstraktní System.Reflection.Binder třídu k zápisu vlastního pořadače, který zpracovává modifiers.
ParameterModifier se používá pouze při volání přes COM interop a jsou zpracovávány pouze parametry předané odkazem.
Hledání pro name rozlišuje malá a velká písmena. Hledání obsahuje veřejné statické a veřejné vlastnosti instance.
Pokud aktuální Type představuje vytvořený obecný typ, tato metoda vrátí PropertyInfo s parametry typu nahrazené odpovídajícími argumenty typu.
Pokud aktuální Type představuje parametr typu v definici obecného typu nebo obecné metody, tato metoda hledá vlastnosti omezení třídy.
Viz také
- PropertyInfo
- String
- DefaultBinder
- ParameterModifier
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
Platí pro
GetProperty(String, Type[])
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
Vyhledá zadanou veřejnou vlastnost, jejíž parametry odpovídají zadaným typům argumentů.
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);
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)]
public System.Reflection.PropertyInfo? GetProperty(string name, Type[] types);
public System.Reflection.PropertyInfo GetProperty(string name, Type[] types);
public System.Reflection.PropertyInfo? GetProperty(string name, Type[] types);
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)>]
member this.GetProperty : string * Type[] -> System.Reflection.PropertyInfo
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
Parametry
- name
- String
Řetězec obsahující název veřejné vlastnosti, který chcete získat.
- types
- Type[]
Pole objektů představujících Type číslo, pořadí a typ parametrů indexované vlastnosti získat.
nebo
Prázdné pole typu Type (to znamená Type[] types = new Type[0]) pro získání vlastnosti, která není indexována.
Návraty
Objekt představující veřejnou vlastnost, jejíž parametry odpovídají zadaným typům argumentů, pokud jsou nalezeny; v opačném případě . null
Implementuje
- Atributy
Výjimky
Byla nalezena více než jedna vlastnost se zadaným názvem a shodným se zadanými typy argumentů.
types je multidimenzionální.
types Prvek je null.
Příklady
Následující příklad načte Type objekt uživatelem definované třídy, načte vlastnost této třídy a zobrazí název a typ vlastnosti podle zadaných argumentů předaných GetProperty.
using System;
using System.Reflection;
class MyClass3
{
private readonly 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 MyTypeClass3
{
public static void Main(string[] args)
{
try
{
// Get the Type object.
Type myType = typeof(MyClass3);
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 MyClass3.",
myPropInfo.ToString());
}
catch (NullReferenceException e)
{
Console.WriteLine("An exception occurred.");
Console.WriteLine("Source : {0}", e.Source);
Console.WriteLine("Message : {0}", e.Message);
}
}
}
open System
type MyClass1() =
let myArray = array2D [[1; 2]; [3; 4]]
// Declare an indexed property.
member _.Item
with get (i, j) =
myArray[i, j]
and set (i, j) value =
myArray[i, j] <- value
try
// Get the Type object.
let myType = typeof<MyClass1>
let myTypeArr = Array.zeroCreate<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.
let myPropInfo = myType.GetProperty("Item", myTypeArr)
// Display the property.
printfn $"The {myPropInfo} property exists in MyClass1."
with :? NullReferenceException as e ->
printfn "An exception occurred."
printfn $"Source : {e.Source}"
printfn $"Message : {e.Message}"
Imports System.Reflection
Module Module3
Class MyClass3
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 MyTypeClass3
Public Shared Sub Run()
Try
' Get the Type Object.
Dim myType As Type = GetType(MyClass3)
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 MyClass3.", 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 'Module3
Poznámky
Vlastnost je považována za veřejnou pro reflexi, pokud má alespoň jeden přístup, který je veřejný. V opačném případě je vlastnost považována za soukromou a k jejímu získání je nutné použít BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (v jazyce Visual Basic zkombinovat hodnoty pomocí).Or
Hledání pro name rozlišuje malá a velká písmena. Hledání obsahuje veřejné statické a veřejné vlastnosti instance.
Pokud aktuální Type představuje vytvořený obecný typ, tato metoda vrátí PropertyInfo s parametry typu nahrazené odpovídajícími argumenty typu.
Pokud aktuální Type představuje parametr typu v definici obecného typu nebo obecné metody, tato metoda hledá vlastnosti omezení třídy.
Viz také
- PropertyInfo
- String
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
Platí pro
GetProperty(String, Type)
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
Vyhledá veřejnou vlastnost se zadaným názvem a návratovým typem.
public:
System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType);
public:
virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType);
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)]
public System.Reflection.PropertyInfo? GetProperty(string name, Type? returnType);
public System.Reflection.PropertyInfo GetProperty(string name, Type returnType);
public System.Reflection.PropertyInfo? GetProperty(string name, Type? returnType);
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)>]
member this.GetProperty : string * Type -> System.Reflection.PropertyInfo
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
Parametry
- name
- String
Řetězec obsahující název veřejné vlastnosti, který chcete získat.
- returnType
- Type
Návratový typ vlastnosti.
Návraty
Objekt představující veřejnou vlastnost se zadaným názvem, pokud byl nalezen; v opačném případě . null
Implementuje
- Atributy
Výjimky
Byla nalezena více než jedna vlastnost se zadaným názvem.
name je null, nebo returnType je null.
Příklady
Následující příklad definuje třídu s jednou vlastností a načte název a typ vlastnosti.
using System;
using System.Reflection;
class MyPropertyTypeClass
{
public string MyProperty1 { get; set; } = "Hello World.";
}
class TestClass
{
static void Main()
{
try
{
Type myType = typeof(MyPropertyTypeClass);
// Get the PropertyInfo object representing MyProperty1.
PropertyInfo myStringProperties1 = myType.GetProperty("MyProperty1", typeof(string));
Console.WriteLine("The name of the first property of MyPropertyTypeClass is {0}.",
myStringProperties1.Name);
Console.WriteLine("The type of the first property of MyPropertyTypeClass 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 MyPropertyTypeClass is MyProperty1.
//The type of the first property of MyPropertyTypeClass is System.String.
}
}
open System
open System.Reflection
type MyClass1() =
let mutable myMessage = "Hello World."
member _.MyProperty1
with get () =
myMessage
and set (value) =
myMessage <- value
try
let myType = typeof<MyClass1>
// Get the PropertyInfo object representing MyProperty1.
let myStringProperties1 = myType.GetProperty("MyProperty1", typeof<string>)
printfn $"The name of the first property of MyClass1 is {myStringProperties1.Name}."
printfn $"The type of the first property of MyClass1 is {myStringProperties1.PropertyType}."
with
| :? ArgumentNullException as e ->
printfn $"ArgumentNullException :{e.Message}"
| :? AmbiguousMatchException as e ->
printfn $"AmbiguousMatchException :{e.Message}"
| :? NullReferenceException as e ->
printfn $"Source : {e.Source}"
printfn $"Message : {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 MyTypesClass
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 Run()
Try
Dim myType As Type = GetType(MyTypesClass)
' Get the PropertyInfo object representing MyProperty1.
Dim myStringProperties1 As PropertyInfo = myType.GetProperty("MyProperty1", GetType(String))
Console.WriteLine("The name of the first property of MyTypesClass is {0}.", myStringProperties1.Name)
Console.WriteLine("The type of the first property of MyTypesClass 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 MyTypesClass is MyProperty1.
'The type of the first property of MyTypesClass is System.String.
End Sub
End Class
Poznámky
Vlastnost je považována za veřejnou pro reflexi, pokud má alespoň jeden přístup, který je veřejný. V opačném případě je vlastnost považována za soukromou a k jejímu získání je nutné použít BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (v jazyce Visual Basic zkombinovat hodnoty pomocí).Or
Hledání pro name rozlišuje malá a velká písmena. Hledání obsahuje veřejné statické a veřejné vlastnosti instance.
Pokud aktuální Type představuje vytvořený obecný typ, tato metoda vrátí PropertyInfo s parametry typu nahrazené odpovídajícími argumenty typu.
Pokud aktuální Type představuje parametr typu v definici obecného typu nebo obecné metody, tato metoda hledá vlastnosti omezení třídy.
Viz také
- PropertyInfo
- String
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
Platí pro
GetProperty(String, BindingFlags)
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
Vyhledá zadanou vlastnost pomocí zadaných omezení vazby.
public:
virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, System::Reflection::BindingFlags bindingAttr);
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicProperties | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)]
public System.Reflection.PropertyInfo? GetProperty(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);
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.NonPublicProperties | System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)>]
abstract member GetProperty : string * System.Reflection.BindingFlags -> System.Reflection.PropertyInfo
override this.GetProperty : string * System.Reflection.BindingFlags -> System.Reflection.PropertyInfo
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
Parametry
- name
- String
Řetězec obsahující název vlastnosti, která se má získat.
- bindingAttr
- BindingFlags
Bitové kombinace hodnot výčtu, které určují způsob provedení hledání.
nebo
Default
nullvrátit .
Návraty
Objekt představující vlastnost, která odpovídá zadaným požadavkům, pokud byl nalezen; v opačném případě . null
Implementuje
- Atributy
Výjimky
Nachází se více než jedna vlastnost se zadaným názvem a odpovídá zadaným omezením vazby.
name je null.
Příklady
Následující příklad načte typ uživatelem definované třídy, načte vlastnost této třídy a zobrazí název vlastnosti v souladu se zadanými omezeními vazby.
using System;
using System.Reflection;
class MyClass2
{
// Declare MyProperty.
public int MyProperty { get; set; }
}
public class MyTypeClass2
{
public static void Main(string[] args)
{
try
{
// Get Type object of MyClass2.
Type myType = typeof(MyClass2);
// Get the PropertyInfo by passing the property name and specifying the BindingFlags.
PropertyInfo myPropInfo = myType.GetProperty(
"MyProperty",
BindingFlags.Public | BindingFlags.Instance
);
// Display Name property to console.
Console.WriteLine("{0} is a property of MyClass2.", myPropInfo.Name);
}
catch (NullReferenceException e)
{
Console.WriteLine("MyProperty does not exist in MyClass2." + e.Message);
}
}
}
open System
open System.Reflection
type MyClass() =
let mutable myProperty = 0
// Declare MyProperty.
member _.MyProperty
with get () =
myProperty
and set (value) =
myProperty <- value
try
// Get Type object of MyClass.
let myType = typeof<MyClass>
// Get the PropertyInfo by passing the property name and specifying the BindingFlags.
let myPropInfo = myType.GetProperty("MyProperty", BindingFlags.Public ||| BindingFlags.Instance)
// Display Name property to console.
printfn $"{myPropInfo.Name} is a property of MyClass."
with :? NullReferenceException as e ->
printfn $"MyProperty does not exist in MyClass.{e.Message}"
Imports System.Reflection
Module Module1
Public Class MyClass1
Private myProperty1 As Integer
Public Property MyProperty() As Integer
Get
Return myProperty1
End Get
Set(ByVal Value As Integer)
myProperty1 = Value
End Set
End Property
Public Shared Sub Run()
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
Viz také
- PropertyInfo
- String
- BindingFlags
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)
Platí pro
GetProperty(String)
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
- Zdroj:
- Type.cs
Vyhledá veřejnou vlastnost se zadaným názvem.
public:
System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name);
public:
virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name);
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)]
public System.Reflection.PropertyInfo? GetProperty(string name);
public System.Reflection.PropertyInfo GetProperty(string name);
public System.Reflection.PropertyInfo? GetProperty(string name);
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicProperties)>]
member this.GetProperty : string -> System.Reflection.PropertyInfo
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
Parametry
- name
- String
Řetězec obsahující název veřejné vlastnosti, který chcete získat.
Návraty
Objekt představující veřejnou vlastnost se zadaným názvem, pokud byl nalezen; v opačném případě . null
Implementuje
- Atributy
Výjimky
Byla nalezena více než jedna vlastnost se zadaným názvem.
name je null.
Příklady
Následující příklad načte Type objekt uživatelem definované třídy, načte vlastnost této třídy a zobrazí název vlastnosti.
using System;
using System.Reflection;
class MyClass1
{
// Declare MyProperty.
public int MyProperty { get; set; }
}
public class MyTypeClass1
{
public static void Main(string[] args)
{
try
{
// Get the Type object corresponding to MyClass1.
Type myType = typeof(MyClass1);
// 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 MyClass1.", myPropInfo.Name);
}
catch (NullReferenceException e)
{
Console.WriteLine("The property does not exist in MyClass1." + e.Message);
}
}
}
open System
type MyClass() =
let mutable myProperty = 0
// Declare MyProperty.
member _.MyProperty
with get () =
myProperty
and set (value) =
myProperty <- value
try
// Get the Type object corresponding to MyClass.
let myType = typeof<MyClass>
// Get the PropertyInfo object by passing the property name.
let myPropInfo = myType.GetProperty "MyProperty"
// Display the property name.
printfn $"The {myPropInfo.Name} property exists in MyClass."
with :? NullReferenceException as e ->
printfn $"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 Run(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 property 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
Poznámky
Následující pokyny platí pro všechna přetížení:
- Vlastnost je považována za veřejnou pro reflexi, pokud má alespoň jeden přístup, který je veřejný. V opačném případě je vlastnost považována za soukromou a k jejímu získání je nutné použít BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (v jazyce Visual Basic zkombinovat hodnoty pomocí).
Or - Pokud aktuální Type představuje vytvořený obecný typ, tato metoda vrátí PropertyInfo s parametry typu nahrazené odpovídajícími argumenty typu.
- Pokud aktuální Type představuje parametr typu v definici obecného typu nebo obecné metody, tato metoda hledá vlastnosti omezení třídy.
metoda GetProperty(String)
Hledání pro name rozlišuje malá a velká písmena. Hledání obsahuje veřejné statické a veřejné vlastnosti instance.
Situace, ve kterých nastává AmbiguousMatchException, zahrnují:
- Typ obsahuje dvě indexované vlastnosti, které mají stejný název, ale různá čísla parametrů. K vyřešení nejednoznačnosti použijte přetížení metody GetProperty, které určuje typy parametrů.
- Odvozený typ deklaruje vlastnost, která skryje zděděnou vlastnost se stejným názvem pomocí modifikátoru
new(Shadowsv jazyce Visual Basic). K vyřešení nejednoznačnosti použijte přetížení metody GetProperty(String, BindingFlags) a přidejte příznak BindingFlags.DeclaredOnly k omezení vyhledávání na členy, které nejsou děděné.
metoda GetProperty(String, BindingFlags)
BindingFlags Následující příznaky filtru lze použít k definování vlastností, které se mají zahrnout do hledání:
- Abyste získali vrácení, je nutné zadat buď
BindingFlags.InstanceneboBindingFlags.Static. - Zadejte
BindingFlags.Public, aby se do hledání zahrnuly veřejné vlastnosti. - Zadejte
BindingFlags.NonPublic, aby se do hledání zahrnuly neveřejné vlastnosti (tj. soukromé, interní a chráněné vlastnosti). - Určete
BindingFlags.FlattenHierarchy, aby se zahrnulypublicaprotectedstatické členy v hierarchii; aleprivatestatické členy v zděděných třídách nejsou zahrnuty.
Ke změně fungování vyhledávání můžete použít následující BindingFlags modifikační příznaky:
-
BindingFlags.IgnoreCaseignorovat případname. -
BindingFlags.DeclaredOnlyhledat pouze vlastnosti deklarované v objektu Type, nikoli vlastnosti, které byly jednoduše zděděny.
Situace, ve kterých nastává AmbiguousMatchException, zahrnují:
- Typ obsahuje dvě indexované vlastnosti, které mají stejný název, ale různá čísla parametrů. K vyřešení nejednoznačnosti použijte přetížení metody GetProperty, které určuje typy parametrů.
- Odvozený typ deklaruje vlastnost, která skryje zděděnou vlastnost se stejným názvem pomocí
newmodifikátoru (Shadowsv jazyce Visual Basic). Chcete-li vyřešit nejednoznačnost, zahrňte BindingFlags.DeclaredOnly omezení vyhledávání na členy, které nejsou zděděné.
GetProperty(System.String, System.Reflection.BindingFlags, System.Reflection.Binder, System.Type, System.Type[], System.Reflection.ParameterModifier[]) metoda
I když výchozí pořadač nezpracovává ParameterModifier ( modifiers parametr), můžete použít abstraktní System.Reflection.Binder třídu k zápisu vlastního pořadače, který zpracovává modifiers.
ParameterModifier se používá pouze při volání přes COM interop a jsou zpracovávány pouze parametry předané odkazem.
Následující tabulka ukazuje, jaké členy základní třídy jsou vráceny metodami Get při reflexi typu.
| Typ členu | Statický. | Nestatické |
|---|---|---|
| Konstruktor | No | No |
| Pole | No | Yes. Pole se vždy skryje podle názvu a signatury. |
| Event | Není relevantní | Běžné pravidlo systému typů je, že dědičnost je stejná jako u metod, které implementují vlastnost. Reflexe zachází s vlastnostmi jako se skrýváním podle názvu a podpisu. 2 |
| Metoda | No | Yes. Metodu (virtuální i ne virtuální) lze skrýt podle názvu nebo skrýt podle názvu a podpisu. |
| Vnořený typ | No | No |
| Property | Není relevantní | Běžné pravidlo systému typů je, že dědičnost je stejná jako u metod, které implementují vlastnost. Reflexe zachází s vlastnostmi jako se skrýváním podle názvu a podpisu. 2 |
Notes:
- Funkce skrytí podle jména a podpisu zohledňuje všechny části podpisu, včetně vlastních modifikátorů, návratových typů, typů parametrů, sentinelů a nespravovaných konvencí volání. Jedná se o binární porovnání.
- Pro reflexi jsou vlastnosti a události skryty podle názvu a podpisu. Pokud máte vlastnost s oběma přístupovými metodami get i set v základní třídě, ale odvozená třída má pouze přístupovou metodu get, odvozená třída překryje vlastnost základní třídy a nebudete mít přístup k nastavovací metodě základní třídy.
- Vlastní atributy nejsou součástí systému běžných typů.
BindingFlags Následující příznaky filtru lze použít k definování vlastností, které se mají zahrnout do hledání:
- Abyste získali vrácení, je nutné zadat buď
BindingFlags.InstanceneboBindingFlags.Static. - Zadejte
BindingFlags.Public, aby se do hledání zahrnuly veřejné vlastnosti. - Zadejte
BindingFlags.NonPublic, aby se do hledání zahrnuly neveřejné vlastnosti (tj. soukromé, interní a chráněné vlastnosti). - Určete
BindingFlags.FlattenHierarchy, aby se zahrnulypublicaprotectedstatické členy v hierarchii; aleprivatestatické členy v zděděných třídách nejsou zahrnuty.
Ke změně fungování vyhledávání můžete použít následující BindingFlags modifikační příznaky:
-
BindingFlags.IgnoreCaseignorovat případname. -
BindingFlags.DeclaredOnlyhledat pouze vlastnosti deklarované v objektu Type, nikoli vlastnosti, které byly jednoduše zděděny.
Indexery a výchozí vlastnosti
Jazyk Visual Basic, C# a C++ mají zjednodušenou syntaxi pro přístup k indexovaným vlastnostem a umožňují, aby jedna indexovaná vlastnost byla výchozím nastavením pro jeho typ. Pokud například proměnná myList odkazuje na ArrayList, syntaxe myList[3] (myList(3) v jazyce Visual Basic) získá prvek s indexem 3. Vlastnost můžete přetížit.
V jazyce C# se tato funkce nazývá indexer a nemůže být odkazována podle názvu. Ve výchozím nastavení se indexer jazyka C# zobrazí v metadatech jako indexovaná vlastnost s názvem Item. Vývojář knihovny tříd však může pomocí IndexerNameAttribute atributu změnit název indexeru v metadatech. Třída má například String indexer pojmenovaný Chars[]. Indexované vlastnosti vytvořené pomocí jiných jazyků než C# můžou mít jiné názvy než Itema také.
Chcete-li zjistit, zda typ má výchozí vlastnost, použijte metodu GetCustomAttributes(Type, Boolean) k otestování atributu DefaultMemberAttribute . Pokud typ obsahuje DefaultMemberAttribute, vlastnost MemberName vrátí název výchozí vlastnosti.
Viz také
- PropertyInfo
- String
- DefaultBinder
- GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
- GetProperties(BindingFlags)