Attribute.IsDefined Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, применен ли какой-либо настраиваемый атрибут указанного типа к сборке, модулю, члену типа или параметру метода.
| IsDefined(ParameterInfo, Type, Boolean) |
Определяет, применены ли какие-либо настраиваемые атрибуты к параметру метода. Параметры определяют параметр метода и тип настраиваемого атрибута для поиска и признак поиска родительского элемента параметра метода. |
| IsDefined(Module, Type, Boolean) |
Определяет, применены ли какие-либо настраиваемые атрибуты к модулю. Параметры определяют модуль, тип настраиваемого атрибута для поиска и игнорированный параметр поиска. |
| IsDefined(MemberInfo, Type, Boolean) |
Определяет, применены ли какие-либо настраиваемые атрибуты к члену типа. Параметры определяют член и тип настраиваемого атрибута для поиска и признак поиска родительского элемента члена. |
| IsDefined(Assembly, Type, Boolean) |
Определяет, применены ли какие-либо настраиваемые атрибуты к сборке. Параметры определяют сборку, тип настраиваемого атрибута для поиска и игнорированный параметр поиска. |
| IsDefined(MemberInfo, Type) |
Определяет, применены ли какие-либо настраиваемые атрибуты к члену типа. Параметры определяют член и тип настраиваемого атрибута для поиска. |
| IsDefined(Module, Type) |
Определяет применены ли какие-либо пользовательские атрибуты заданного типа к модулю. Параметры определяют модуль и тип настраиваемого атрибута для поиска. |
| IsDefined(Assembly, Type) |
Определяет, применены ли какие-либо настраиваемые атрибуты к сборке. Параметры определяют сборку и тип настраиваемого атрибута для поиска. |
| IsDefined(ParameterInfo, Type) |
Определяет, применены ли какие-либо настраиваемые атрибуты к параметру метода. Параметры определяют параметр метода и тип настраиваемого атрибута для поиска. |
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
Определяет, применены ли какие-либо настраиваемые атрибуты к параметру метода. Параметры определяют параметр метода и тип настраиваемого атрибута для поиска и признак поиска родительского элемента параметра метода.
public:
static bool IsDefined(System::Reflection::ParameterInfo ^ element, Type ^ attributeType, bool inherit);public static bool IsDefined (System.Reflection.ParameterInfo element, Type attributeType, bool inherit);static member IsDefined : System.Reflection.ParameterInfo * Type * bool -> boolPublic Shared Function IsDefined (element As ParameterInfo, attributeType As Type, inherit As Boolean) As BooleanПараметры
- element
- ParameterInfo
Объект, являющийся производным от класса ParameterInfo, который описывает параметр члена класса.
- attributeType
- Type
Тип или базовый тип искомого настраиваемого атрибута.
- inherit
- Boolean
Если true, задает для настраиваемых атрибутов поиск родительских элементов для element.
Возвращаемое значение
true, если настраиваемый атрибут типа attributeType применен к элементу, указанному в параметре element; в противном случае — false.
Исключения
Параметр element или attributeType имеет значение null.
Тип attributeType не является производным объекта Attribute.
element не является методом, конструктором или типом.
Примеры
В следующем примере кода показано использование IsDefined, принимая в ParameterInfo качестве параметра .
using namespace System;
using namespace System::Reflection;
namespace IsDef5CS
{
public ref class TestClass
{
public:
// Assign a ParamArray attribute to the parameter using the keyword.
void Method1(... array<String^>^args ){}
};
ref class DemoClass
{
public:
static void Main()
{
// Get the class type to access its metadata.
Type^ clsType = TestClass::typeid;
// Get the MethodInfo object for Method1.
MethodInfo^ mInfo = clsType->GetMethod( "Method1" );
// Get the ParameterInfo array for the method parameters.
array<ParameterInfo^>^pInfo = mInfo->GetParameters();
if ( pInfo != nullptr )
{
// See if the ParamArray attribute is defined.
bool isDef = Attribute::IsDefined( pInfo[ 0 ], ParamArrayAttribute::typeid );
// Display the result.
Console::WriteLine( "The ParamArray attribute {0} defined for "
"parameter {1} of method {2}.", isDef ? (String^)"is" : "is not", pInfo[ 0 ]->Name, mInfo->Name );
}
else
Console::WriteLine( "The parameters information could "
"not be retrieved for method {0}.", mInfo->Name );
}
};
}
/*
* Output:
* The ParamArray attribute is defined for parameter args of method Method1.
*/
using System;
using System.Reflection;
namespace IsDef5CS
{
public class TestClass
{
// Assign a ParamArray attribute to the parameter using the keyword.
public void Method1(params String[] args)
{}
}
public class DemoClass
{
static void Main(string[] args)
{
// Get the class type to access its metadata.
Type clsType = typeof(TestClass);
// Get the MethodInfo object for Method1.
MethodInfo mInfo = clsType.GetMethod("Method1");
// Get the ParameterInfo array for the method parameters.
ParameterInfo[] pInfo = mInfo.GetParameters();
if (pInfo != null)
{
// See if the ParamArray attribute is defined.
bool isDef = Attribute.IsDefined(pInfo[0],
typeof(ParamArrayAttribute));
// Display the result.
Console.WriteLine("The ParamArray attribute {0} defined for " +
"parameter {1} of method {2}.",
isDef ? "is" : "is not",
pInfo[0].Name,
mInfo.Name);
}
else
Console.WriteLine("The parameters information could " +
"not be retrieved for method {0}.", mInfo.Name);
}
}
}
/*
* Output:
* The ParamArray attribute is defined for parameter args of method Method1.
*/
open System;
type TestClass() =
// Assign a ParamArray attribute to the parameter.
member _.Method1([<ParamArray>] args: string[]) = ()
// Get the class type to access its metadata.
let clsType = typeof<TestClass>
// Get the MethodInfo object for Method1.
let mInfo = clsType.GetMethod "Method1"
// Get the ParameterInfo array for the method parameters.
let pInfo = mInfo.GetParameters()
if pInfo <> null then
// See if the ParamArray attribute is defined.
let isDef = Attribute.IsDefined(pInfo[0], typeof<ParamArrayAttribute>)
// Display the result.
printfn $"""The ParamArray attribute {if isDef then "is" else "is not"} defined for parameter {pInfo[0].Name} of method {mInfo.Name}."""
else
printfn $"The parameters information could not be retrieved for method {mInfo.Name}."
// Output:
// The ParamArray attribute is defined for parameter args of method Method1.
Imports System.Reflection
Module DemoModule
Public Class TestClass
' Assign a ParamArray attribute to the parameter using the keyword.
Public Sub Method1(ByVal ParamArray args As String())
End Sub
End Class
Sub Main()
' Get the class type to access its metadata.
Dim clsType As Type = GetType(TestClass)
' Get the MethodInfo object for Method1.
Dim mInfo As MethodInfo = clsType.GetMethod("Method1")
' Get the ParameterInfo array for the method parameters.
Dim pInfo() As ParameterInfo = mInfo.GetParameters()
If Not pInfo(0) Is Nothing Then
' See if the ParamArray attribute is defined.
Dim isDef As Boolean = Attribute.IsDefined(pInfo(0), _
GetType(ParamArrayAttribute))
Dim strDef As String
If isDef = True Then
strDef = "is"
Else
strDef = "is not"
End If
' Display the result.
Console.WriteLine("The ParamArray attribute {0} defined " & _
"for parameter {1} of method {2}.", _
strDef, pInfo(0).Name, mInfo.Name)
Else
Console.WriteLine("Could not retrieve parameter information " & _
"for method {0}.", mInfo.Name)
End If
End Sub
End Module
' Output:
' The ParamArray attribute is defined for parameter args of method Method1.
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
Определяет, применены ли какие-либо настраиваемые атрибуты к модулю. Параметры определяют модуль, тип настраиваемого атрибута для поиска и игнорированный параметр поиска.
public:
static bool IsDefined(System::Reflection::Module ^ element, Type ^ attributeType, bool inherit);public static bool IsDefined (System.Reflection.Module element, Type attributeType, bool inherit);static member IsDefined : System.Reflection.Module * Type * bool -> boolPublic Shared Function IsDefined (element As Module, attributeType As Type, inherit As Boolean) As BooleanПараметры
- element
- Module
Объект, являющийся производным от класса Module, который описывает переносимый исполняемый файл.
- attributeType
- Type
Тип или базовый тип искомого настраиваемого атрибута.
- inherit
- Boolean
Этот параметр игнорируется и не влияет на работу данного метода.
Возвращаемое значение
true, если настраиваемый атрибут типа attributeType применен к элементу, указанному в параметре element; в противном случае — false.
Исключения
Параметр element или attributeType имеет значение null.
Тип attributeType не является производным объекта Attribute.
Примеры
В следующем примере кода показано использование IsDefined, принимая в Module качестве параметра .
using namespace System;
using namespace System::Diagnostics;
// Add the Debuggable attribute to the module.
[module:Debuggable(true,false)];
namespace IsDef2CS
{
ref class DemoClass
{
public:
static void Main()
{
// Get the class type to access its metadata.
Type^ clsType = DemoClass::typeid;
// See if the Debuggable attribute is defined for this module.
bool isDef = Attribute::IsDefined( clsType->Module, DebuggableAttribute::typeid );
// Display the result.
Console::WriteLine( "The Debuggable attribute {0} "
"defined for Module {1}.", isDef ? (String^)"is" : "is not", clsType->Module->Name );
// If the attribute is defined, display the JIT settings.
if ( isDef )
{
// Retrieve the attribute itself.
DebuggableAttribute^ dbgAttr = dynamic_cast<DebuggableAttribute^>(Attribute::GetCustomAttribute( clsType->Module, DebuggableAttribute::typeid ));
if ( dbgAttr != nullptr )
{
Console::WriteLine( "JITTrackingEnabled is {0}.", dbgAttr->IsJITTrackingEnabled );
Console::WriteLine( "JITOptimizerDisabled is {0}.", dbgAttr->IsJITOptimizerDisabled );
}
else
Console::WriteLine( "The Debuggable attribute "
"could not be retrieved." );
}
}
};
}
/*
* Output:
* The Debuggable attribute is defined for Module IsDef2CS.exe.
* JITTrackingEnabled is True.
* JITOptimizerDisabled is False.
*/
using System;
using System.Diagnostics;
// Add the Debuggable attribute to the module.
[module:Debuggable(true, false)]
namespace IsDef2CS
{
public class DemoClass
{
static void Main(string[] args)
{
// Get the class type to access its metadata.
Type clsType = typeof(DemoClass);
// See if the Debuggable attribute is defined for this module.
bool isDef = Attribute.IsDefined(clsType.Module,
typeof(DebuggableAttribute));
// Display the result.
Console.WriteLine("The Debuggable attribute {0} " +
"defined for Module {1}.",
isDef ? "is" : "is not",
clsType.Module.Name);
// If the attribute is defined, display the JIT settings.
if (isDef)
{
// Retrieve the attribute itself.
DebuggableAttribute dbgAttr = (DebuggableAttribute)
Attribute.GetCustomAttribute(clsType.Module,
typeof(DebuggableAttribute));
if (dbgAttr != null)
{
Console.WriteLine("JITTrackingEnabled is {0}.",
dbgAttr.IsJITTrackingEnabled);
Console.WriteLine("JITOptimizerDisabled is {0}.",
dbgAttr.IsJITOptimizerDisabled);
}
else
Console.WriteLine("The Debuggable attribute " +
"could not be retrieved.");
}
}
}
}
/*
* Output:
* The Debuggable attribute is defined for Module IsDef2CS.exe.
* JITTrackingEnabled is True.
* JITOptimizerDisabled is False.
*/
open System
open System.Diagnostics
// Add the Debuggable attribute to the module.
[<``module``: Debuggable(true, false)>]
do ()
type DemoClass = class end
// Get the class type to access its metadata.
let clsType = typeof<DemoClass>
// See if the Debuggable attribute is defined for this module.
let isDef = Attribute.IsDefined(clsType.Module, typeof<DebuggableAttribute>)
// Display the result.
printfn $"""The Debuggable attribute {if isDef then "is" else "is not"} defined for Module {clsType.Module.Name}."""
// If the attribute is defined, display the JIT settings.
if isDef then
// Retrieve the attribute itself.
let dbgAttr =
Attribute.GetCustomAttribute(clsType.Module, typeof<DebuggableAttribute>)
:?> DebuggableAttribute
if dbgAttr <> null then
printfn $"JITTrackingEnabled is {dbgAttr.IsJITTrackingEnabled}."
printfn $"JITOptimizerDisabled is {dbgAttr.IsJITOptimizerDisabled}."
else
printfn "The Debuggable attribute could not be retrieved."
// Output:
// The Debuggable attribute is defined for Module IsDef2CS.exe.
// JITTrackingEnabled is True.
// JITOptimizerDisabled is False.
Imports System.Reflection
Imports System.Diagnostics
' Add the Debuggable attribute to the module.
<Module: Debuggable(True, False)>
Module DemoModule
Sub Main()
' Get the module type information to access its metadata.
Dim modType As Type = GetType(DemoModule)
' See if the Debuggable attribute is defined.
Dim isDef As Boolean = Attribute.IsDefined(modType.Module, _
GetType(DebuggableAttribute))
Dim strDef As String
If isDef = True Then
strDef = "is"
Else
strDef = "is not"
End If
' Display the result
Console.WriteLine("The debuggable attribute {0} defined for " & _
"module {1}.", strDef, modType.Name)
' If the attribute is defined, display the JIT settings.
If isDef = True Then
' Retrieve the attribute itself.
Dim attr As Attribute = _
Attribute.GetCustomAttribute(modType.Module, _
GetType(DebuggableAttribute))
If Not attr Is Nothing And TypeOf attr Is DebuggableAttribute Then
Dim dbgAttr As DebuggableAttribute = _
CType(attr, DebuggableAttribute)
Console.WriteLine("JITTrackingEnabled is {0}.", _
dbgAttr.IsJITTrackingEnabled.ToString())
Console.WriteLine("JITOptimizerDisabled is {0}.", _
dbgAttr.IsJITOptimizerDisabled.ToString())
Else
Console.WriteLine("The Debuggable attribute could " & _
"not be retrieved.")
End If
End If
End Sub
End Module
' Output:
' The debuggable attribute is defined for module DemoModule.
' JITTrackingEnabled is True.
' JITOptimizerDisabled is False.
Комментарии
Этот метод игнорирует inherit параметр и не выполняет поиск настраиваемых element атрибутов у предков .
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
Определяет, применены ли какие-либо настраиваемые атрибуты к члену типа. Параметры определяют член и тип настраиваемого атрибута для поиска и признак поиска родительского элемента члена.
public:
static bool IsDefined(System::Reflection::MemberInfo ^ element, Type ^ attributeType, bool inherit);public static bool IsDefined (System.Reflection.MemberInfo element, Type attributeType, bool inherit);static member IsDefined : System.Reflection.MemberInfo * Type * bool -> boolPublic Shared Function IsDefined (element As MemberInfo, attributeType As Type, inherit As Boolean) As BooleanПараметры
- element
- MemberInfo
Объект, производный от класса MemberInfo, описывающий член класса — конструктор, событие, поле, тип, метод или свойство.
- attributeType
- Type
Тип или базовый тип искомого настраиваемого атрибута.
- inherit
- Boolean
Если true, задает для настраиваемых атрибутов поиск родительских элементов для element.
Возвращаемое значение
true, если настраиваемый атрибут типа attributeType применен к элементу, указанному в параметре element; в противном случае — false.
Исключения
Параметр element или attributeType имеет значение null.
Тип attributeType не является производным объекта Attribute.
element не представляет конструктор, метод, свойство, событие, тип или поле.
Примеры
В следующем примере кода показано использование IsDefined, принимая в MemberInfo качестве параметра .
using namespace System;
using namespace System::Reflection;
namespace IsDef4CS
{
public ref class TestClass
{
public:
// Assign the Obsolete attribute to a method.
[Obsolete("This method is obsolete. Use Method2 instead.")]
void Method1(){}
void Method2(){}
};
ref class DemoClass
{
public:
static void Main()
{
// Get the class type to access its metadata.
Type^ clsType = TestClass::typeid;
// Get the MethodInfo object for Method1.
MethodInfo^ mInfo = clsType->GetMethod( "Method1" );
// See if the Obsolete attribute is defined for this method.
bool isDef = Attribute::IsDefined( mInfo, ObsoleteAttribute::typeid );
// Display the result.
Console::WriteLine( "The Obsolete Attribute {0} defined for {1} of class {2}.", isDef ? (String^)"is" : "is not", mInfo->Name, clsType->Name );
// If it's defined, display the attribute's message.
if ( isDef )
{
ObsoleteAttribute^ obsAttr = dynamic_cast<ObsoleteAttribute^>(Attribute::GetCustomAttribute( mInfo, ObsoleteAttribute::typeid ));
if ( obsAttr != nullptr )
Console::WriteLine( "The message is: \"{0}\".", obsAttr->Message );
else
Console::WriteLine( "The message could not be retrieved." );
}
}
};
}
/*
* Output:
* The Obsolete Attribute is defined for Method1 of class TestClass.
* The message is: "This method is obsolete. Use Method2 instead.".
*/
using System;
using System.Reflection;
namespace IsDef4CS
{
public class TestClass
{
// Assign the Obsolete attribute to a method.
[Obsolete("This method is obsolete. Use Method2 instead.")]
public void Method1()
{}
public void Method2()
{}
}
public class DemoClass
{
static void Main(string[] args)
{
// Get the class type to access its metadata.
Type clsType = typeof(TestClass);
// Get the MethodInfo object for Method1.
MethodInfo mInfo = clsType.GetMethod("Method1");
// See if the Obsolete attribute is defined for this method.
bool isDef = Attribute.IsDefined(mInfo, typeof(ObsoleteAttribute));
// Display the result.
Console.WriteLine("The Obsolete Attribute {0} defined for {1} of class {2}.",
isDef ? "is" : "is not", mInfo.Name, clsType.Name);
// If it's defined, display the attribute's message.
if (isDef)
{
ObsoleteAttribute obsAttr =
(ObsoleteAttribute)Attribute.GetCustomAttribute(
mInfo, typeof(ObsoleteAttribute));
if (obsAttr != null)
Console.WriteLine("The message is: \"{0}\".",
obsAttr.Message);
else
Console.WriteLine("The message could not be retrieved.");
}
}
}
}
/*
* Output:
* The Obsolete Attribute is defined for Method1 of class TestClass.
* The message is: "This method is obsolete. Use Method2 instead.".
*/
open System
type TestClass() =
// Assign the Obsolete attribute to a method.
[<Obsolete "This method is obsolete. Use Method2 instead.">]
member _.Method1() = ()
member _.Method2() = ()
// Get the class type to access its metadata.
let clsType = typeof<TestClass>
// Get the MethodInfo object for Method1.
let mInfo = clsType.GetMethod "Method1"
// See if the Obsolete attribute is defined for this method.
let isDef = Attribute.IsDefined(mInfo, typeof<ObsoleteAttribute>)
// Display the result.
printfn $"""The Obsolete Attribute {if isDef then "is" else "is not"} defined for {mInfo.Name} of class {clsType.Name}."""
// If it's defined, display the attribute's message.
if isDef then
let obsAttr =
Attribute.GetCustomAttribute(mInfo, typeof<ObsoleteAttribute>)
:?> ObsoleteAttribute
if obsAttr <> null then
printfn $"The message is: \"{obsAttr.Message}\"."
else
printfn "The message could not be retrieved."
// Output:
// The Obsolete Attribute is defined for Method1 of class TestClass.
// The message is: "This method is obsolete. Use Method2 instead.".
Imports System.Reflection
Module DemoModule
Public Class TestClass
' Assign the Obsolete attribute to a method.
<Obsolete("This method is obsolete. Use Method2() instead.")> _
Public Sub Method1()
End Sub
Public Sub Method2()
End Sub
End Class
Sub Main()
' Get the class type to access its metadata.
Dim clsType As Type = GetType(TestClass)
' Get the MethodInfo object for Method1.
Dim mInfo As MethodInfo = clsType.GetMethod("Method1")
' See if the Obsolete attribute is defined for this method.
Dim isDef As Boolean = Attribute.IsDefined(mInfo, _
GetType(ObsoleteAttribute))
Dim strDef As String
If isDef = True Then
strDef = "is"
Else
strDef = "is not"
End If
' Display the results.
Console.WriteLine("The Obsolete attribute {0} defined for " & _
"method {1} of class {2}.", strDef, mInfo.Name, clsType.Name)
' If it's defined, display the attribute's message.
If isDef = True Then
Dim attr As Attribute = Attribute.GetCustomAttribute(mInfo, _
GetType(ObsoleteAttribute))
If Not attr Is Nothing And TypeOf attr Is ObsoleteAttribute Then
Dim obsAttr As ObsoleteAttribute = _
CType(attr, ObsoleteAttribute)
Console.WriteLine("The message is: ""{0}""", obsAttr.Message)
Else
Console.WriteLine("The message could not be retrieved.")
End If
End If
End Sub
End Module
' Output:
' The Obsolete attribute is defined for method Method1 of class TestClass.
' The message is: "This method is obsolete. Use Method2() instead."
Комментарии
Примечание
Начиная с платформа .NET Framework версии 2.0 этот метод возвращает значение true , если тип, метод или конструктор имеют атрибуты безопасности, хранящиеся в новом формате метаданных. Сборки, скомпилированные с версией 2.0 или более поздней, используют новый формат. Динамические сборки и сборки, скомпилированные в более ранних версиях платформа .NET Framework использовать старый формат XML. См. раздел Создание декларативных атрибутов безопасности.
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
Определяет, применены ли какие-либо настраиваемые атрибуты к сборке. Параметры определяют сборку, тип настраиваемого атрибута для поиска и игнорированный параметр поиска.
public:
static bool IsDefined(System::Reflection::Assembly ^ element, Type ^ attributeType, bool inherit);public static bool IsDefined (System.Reflection.Assembly element, Type attributeType, bool inherit);static member IsDefined : System.Reflection.Assembly * Type * bool -> boolPublic Shared Function IsDefined (element As Assembly, attributeType As Type, inherit As Boolean) As BooleanПараметры
- element
- Assembly
Объект, производный от класса Assembly, который описывает многократно используемую коллекцию модулей.
- attributeType
- Type
Тип или базовый тип искомого настраиваемого атрибута.
- inherit
- Boolean
Этот параметр игнорируется и не влияет на работу данного метода.
Возвращаемое значение
true, если настраиваемый атрибут типа attributeType применен к элементу, указанному в параметре element; в противном случае — false.
Исключения
Параметр element или attributeType имеет значение null.
Тип attributeType не является производным объекта Attribute.
Примеры
В следующем примере кода показано использование IsDefined, принимая в Assembly качестве параметра .
using namespace System;
using namespace System::Reflection;
// Add an AssemblyDescription attribute
[assembly:AssemblyDescription("A sample description")];
namespace IsDef1CS
{
ref class DemoClass
{
public:
static void Main()
{
// Get the class type to access its metadata.
Type^ clsType = DemoClass::typeid;
// Get the assembly object.
Assembly^ assy = clsType->Assembly;
// Store the assembly's name.
String^ assyName = assy->GetName()->Name;
//Type assyType = assy.GetType();
// See if the Assembly Description is defined.
bool isdef = Attribute::IsDefined( assy, AssemblyDescriptionAttribute::typeid );
if ( isdef )
{
// Affirm that the attribute is defined.
Console::WriteLine( "The AssemblyDescription attribute "
"is defined for assembly {0}.", assyName );
// Get the description attribute itself.
AssemblyDescriptionAttribute^ adAttr = dynamic_cast<AssemblyDescriptionAttribute^>(Attribute::GetCustomAttribute( assy, AssemblyDescriptionAttribute::typeid ));
// Display the description.
if ( adAttr != nullptr )
Console::WriteLine( "The description is \"{0}\".", adAttr->Description );
else
Console::WriteLine( "The description could not "
"be retrieved." );
}
else
Console::WriteLine( "The AssemblyDescription attribute is not "
"defined for assembly {0}.", assyName );
}
};
}
/*
* Output:
* The AssemblyDescription attributeis defined for assembly IsDef1CS.
* The description is "A sample description".
*/
using System;
using System.Reflection;
// Add an AssemblyDescription attribute
[assembly: AssemblyDescription("A sample description")]
namespace IsDef1CS
{
public class DemoClass
{
static void Main(string[] args)
{
// Get the class type to access its metadata.
Type clsType = typeof(DemoClass);
// Get the assembly object.
Assembly assy = clsType.Assembly;
// Store the assembly's name.
String assyName = assy.GetName().Name;
// See if the Assembly Description is defined.
bool isdef = Attribute.IsDefined(assy,
typeof(AssemblyDescriptionAttribute));
if (isdef)
{
// Affirm that the attribute is defined.
Console.WriteLine("The AssemblyDescription attribute " +
"is defined for assembly {0}.", assyName);
// Get the description attribute itself.
AssemblyDescriptionAttribute adAttr =
(AssemblyDescriptionAttribute)Attribute.GetCustomAttribute(
assy, typeof(AssemblyDescriptionAttribute));
// Display the description.
if (adAttr != null)
Console.WriteLine("The description is \"{0}\".",
adAttr.Description);
else
Console.WriteLine("The description could not " +
"be retrieved.");
}
else
Console.WriteLine("The AssemblyDescription attribute is not " +
"defined for assembly {0}.", assyName);
}
}
}
/*
* Output:
* The AssemblyDescription attribute is defined for assembly IsDef1CS.
* The description is "A sample description".
*/
open System
open System.Reflection
// Add an AssemblyDescription attribute
[<assembly: AssemblyDescription "A sample description">]
do ()
type DemoClass = class end
// Get the class type to access its metadata.
let clsType = typeof<DemoClass>
// Get the assembly object.
let assembly = clsType.Assembly;
// Store the assembly's name.
let assemblyName = assembly.GetName().Name
// See if the Assembly Description is defined.
let isdef =
Attribute.IsDefined(assembly, typeof<AssemblyDescriptionAttribute>)
if isdef then
// Affirm that the attribute is defined.
printfn $"The AssemblyDescription attribute is defined for assembly {assemblyName}."
// Get the description attribute itself.
let adAttr =
Attribute.GetCustomAttribute(assembly, typeof<AssemblyDescriptionAttribute>)
:?> AssemblyDescriptionAttribute
// Display the description.
if adAttr <> null then
printfn $"The description is \"{adAttr.Description}\"."
else
printfn $"The description could not be retrieved."
else
printfn $"The AssemblyDescription attribute is not defined for assembly {assemblyName}."
// Output:
// The AssemblyDescription attribute is defined for assembly IsDef1FS.
// The description is "A sample description".
Imports System.Reflection
' Add an AssemblyDescription attribute.
<Assembly: AssemblyDescription("A sample description")>
Module DemoModule
Sub Main()
' Get the assembly for this module.
Dim assy As System.Reflection.Assembly = GetType(DemoModule).Assembly
' Store the assembly name.
Dim assyName As String = assy.GetName().Name
' See if the AssemblyDescription attribute is defined.
If Attribute.IsDefined(assy, GetType(AssemblyDescriptionAttribute)) _
Then
' Affirm that the attribute is defined. Assume the filename of
' this code example is "IsDef1VB".
Console.WriteLine("The AssemblyDescription attribute is " & _
"defined for assembly {0}.", assyName)
' Get the description attribute itself.
Dim attr As Attribute = Attribute.GetCustomAttribute( _
assy, GetType(AssemblyDescriptionAttribute))
' Display the description.
If Not attr Is Nothing And _
TypeOf attr Is AssemblyDescriptionAttribute Then
Dim adAttr As AssemblyDescriptionAttribute = _
CType(attr, AssemblyDescriptionAttribute)
Console.WriteLine("The description is " & _
Chr(34) & "{0}" & Chr(34) & ".", adAttr.Description)
Else
Console.WriteLine("The description could not be retrieved.")
End If
Else
Console.WriteLine("The AssemblyDescription attribute is not " & _
"defined for assembly {0}.", assyName)
End If
End Sub
End Module
' Output:
' The AssemblyDescription attribute is defined for assembly IsDef1VB.
' The description is "A sample description".
Комментарии
Примечание
Начиная с платформа .NET Framework версии 2.0, этот метод возвращает значение true , если сборка имеет атрибуты безопасности, хранящиеся в новом формате метаданных. Сборки, скомпилированные с версией 2.0 или более поздней, используют новый формат. Динамические сборки и сборки, скомпилированные в более ранних версиях платформа .NET Framework использовать старый формат XML. См. раздел Создание декларативных атрибутов безопасности.
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
Определяет, применены ли какие-либо настраиваемые атрибуты к члену типа. Параметры определяют член и тип настраиваемого атрибута для поиска.
public:
static bool IsDefined(System::Reflection::MemberInfo ^ element, Type ^ attributeType);public static bool IsDefined (System.Reflection.MemberInfo element, Type attributeType);static member IsDefined : System.Reflection.MemberInfo * Type -> boolPublic Shared Function IsDefined (element As MemberInfo, attributeType As Type) As BooleanПараметры
- element
- MemberInfo
Объект, производный от класса MemberInfo, описывающий член класса — конструктор, событие, поле, тип, метод или свойство.
- attributeType
- Type
Тип или базовый тип искомого настраиваемого атрибута.
Возвращаемое значение
true, если настраиваемый атрибут типа attributeType применен к элементу, указанному в параметре element; в противном случае — false.
Исключения
Параметр element или attributeType имеет значение null.
Тип attributeType не является производным объекта Attribute.
element не представляет конструктор, метод, свойство, событие, тип или поле.
Примеры
В следующем примере кода показано использование IsDefined, принимая в MemberInfo качестве параметра .
using namespace System;
using namespace System::Reflection;
namespace IsDef4CS
{
public ref class TestClass
{
public:
// Assign the Obsolete attribute to a method.
[Obsolete("This method is obsolete. Use Method2 instead.")]
void Method1(){}
void Method2(){}
};
ref class DemoClass
{
public:
static void Main()
{
// Get the class type to access its metadata.
Type^ clsType = TestClass::typeid;
// Get the MethodInfo object for Method1.
MethodInfo^ mInfo = clsType->GetMethod( "Method1" );
// See if the Obsolete attribute is defined for this method.
bool isDef = Attribute::IsDefined( mInfo, ObsoleteAttribute::typeid );
// Display the result.
Console::WriteLine( "The Obsolete Attribute {0} defined for {1} of class {2}.", isDef ? (String^)"is" : "is not", mInfo->Name, clsType->Name );
// If it's defined, display the attribute's message.
if ( isDef )
{
ObsoleteAttribute^ obsAttr = dynamic_cast<ObsoleteAttribute^>(Attribute::GetCustomAttribute( mInfo, ObsoleteAttribute::typeid ));
if ( obsAttr != nullptr )
Console::WriteLine( "The message is: \"{0}\".", obsAttr->Message );
else
Console::WriteLine( "The message could not be retrieved." );
}
}
};
}
/*
* Output:
* The Obsolete Attribute is defined for Method1 of class TestClass.
* The message is: "This method is obsolete. Use Method2 instead.".
*/
using System;
using System.Reflection;
namespace IsDef4CS
{
public class TestClass
{
// Assign the Obsolete attribute to a method.
[Obsolete("This method is obsolete. Use Method2 instead.")]
public void Method1()
{}
public void Method2()
{}
}
public class DemoClass
{
static void Main(string[] args)
{
// Get the class type to access its metadata.
Type clsType = typeof(TestClass);
// Get the MethodInfo object for Method1.
MethodInfo mInfo = clsType.GetMethod("Method1");
// See if the Obsolete attribute is defined for this method.
bool isDef = Attribute.IsDefined(mInfo, typeof(ObsoleteAttribute));
// Display the result.
Console.WriteLine("The Obsolete Attribute {0} defined for {1} of class {2}.",
isDef ? "is" : "is not", mInfo.Name, clsType.Name);
// If it's defined, display the attribute's message.
if (isDef)
{
ObsoleteAttribute obsAttr =
(ObsoleteAttribute)Attribute.GetCustomAttribute(
mInfo, typeof(ObsoleteAttribute));
if (obsAttr != null)
Console.WriteLine("The message is: \"{0}\".",
obsAttr.Message);
else
Console.WriteLine("The message could not be retrieved.");
}
}
}
}
/*
* Output:
* The Obsolete Attribute is defined for Method1 of class TestClass.
* The message is: "This method is obsolete. Use Method2 instead.".
*/
open System
type TestClass() =
// Assign the Obsolete attribute to a method.
[<Obsolete "This method is obsolete. Use Method2 instead.">]
member _.Method1() = ()
member _.Method2() = ()
// Get the class type to access its metadata.
let clsType = typeof<TestClass>
// Get the MethodInfo object for Method1.
let mInfo = clsType.GetMethod "Method1"
// See if the Obsolete attribute is defined for this method.
let isDef = Attribute.IsDefined(mInfo, typeof<ObsoleteAttribute>)
// Display the result.
printfn $"""The Obsolete Attribute {if isDef then "is" else "is not"} defined for {mInfo.Name} of class {clsType.Name}."""
// If it's defined, display the attribute's message.
if isDef then
let obsAttr =
Attribute.GetCustomAttribute(mInfo, typeof<ObsoleteAttribute>)
:?> ObsoleteAttribute
if obsAttr <> null then
printfn $"The message is: \"{obsAttr.Message}\"."
else
printfn "The message could not be retrieved."
// Output:
// The Obsolete Attribute is defined for Method1 of class TestClass.
// The message is: "This method is obsolete. Use Method2 instead.".
Imports System.Reflection
Module DemoModule
Public Class TestClass
' Assign the Obsolete attribute to a method.
<Obsolete("This method is obsolete. Use Method2() instead.")> _
Public Sub Method1()
End Sub
Public Sub Method2()
End Sub
End Class
Sub Main()
' Get the class type to access its metadata.
Dim clsType As Type = GetType(TestClass)
' Get the MethodInfo object for Method1.
Dim mInfo As MethodInfo = clsType.GetMethod("Method1")
' See if the Obsolete attribute is defined for this method.
Dim isDef As Boolean = Attribute.IsDefined(mInfo, _
GetType(ObsoleteAttribute))
Dim strDef As String
If isDef = True Then
strDef = "is"
Else
strDef = "is not"
End If
' Display the results.
Console.WriteLine("The Obsolete attribute {0} defined for " & _
"method {1} of class {2}.", strDef, mInfo.Name, clsType.Name)
' If it's defined, display the attribute's message.
If isDef = True Then
Dim attr As Attribute = Attribute.GetCustomAttribute(mInfo, _
GetType(ObsoleteAttribute))
If Not attr Is Nothing And TypeOf attr Is ObsoleteAttribute Then
Dim obsAttr As ObsoleteAttribute = _
CType(attr, ObsoleteAttribute)
Console.WriteLine("The message is: ""{0}""", obsAttr.Message)
Else
Console.WriteLine("The message could not be retrieved.")
End If
End If
End Sub
End Module
' Output:
' The Obsolete attribute is defined for method Method1 of class TestClass.
' The message is: "This method is obsolete. Use Method2() instead."
Комментарии
Для предков element выполняется поиск настраиваемых атрибутов.
Примечание
Начиная с платформа .NET Framework версии 2.0 этот метод возвращает значение true , если тип, метод или конструктор имеют атрибуты безопасности, хранящиеся в новом формате метаданных. Сборки, скомпилированные с версией 2.0 или более поздней, используют новый формат. Динамические сборки и сборки, скомпилированные в более ранних версиях платформа .NET Framework использовать старый формат XML. См. раздел Создание декларативных атрибутов безопасности.
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
Определяет применены ли какие-либо пользовательские атрибуты заданного типа к модулю. Параметры определяют модуль и тип настраиваемого атрибута для поиска.
public:
static bool IsDefined(System::Reflection::Module ^ element, Type ^ attributeType);public static bool IsDefined (System.Reflection.Module element, Type attributeType);static member IsDefined : System.Reflection.Module * Type -> boolPublic Shared Function IsDefined (element As Module, attributeType As Type) As BooleanПараметры
- element
- Module
Объект, являющийся производным от класса Module, который описывает переносимый исполняемый файл.
- attributeType
- Type
Тип или базовый тип искомого настраиваемого атрибута.
Возвращаемое значение
true, если настраиваемый атрибут типа attributeType применен к элементу, указанному в параметре element; в противном случае — false.
Исключения
Параметр element или attributeType имеет значение null.
Тип attributeType не является производным объекта Attribute.
Примеры
В следующем примере кода показано использование IsDefined, принимая в Module качестве параметра .
using namespace System;
using namespace System::Diagnostics;
// Add the Debuggable attribute to the module.
[module:Debuggable(true,false)];
namespace IsDef2CS
{
ref class DemoClass
{
public:
static void Main()
{
// Get the class type to access its metadata.
Type^ clsType = DemoClass::typeid;
// See if the Debuggable attribute is defined for this module.
bool isDef = Attribute::IsDefined( clsType->Module, DebuggableAttribute::typeid );
// Display the result.
Console::WriteLine( "The Debuggable attribute {0} "
"defined for Module {1}.", isDef ? (String^)"is" : "is not", clsType->Module->Name );
// If the attribute is defined, display the JIT settings.
if ( isDef )
{
// Retrieve the attribute itself.
DebuggableAttribute^ dbgAttr = dynamic_cast<DebuggableAttribute^>(Attribute::GetCustomAttribute( clsType->Module, DebuggableAttribute::typeid ));
if ( dbgAttr != nullptr )
{
Console::WriteLine( "JITTrackingEnabled is {0}.", dbgAttr->IsJITTrackingEnabled );
Console::WriteLine( "JITOptimizerDisabled is {0}.", dbgAttr->IsJITOptimizerDisabled );
}
else
Console::WriteLine( "The Debuggable attribute "
"could not be retrieved." );
}
}
};
}
/*
* Output:
* The Debuggable attribute is defined for Module IsDef2CS.exe.
* JITTrackingEnabled is True.
* JITOptimizerDisabled is False.
*/
using System;
using System.Diagnostics;
// Add the Debuggable attribute to the module.
[module:Debuggable(true, false)]
namespace IsDef2CS
{
public class DemoClass
{
static void Main(string[] args)
{
// Get the class type to access its metadata.
Type clsType = typeof(DemoClass);
// See if the Debuggable attribute is defined for this module.
bool isDef = Attribute.IsDefined(clsType.Module,
typeof(DebuggableAttribute));
// Display the result.
Console.WriteLine("The Debuggable attribute {0} " +
"defined for Module {1}.",
isDef ? "is" : "is not",
clsType.Module.Name);
// If the attribute is defined, display the JIT settings.
if (isDef)
{
// Retrieve the attribute itself.
DebuggableAttribute dbgAttr = (DebuggableAttribute)
Attribute.GetCustomAttribute(clsType.Module,
typeof(DebuggableAttribute));
if (dbgAttr != null)
{
Console.WriteLine("JITTrackingEnabled is {0}.",
dbgAttr.IsJITTrackingEnabled);
Console.WriteLine("JITOptimizerDisabled is {0}.",
dbgAttr.IsJITOptimizerDisabled);
}
else
Console.WriteLine("The Debuggable attribute " +
"could not be retrieved.");
}
}
}
}
/*
* Output:
* The Debuggable attribute is defined for Module IsDef2CS.exe.
* JITTrackingEnabled is True.
* JITOptimizerDisabled is False.
*/
open System
open System.Diagnostics
// Add the Debuggable attribute to the module.
[<``module``: Debuggable(true, false)>]
do ()
type DemoClass = class end
// Get the class type to access its metadata.
let clsType = typeof<DemoClass>
// See if the Debuggable attribute is defined for this module.
let isDef = Attribute.IsDefined(clsType.Module, typeof<DebuggableAttribute>)
// Display the result.
printfn $"""The Debuggable attribute {if isDef then "is" else "is not"} defined for Module {clsType.Module.Name}."""
// If the attribute is defined, display the JIT settings.
if isDef then
// Retrieve the attribute itself.
let dbgAttr =
Attribute.GetCustomAttribute(clsType.Module, typeof<DebuggableAttribute>)
:?> DebuggableAttribute
if dbgAttr <> null then
printfn $"JITTrackingEnabled is {dbgAttr.IsJITTrackingEnabled}."
printfn $"JITOptimizerDisabled is {dbgAttr.IsJITOptimizerDisabled}."
else
printfn "The Debuggable attribute could not be retrieved."
// Output:
// The Debuggable attribute is defined for Module IsDef2CS.exe.
// JITTrackingEnabled is True.
// JITOptimizerDisabled is False.
Imports System.Reflection
Imports System.Diagnostics
' Add the Debuggable attribute to the module.
<Module: Debuggable(True, False)>
Module DemoModule
Sub Main()
' Get the module type information to access its metadata.
Dim modType As Type = GetType(DemoModule)
' See if the Debuggable attribute is defined.
Dim isDef As Boolean = Attribute.IsDefined(modType.Module, _
GetType(DebuggableAttribute))
Dim strDef As String
If isDef = True Then
strDef = "is"
Else
strDef = "is not"
End If
' Display the result
Console.WriteLine("The debuggable attribute {0} defined for " & _
"module {1}.", strDef, modType.Name)
' If the attribute is defined, display the JIT settings.
If isDef = True Then
' Retrieve the attribute itself.
Dim attr As Attribute = _
Attribute.GetCustomAttribute(modType.Module, _
GetType(DebuggableAttribute))
If Not attr Is Nothing And TypeOf attr Is DebuggableAttribute Then
Dim dbgAttr As DebuggableAttribute = _
CType(attr, DebuggableAttribute)
Console.WriteLine("JITTrackingEnabled is {0}.", _
dbgAttr.IsJITTrackingEnabled.ToString())
Console.WriteLine("JITOptimizerDisabled is {0}.", _
dbgAttr.IsJITOptimizerDisabled.ToString())
Else
Console.WriteLine("The Debuggable attribute could " & _
"not be retrieved.")
End If
End If
End Sub
End Module
' Output:
' The debuggable attribute is defined for module DemoModule.
' JITTrackingEnabled is True.
' JITOptimizerDisabled is False.
Комментарии
Предки element не ищут пользовательские атрибуты.
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
Определяет, применены ли какие-либо настраиваемые атрибуты к сборке. Параметры определяют сборку и тип настраиваемого атрибута для поиска.
public:
static bool IsDefined(System::Reflection::Assembly ^ element, Type ^ attributeType);public static bool IsDefined (System.Reflection.Assembly element, Type attributeType);static member IsDefined : System.Reflection.Assembly * Type -> boolPublic Shared Function IsDefined (element As Assembly, attributeType As Type) As BooleanПараметры
- element
- Assembly
Объект, производный от класса Assembly, который описывает многократно используемую коллекцию модулей.
- attributeType
- Type
Тип или базовый тип искомого настраиваемого атрибута.
Возвращаемое значение
true, если настраиваемый атрибут типа attributeType применен к элементу, указанному в параметре element; в противном случае — false.
Исключения
Параметр element или attributeType имеет значение null.
Тип attributeType не является производным объекта Attribute.
Примеры
В следующем примере кода показано использование IsDefined, принимая в Assembly качестве параметра .
using namespace System;
using namespace System::Reflection;
// Add an AssemblyDescription attribute
[assembly:AssemblyDescription("A sample description")];
namespace IsDef1CS
{
ref class DemoClass
{
public:
static void Main()
{
// Get the class type to access its metadata.
Type^ clsType = DemoClass::typeid;
// Get the assembly object.
Assembly^ assy = clsType->Assembly;
// Store the assembly's name.
String^ assyName = assy->GetName()->Name;
//Type assyType = assy.GetType();
// See if the Assembly Description is defined.
bool isdef = Attribute::IsDefined( assy, AssemblyDescriptionAttribute::typeid );
if ( isdef )
{
// Affirm that the attribute is defined.
Console::WriteLine( "The AssemblyDescription attribute "
"is defined for assembly {0}.", assyName );
// Get the description attribute itself.
AssemblyDescriptionAttribute^ adAttr = dynamic_cast<AssemblyDescriptionAttribute^>(Attribute::GetCustomAttribute( assy, AssemblyDescriptionAttribute::typeid ));
// Display the description.
if ( adAttr != nullptr )
Console::WriteLine( "The description is \"{0}\".", adAttr->Description );
else
Console::WriteLine( "The description could not "
"be retrieved." );
}
else
Console::WriteLine( "The AssemblyDescription attribute is not "
"defined for assembly {0}.", assyName );
}
};
}
/*
* Output:
* The AssemblyDescription attributeis defined for assembly IsDef1CS.
* The description is "A sample description".
*/
using System;
using System.Reflection;
// Add an AssemblyDescription attribute
[assembly: AssemblyDescription("A sample description")]
namespace IsDef1CS
{
public class DemoClass
{
static void Main(string[] args)
{
// Get the class type to access its metadata.
Type clsType = typeof(DemoClass);
// Get the assembly object.
Assembly assy = clsType.Assembly;
// Store the assembly's name.
String assyName = assy.GetName().Name;
// See if the Assembly Description is defined.
bool isdef = Attribute.IsDefined(assy,
typeof(AssemblyDescriptionAttribute));
if (isdef)
{
// Affirm that the attribute is defined.
Console.WriteLine("The AssemblyDescription attribute " +
"is defined for assembly {0}.", assyName);
// Get the description attribute itself.
AssemblyDescriptionAttribute adAttr =
(AssemblyDescriptionAttribute)Attribute.GetCustomAttribute(
assy, typeof(AssemblyDescriptionAttribute));
// Display the description.
if (adAttr != null)
Console.WriteLine("The description is \"{0}\".",
adAttr.Description);
else
Console.WriteLine("The description could not " +
"be retrieved.");
}
else
Console.WriteLine("The AssemblyDescription attribute is not " +
"defined for assembly {0}.", assyName);
}
}
}
/*
* Output:
* The AssemblyDescription attribute is defined for assembly IsDef1CS.
* The description is "A sample description".
*/
open System
open System.Reflection
// Add an AssemblyDescription attribute
[<assembly: AssemblyDescription "A sample description">]
do ()
type DemoClass = class end
// Get the class type to access its metadata.
let clsType = typeof<DemoClass>
// Get the assembly object.
let assembly = clsType.Assembly;
// Store the assembly's name.
let assemblyName = assembly.GetName().Name
// See if the Assembly Description is defined.
let isdef =
Attribute.IsDefined(assembly, typeof<AssemblyDescriptionAttribute>)
if isdef then
// Affirm that the attribute is defined.
printfn $"The AssemblyDescription attribute is defined for assembly {assemblyName}."
// Get the description attribute itself.
let adAttr =
Attribute.GetCustomAttribute(assembly, typeof<AssemblyDescriptionAttribute>)
:?> AssemblyDescriptionAttribute
// Display the description.
if adAttr <> null then
printfn $"The description is \"{adAttr.Description}\"."
else
printfn $"The description could not be retrieved."
else
printfn $"The AssemblyDescription attribute is not defined for assembly {assemblyName}."
// Output:
// The AssemblyDescription attribute is defined for assembly IsDef1FS.
// The description is "A sample description".
Imports System.Reflection
' Add an AssemblyDescription attribute.
<Assembly: AssemblyDescription("A sample description")>
Module DemoModule
Sub Main()
' Get the assembly for this module.
Dim assy As System.Reflection.Assembly = GetType(DemoModule).Assembly
' Store the assembly name.
Dim assyName As String = assy.GetName().Name
' See if the AssemblyDescription attribute is defined.
If Attribute.IsDefined(assy, GetType(AssemblyDescriptionAttribute)) _
Then
' Affirm that the attribute is defined. Assume the filename of
' this code example is "IsDef1VB".
Console.WriteLine("The AssemblyDescription attribute is " & _
"defined for assembly {0}.", assyName)
' Get the description attribute itself.
Dim attr As Attribute = Attribute.GetCustomAttribute( _
assy, GetType(AssemblyDescriptionAttribute))
' Display the description.
If Not attr Is Nothing And _
TypeOf attr Is AssemblyDescriptionAttribute Then
Dim adAttr As AssemblyDescriptionAttribute = _
CType(attr, AssemblyDescriptionAttribute)
Console.WriteLine("The description is " & _
Chr(34) & "{0}" & Chr(34) & ".", adAttr.Description)
Else
Console.WriteLine("The description could not be retrieved.")
End If
Else
Console.WriteLine("The AssemblyDescription attribute is not " & _
"defined for assembly {0}.", assyName)
End If
End Sub
End Module
' Output:
' The AssemblyDescription attribute is defined for assembly IsDef1VB.
' The description is "A sample description".
Комментарии
Примечание
Начиная с платформа .NET Framework версии 2.0 этот метод возвращает значение true , если у сборки есть атрибуты безопасности, хранящиеся в новом формате метаданных. Сборки, скомпилированные с версией 2.0 или более поздней, используют новый формат. Динамические сборки и сборки, скомпилированные с использованием более ранних версий платформа .NET Framework использовать старый формат XML. См. статью Создание декларативных атрибутов безопасности.
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
- Исходный код:
- Attribute.CoreCLR.cs
Определяет, применены ли какие-либо настраиваемые атрибуты к параметру метода. Параметры определяют параметр метода и тип настраиваемого атрибута для поиска.
public:
static bool IsDefined(System::Reflection::ParameterInfo ^ element, Type ^ attributeType);public static bool IsDefined (System.Reflection.ParameterInfo element, Type attributeType);static member IsDefined : System.Reflection.ParameterInfo * Type -> boolPublic Shared Function IsDefined (element As ParameterInfo, attributeType As Type) As BooleanПараметры
- element
- ParameterInfo
Объект, являющийся производным от класса ParameterInfo, который описывает параметр члена класса.
- attributeType
- Type
Тип или базовый тип искомого настраиваемого атрибута.
Возвращаемое значение
true, если настраиваемый атрибут типа attributeType применен к элементу, указанному в параметре element; в противном случае — false.
Исключения
Параметр element или attributeType имеет значение null.
Тип attributeType не является производным объекта Attribute.
Примеры
В следующем примере кода показано использование IsDefined, принимая в ParameterInfo качестве параметра .
using namespace System;
using namespace System::Reflection;
namespace IsDef5CS
{
public ref class TestClass
{
public:
// Assign a ParamArray attribute to the parameter using the keyword.
void Method1(... array<String^>^args ){}
};
ref class DemoClass
{
public:
static void Main()
{
// Get the class type to access its metadata.
Type^ clsType = TestClass::typeid;
// Get the MethodInfo object for Method1.
MethodInfo^ mInfo = clsType->GetMethod( "Method1" );
// Get the ParameterInfo array for the method parameters.
array<ParameterInfo^>^pInfo = mInfo->GetParameters();
if ( pInfo != nullptr )
{
// See if the ParamArray attribute is defined.
bool isDef = Attribute::IsDefined( pInfo[ 0 ], ParamArrayAttribute::typeid );
// Display the result.
Console::WriteLine( "The ParamArray attribute {0} defined for "
"parameter {1} of method {2}.", isDef ? (String^)"is" : "is not", pInfo[ 0 ]->Name, mInfo->Name );
}
else
Console::WriteLine( "The parameters information could "
"not be retrieved for method {0}.", mInfo->Name );
}
};
}
/*
* Output:
* The ParamArray attribute is defined for parameter args of method Method1.
*/
using System;
using System.Reflection;
namespace IsDef5CS
{
public class TestClass
{
// Assign a ParamArray attribute to the parameter using the keyword.
public void Method1(params String[] args)
{}
}
public class DemoClass
{
static void Main(string[] args)
{
// Get the class type to access its metadata.
Type clsType = typeof(TestClass);
// Get the MethodInfo object for Method1.
MethodInfo mInfo = clsType.GetMethod("Method1");
// Get the ParameterInfo array for the method parameters.
ParameterInfo[] pInfo = mInfo.GetParameters();
if (pInfo != null)
{
// See if the ParamArray attribute is defined.
bool isDef = Attribute.IsDefined(pInfo[0],
typeof(ParamArrayAttribute));
// Display the result.
Console.WriteLine("The ParamArray attribute {0} defined for " +
"parameter {1} of method {2}.",
isDef ? "is" : "is not",
pInfo[0].Name,
mInfo.Name);
}
else
Console.WriteLine("The parameters information could " +
"not be retrieved for method {0}.", mInfo.Name);
}
}
}
/*
* Output:
* The ParamArray attribute is defined for parameter args of method Method1.
*/
open System;
type TestClass() =
// Assign a ParamArray attribute to the parameter.
member _.Method1([<ParamArray>] args: string[]) = ()
// Get the class type to access its metadata.
let clsType = typeof<TestClass>
// Get the MethodInfo object for Method1.
let mInfo = clsType.GetMethod "Method1"
// Get the ParameterInfo array for the method parameters.
let pInfo = mInfo.GetParameters()
if pInfo <> null then
// See if the ParamArray attribute is defined.
let isDef = Attribute.IsDefined(pInfo[0], typeof<ParamArrayAttribute>)
// Display the result.
printfn $"""The ParamArray attribute {if isDef then "is" else "is not"} defined for parameter {pInfo[0].Name} of method {mInfo.Name}."""
else
printfn $"The parameters information could not be retrieved for method {mInfo.Name}."
// Output:
// The ParamArray attribute is defined for parameter args of method Method1.
Imports System.Reflection
Module DemoModule
Public Class TestClass
' Assign a ParamArray attribute to the parameter using the keyword.
Public Sub Method1(ByVal ParamArray args As String())
End Sub
End Class
Sub Main()
' Get the class type to access its metadata.
Dim clsType As Type = GetType(TestClass)
' Get the MethodInfo object for Method1.
Dim mInfo As MethodInfo = clsType.GetMethod("Method1")
' Get the ParameterInfo array for the method parameters.
Dim pInfo() As ParameterInfo = mInfo.GetParameters()
If Not pInfo(0) Is Nothing Then
' See if the ParamArray attribute is defined.
Dim isDef As Boolean = Attribute.IsDefined(pInfo(0), _
GetType(ParamArrayAttribute))
Dim strDef As String
If isDef = True Then
strDef = "is"
Else
strDef = "is not"
End If
' Display the result.
Console.WriteLine("The ParamArray attribute {0} defined " & _
"for parameter {1} of method {2}.", _
strDef, pInfo(0).Name, mInfo.Name)
Else
Console.WriteLine("Could not retrieve parameter information " & _
"for method {0}.", mInfo.Name)
End If
End Sub
End Module
' Output:
' The ParamArray attribute is defined for parameter args of method Method1.
Комментарии
Предки выполняют поиск настраиваемых element атрибутов.
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 2.0, 2.1 |
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: