CustomAttributeExtensions.GetCustomAttributes Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Retrieves a collection of custom attributes that are applied to a specified element.
Overloads
GetCustomAttributes(ParameterInfo, Type, Boolean) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter, and optionally inspects the ancestors of that parameter. |
GetCustomAttributes(MemberInfo, Type, Boolean) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member. |
GetCustomAttributes(ParameterInfo, Type) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter. |
GetCustomAttributes(ParameterInfo, Boolean) |
Retrieves a collection of custom attributes that are applied to a specified parameter, and optionally inspects the ancestors of that parameter. |
GetCustomAttributes(Module, Type) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified module. |
GetCustomAttributes(MemberInfo, Type) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified member. |
GetCustomAttributes(MemberInfo, Boolean) |
Retrieves a collection of custom attributes that are applied to a specified member, and optionally inspects the ancestors of that member. |
GetCustomAttributes(Assembly, Type) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified assembly. |
GetCustomAttributes(ParameterInfo) |
Retrieves a collection of custom attributes that are applied to a specified parameter. |
GetCustomAttributes(Module) |
Retrieves a collection of custom attributes that are applied to a specified module. |
GetCustomAttributes(MemberInfo) |
Retrieves a collection of custom attributes that are applied to a specified member. |
GetCustomAttributes(Assembly) |
Retrieves a collection of custom attributes that are applied to a specified assembly. |
GetCustomAttributes<T>(ParameterInfo, Boolean) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter, and optionally inspects the ancestors of that parameter. |
GetCustomAttributes<T>(MemberInfo, Boolean) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member. |
GetCustomAttributes<T>(ParameterInfo) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter. |
GetCustomAttributes<T>(MemberInfo) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified member. |
GetCustomAttributes<T>(Assembly) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified assembly. |
GetCustomAttributes<T>(Module) |
Retrieves a collection of custom attributes of a specified type that are applied to a specified module. |
GetCustomAttributes(ParameterInfo, Type, Boolean)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter, and optionally inspects the ancestors of that parameter.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::ParameterInfo ^ element, Type ^ attributeType, bool inherit);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.ParameterInfo element, Type attributeType, bool inherit);
static member GetCustomAttributes : System.Reflection.ParameterInfo * Type * bool -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As ParameterInfo, attributeType As Type, inherit As Boolean) As IEnumerable(Of Attribute)
Parameters
- element
- ParameterInfo
The parameter to inspect.
- attributeType
- Type
The type of attribute to search for.
- inherit
- Boolean
true
to inspect the ancestors of element
; otherwise, false
.
Returns
A collection of the custom attributes that are applied to element
and that match attributeType
, or an empty collection if no such attributes exist.
Exceptions
element
or attributeType
is null
.
attributeType
is not derived from Attribute.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes(MemberInfo, Type, Boolean)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::MemberInfo ^ element, Type ^ attributeType, bool inherit);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.MemberInfo element, Type attributeType, bool inherit);
static member GetCustomAttributes : System.Reflection.MemberInfo * Type * bool -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As MemberInfo, attributeType As Type, inherit As Boolean) As IEnumerable(Of Attribute)
Parameters
- element
- MemberInfo
The member to inspect.
- attributeType
- Type
The type of attribute to search for.
- inherit
- Boolean
true
to inspect the ancestors of element
; otherwise, false
.
Returns
A collection of the custom attributes that are applied to element
and that match attributeType
, or an empty collection if no such attributes exist.
Exceptions
element
or attributeType
is null
.
attributeType
is not derived from Attribute.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes(ParameterInfo, Type)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::ParameterInfo ^ element, Type ^ attributeType);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.ParameterInfo element, Type attributeType);
static member GetCustomAttributes : System.Reflection.ParameterInfo * Type -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As ParameterInfo, attributeType As Type) As IEnumerable(Of Attribute)
Parameters
- element
- ParameterInfo
The parameter to inspect.
- attributeType
- Type
The type of attribute to search for.
Returns
A collection of the custom attributes that are applied to element
and that match attributeType
, or an empty collection if no such attributes exist.
Exceptions
element
or attributeType
is null
.
attributeType
is not derived from Attribute.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes(ParameterInfo, Boolean)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes that are applied to a specified parameter, and optionally inspects the ancestors of that parameter.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::ParameterInfo ^ element, bool inherit);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.ParameterInfo element, bool inherit);
static member GetCustomAttributes : System.Reflection.ParameterInfo * bool -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As ParameterInfo, inherit As Boolean) As IEnumerable(Of Attribute)
Parameters
- element
- ParameterInfo
The parameter to inspect.
- inherit
- Boolean
true
to inspect the ancestors of element
; otherwise, false
.
Returns
A collection of the custom attributes that are applied to element
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes(Module, Type)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified module.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::Module ^ element, Type ^ attributeType);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.Module element, Type attributeType);
static member GetCustomAttributes : System.Reflection.Module * Type -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As Module, attributeType As Type) As IEnumerable(Of Attribute)
Parameters
- element
- Module
The module to inspect.
- attributeType
- Type
The type of attribute to search for.
Returns
A collection of the custom attributes that are applied to element
and that match attributeType
, or an empty collection if no such attributes exist.
Exceptions
element
or attributeType
is null
.
attributeType
is not derived from Attribute.
Applies to
GetCustomAttributes(MemberInfo, Type)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified member.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::MemberInfo ^ element, Type ^ attributeType);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.MemberInfo element, Type attributeType);
static member GetCustomAttributes : System.Reflection.MemberInfo * Type -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As MemberInfo, attributeType As Type) As IEnumerable(Of Attribute)
Parameters
- element
- MemberInfo
The member to inspect.
- attributeType
- Type
The type of attribute to search for.
Returns
A collection of the custom attributes that are applied to element
and that match attributeType
, or an empty collection if no such attributes exist.
Exceptions
element
or attributeType
is null
.
attributeType
is not derived from Attribute.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes(MemberInfo, Boolean)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes that are applied to a specified member, and optionally inspects the ancestors of that member.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::MemberInfo ^ element, bool inherit);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.MemberInfo element, bool inherit);
static member GetCustomAttributes : System.Reflection.MemberInfo * bool -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As MemberInfo, inherit As Boolean) As IEnumerable(Of Attribute)
Parameters
- element
- MemberInfo
The member to inspect.
- inherit
- Boolean
true
to inspect the ancestors of element
; otherwise, false
.
Returns
A collection of the custom attributes that are applied to element
that match the specified criteria, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes(Assembly, Type)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified assembly.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::Assembly ^ element, Type ^ attributeType);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.Assembly element, Type attributeType);
static member GetCustomAttributes : System.Reflection.Assembly * Type -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As Assembly, attributeType As Type) As IEnumerable(Of Attribute)
Parameters
- element
- Assembly
The assembly to inspect.
- attributeType
- Type
The type of attribute to search for.
Returns
A collection of the custom attributes that are applied to element
and that match attributeType
, or an empty collection if no such attributes exist.
Exceptions
element
or attributeType
is null
.
attributeType
is not derived from Attribute.
Applies to
GetCustomAttributes(ParameterInfo)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes that are applied to a specified parameter.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::ParameterInfo ^ element);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.ParameterInfo element);
static member GetCustomAttributes : System.Reflection.ParameterInfo -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As ParameterInfo) As IEnumerable(Of Attribute)
Parameters
- element
- ParameterInfo
The parameter to inspect.
Returns
A collection of the custom attributes that are applied to element
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes(Module)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes that are applied to a specified module.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::Module ^ element);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.Module element);
static member GetCustomAttributes : System.Reflection.Module -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As Module) As IEnumerable(Of Attribute)
Parameters
- element
- Module
The module to inspect.
Returns
A collection of the custom attributes that are applied to element
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
Applies to
GetCustomAttributes(MemberInfo)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes that are applied to a specified member.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::MemberInfo ^ element);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.MemberInfo element);
static member GetCustomAttributes : System.Reflection.MemberInfo -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As MemberInfo) As IEnumerable(Of Attribute)
Parameters
- element
- MemberInfo
The member to inspect.
Returns
A collection of the custom attributes that are applied to element
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes(Assembly)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes that are applied to a specified assembly.
public:
[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<Attribute ^> ^ GetCustomAttributes(System::Reflection::Assembly ^ element);
public static System.Collections.Generic.IEnumerable<Attribute> GetCustomAttributes (this System.Reflection.Assembly element);
static member GetCustomAttributes : System.Reflection.Assembly -> seq<Attribute>
<Extension()>
Public Function GetCustomAttributes (element As Assembly) As IEnumerable(Of Attribute)
Parameters
- element
- Assembly
The assembly to inspect.
Returns
A collection of the custom attributes that are applied to element
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
Applies to
GetCustomAttributes<T>(ParameterInfo, Boolean)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter, and optionally inspects the ancestors of that parameter.
public:
generic <typename T>
where T : Attribute[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<T> ^ GetCustomAttributes(System::Reflection::ParameterInfo ^ element, bool inherit);
public static System.Collections.Generic.IEnumerable<T> GetCustomAttributes<T> (this System.Reflection.ParameterInfo element, bool inherit) where T : Attribute;
static member GetCustomAttributes : System.Reflection.ParameterInfo * bool -> seq<'T (requires 'T :> Attribute)> (requires 'T :> Attribute)
<Extension()>
Public Function GetCustomAttributes(Of T As Attribute) (element As ParameterInfo, inherit As Boolean) As IEnumerable(Of T)
Type Parameters
- T
The type of attribute to search for.
Parameters
- element
- ParameterInfo
The parameter to inspect.
- inherit
- Boolean
true
to inspect the ancestors of element
; otherwise, false
.
Returns
A collection of the custom attributes that are applied to element
and that match T
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes<T>(MemberInfo, Boolean)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified member, and optionally inspects the ancestors of that member.
public:
generic <typename T>
where T : Attribute[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<T> ^ GetCustomAttributes(System::Reflection::MemberInfo ^ element, bool inherit);
public static System.Collections.Generic.IEnumerable<T> GetCustomAttributes<T> (this System.Reflection.MemberInfo element, bool inherit) where T : Attribute;
static member GetCustomAttributes : System.Reflection.MemberInfo * bool -> seq<'T (requires 'T :> Attribute)> (requires 'T :> Attribute)
<Extension()>
Public Function GetCustomAttributes(Of T As Attribute) (element As MemberInfo, inherit As Boolean) As IEnumerable(Of T)
Type Parameters
- T
The type of attribute to search for.
Parameters
- element
- MemberInfo
The member to inspect.
- inherit
- Boolean
true
to inspect the ancestors of element
; otherwise, false
.
Returns
A collection of the custom attributes that are applied to element
and that match T
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes<T>(ParameterInfo)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified parameter.
public:
generic <typename T>
where T : Attribute[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<T> ^ GetCustomAttributes(System::Reflection::ParameterInfo ^ element);
public static System.Collections.Generic.IEnumerable<T> GetCustomAttributes<T> (this System.Reflection.ParameterInfo element) where T : Attribute;
static member GetCustomAttributes : System.Reflection.ParameterInfo -> seq<'T (requires 'T :> Attribute)> (requires 'T :> Attribute)
<Extension()>
Public Function GetCustomAttributes(Of T As Attribute) (element As ParameterInfo) As IEnumerable(Of T)
Type Parameters
- T
The type of attribute to search for.
Parameters
- element
- ParameterInfo
The parameter to inspect.
Returns
A collection of the custom attributes that are applied to element
and that match T
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes<T>(MemberInfo)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified member.
public:
generic <typename T>
where T : Attribute[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<T> ^ GetCustomAttributes(System::Reflection::MemberInfo ^ element);
public static System.Collections.Generic.IEnumerable<T> GetCustomAttributes<T> (this System.Reflection.MemberInfo element) where T : Attribute;
static member GetCustomAttributes : System.Reflection.MemberInfo -> seq<'T (requires 'T :> Attribute)> (requires 'T :> Attribute)
<Extension()>
Public Function GetCustomAttributes(Of T As Attribute) (element As MemberInfo) As IEnumerable(Of T)
Type Parameters
- T
The type of attribute to search for.
Parameters
- element
- MemberInfo
The member to inspect.
Returns
A collection of the custom attributes that are applied to element
and that match T
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
element
is not a constructor, method, property, event, type, or field.
A custom attribute type cannot be loaded.
Applies to
GetCustomAttributes<T>(Assembly)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified assembly.
public:
generic <typename T>
where T : Attribute[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<T> ^ GetCustomAttributes(System::Reflection::Assembly ^ element);
public static System.Collections.Generic.IEnumerable<T> GetCustomAttributes<T> (this System.Reflection.Assembly element) where T : Attribute;
static member GetCustomAttributes : System.Reflection.Assembly -> seq<'T (requires 'T :> Attribute)> (requires 'T :> Attribute)
<Extension()>
Public Function GetCustomAttributes(Of T As Attribute) (element As Assembly) As IEnumerable(Of T)
Type Parameters
- T
The type of attribute to search for.
Parameters
- element
- Assembly
The assembly to inspect.
Returns
A collection of the custom attributes that are applied to element
and that match T
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.
Applies to
GetCustomAttributes<T>(Module)
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
- Source:
- CustomAttributeExtensions.cs
Retrieves a collection of custom attributes of a specified type that are applied to a specified module.
public:
generic <typename T>
where T : Attribute[System::Runtime::CompilerServices::Extension]
static System::Collections::Generic::IEnumerable<T> ^ GetCustomAttributes(System::Reflection::Module ^ element);
public static System.Collections.Generic.IEnumerable<T> GetCustomAttributes<T> (this System.Reflection.Module element) where T : Attribute;
static member GetCustomAttributes : System.Reflection.Module -> seq<'T (requires 'T :> Attribute)> (requires 'T :> Attribute)
<Extension()>
Public Function GetCustomAttributes(Of T As Attribute) (element As Module) As IEnumerable(Of T)
Type Parameters
- T
The type of attribute to search for.
Parameters
- element
- Module
The module to inspect.
Returns
A collection of the custom attributes that are applied to element
and that match T
, or an empty collection if no such attributes exist.
Exceptions
element
is null
.