Creates new instances of Converter<TIn, TOut> or Converter<TIn, TOut, TArg> dependent on the number of parameters defined in methodInfo and whether a delegate was passed. More...

Collaboration diagram for Core.TypeCast.Base.ConverterFactoryRT< TConverter >:

Public Member Functions
override Converter	Create (MethodInfo method)

override Converter	Create (MethodInfo methodInfo, object converterDelegate=null)
	Creates a strictly typed Converter<TIn, TOut, TArg> container in case of any attribute-assigned method or a passed MethodInfo with a parameter argument count of two. Otherwise a strictly typed Converter<TIn, TOut> container instance is created and returned. More...

IEnumerable< Type >	GetInterfaces ()
	Returns an IEnumerable<Type> of the interfaces supported by the factory instance. More...

IEnumerable< Type >	GetParameters ()
	Returns an IEnumerable<Type> of the generic parameters that constructed the base-factory instance. More...

abstract TInstance	Create (TIn1 parameter)
	Abstract method for creating instances of TInstance defined only through parameter More...

abstract TInstance	Create (TIn1 parameter, TIn2 parameter2=default(TIn2))
	Abstract method for creating instances of TInstance defined only through parameter and parameter2 More...

override string	ToString ()
	Returns a string representation of the Factory type. More...

Static Protected Member Functions
static object	Instantiate (Type type, params object[] parameters)
	Internal method for object instantiation by a passed type type More...

static bool	TryInstantiate (Type type, out object instance, params object[] parameters)
	Internal method for object instantiation following the "Try" convention of returning a bool `true` upon success and passing the result with `out` More...

static TOut	Instantiate< TOut > (Type type, Type[] parameters, params object[] args)
	Internal method object instantiation of a generic type , with the generic-parameters passed as the second argument More...

static TOut	Instantiate< TOut > (Type type, object[] args=null)
	Creates an instance of the type designated by the specified generic type parameter More...

Properties
string	Name `[get]`
	Gets a string representation of the Base-Factory using ToString() More...

Detailed Description

Creates new instances of Converter<TIn, TOut> or Converter<TIn, TOut, TArg> dependent on the number of parameters defined in methodInfo and whether a delegate was passed.

Template Parameters

TConverter The generic type of the Converter class to instance

Type Constraints

TConverter

:

class

Definition at line 22 of file ConverterFactoryRT.cs.

Member Function Documentation

override Converter Core.TypeCast.Base.ConverterFactoryRT< TConverter >.Create ( MethodInfo method )

Definition at line 24 of file ConverterFactoryRT.cs.

         {
             return this.Create(method, null);
         }

override Converter Core.TypeCast.Base.ConverterFactoryRT< TConverter >.Create	(	MethodInfo	methodInfo,
		object	converterDelegate = `null`
	)

Creates a strictly typed Converter<TIn, TOut, TArg> container in case of any attribute-assigned method or a passed MethodInfo with a parameter argument count of two. Otherwise a strictly typed Converter<TIn, TOut> container instance is created and returned.

Parameters

methodInfo	A methodInfo for a converter method, crucially confining the number of function parameters between one and two. Otherwise an ConverterException is raised.
converterDelegate	An optional delegate of the converter method.

Returns: A new instance of a Converter with a parent of either Converter<TIn, TOut, TArg> or Converter<TIn, TOut>.

Exceptions

ConverterException If the number or types of the parameters mismatch an exception is raised.

Definition at line 39 of file ConverterFactoryRT.cs.

         {
             if(methodInfo == null && converterDelegate == null)
             {
                 throw new ConverterException(ConverterCause.ConverterArgumentNull);
             }
 
             var parameterInfos = methodInfo.GetParameters();
 
             if(parameterInfos.Length == 0)
             {
                 throw new ConverterException(ConverterCause.ConverterArgumentDelegateNoParameters);
             }
 
             bool isInstanceMethod = converterDelegate == null;
 
             var parameterTypes = new ConverterParameters(methodInfo.ReturnParameter, parameterInfos);
 
             Converter converter;
 
             var methodAttribute = methodInfo.GetCustomAttribute<ConverterMethodAttribute>();
 
             // create either a Converter_T2 or Converter_T3 container
             if(parameterInfos.Length == 2 || isInstanceMethod == true)
             {
                 converter = Instantiate<Converter>(typeof(Converter<,,>), parameters: parameterTypes.ToArray(), args: new[] { converterDelegate ?? methodInfo, parameterTypes.Arg });
 
                 converter.FunctionDefaultAttribute = methodAttribute;
                 converter.FunctionAttribute = methodAttribute;
             }
             else if(parameterInfos.Length == 1)
             {
                 converter = Instantiate<Converter>(typeof(Converter<,>), parameters: new[] { parameterTypes.In, parameterTypes.Out }, args: converterDelegate);
                 converter.FunctionAttribute = methodAttribute;
             }
             else
             {
                 throw new ConverterException(ConverterCause.ConverterArgumentDelegateTooManyParameters);
             }
 
             converter.MergeFromMethodAttribute(methodInfo);
 
             return converter;
         }

abstract TInstance Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.Create ( TIn1 parameter )

pure virtualinherited

Abstract method for creating instances of TInstance defined only through parameter

Parameters

parameter The parameter to define the instance creation process

Returns: an instance of Type TInstance

abstract TInstance Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.Create	(	TIn1	parameter,
		TIn2	parameter2 = `default(TIn2)`
	)

pure virtualinherited

Abstract method for creating instances of TInstance defined only through parameter and parameter2

Parameters

parameter	The parameter to define the instance creation process
parameter2	The 2. parameter to define the instance creation process

Returns: an instance of Type TInstance

IEnumerable<Type> Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.GetInterfaces ( )

inherited

Returns an IEnumerable<Type> of the interfaces supported by the factory instance.

Definition at line 46 of file Factory.cs.

         {
             var type = this.GetType();
             yield return type;
 
             foreach(var interfaceType in type.GetTypeInfo().ImplementedInterfaces)
             {
                 yield return interfaceType;
             }
         }

IEnumerable<Type> Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.GetParameters ( )

inherited

Returns an IEnumerable<Type> of the generic parameters that constructed the base-factory instance.

Definition at line 60 of file Factory.cs.

         {
             var type = this.GetType();
             yield return type;
 
             foreach(var parameterType in type.GetTypeInfo().GenericTypeParameters)
             {
                 yield return parameterType;
             }
         }

static object Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.Instantiate	(	Type	type,
		params object[]	parameters
	)

staticprotectedinherited

Internal method for object instantiation by a passed type type

Parameters

type	the type of the class or struct which to instance
parameters	the parameters passed to the constructor of the class or struct

Returns: Returns an instance object of type TOut or null

Definition at line 93 of file Factory.cs.

         {
             return Instantiate<object>(type: type, args: parameters);
         }

static TOut Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.Instantiate< TOut >	(	Type	type,
		Type[]	parameters,
		params object[]	args
	)

staticprotectedinherited

Internal method object instantiation of a generic type , with the generic-parameters passed as the second argument

Template Parameters

TOut	The type of the instance to pass out

Parameters

type	The type of the class or struct which to instance
parameters	the generic types that comprise the generic type
args	The parameters passed to the constructor of the class or struct

Returns: Returns an instance object of type TOut or null

Definition at line 125 of file Factory.cs.

         {
             var constructed = type.GetTypeInfo().MakeGenericType(parameters);
             var instance = Instantiate<TOut>(type: constructed, args: args);
             return instance;
         }

static TOut Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.Instantiate< TOut >	(	Type	type,
		object[]	args = `null`
	)

staticprotectedinherited

Creates an instance of the type designated by the specified generic type parameter

Parameters

type	The type of the class or struct which to instance
args	the parameters passed to the constructor of the class or struct

Returns: A reference to the newly created object.

Exceptions

System.MissingMethodException NoteIn the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, System.MissingMemberException, instead. The type that specified for T does not have a parameterless constructor.

Centralize all runtime calls to

<tt>Activator.Create(...)</tt>

and

constructor.Invoke(...)`

Definition at line 141 of file Factory.cs.

         {
             if(args?.Length == 0)
             {
                 return (TOut)Activator.CreateInstance(type);
             }
             return (TOut)Activator.CreateInstance(type, args);
         }

override string Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.ToString ( )

inherited

Returns a string representation of the Factory type.

Definition at line 153 of file Factory.cs.

         {
             var type = this.GetType().GetTypeInfo();
             var genericArgs = type.GenericTypeArguments;
             if(genericArgs.Any())
             {
                 var typeNames = genericArgs.Select(t => t.Name)
                     .Aggregate((a, b) => a + ',' + b);
                 return $"{type.Name} <{typeNames}>";
             }
             else
             {
                 return type.Name;
             }
         }

static bool Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.TryInstantiate	(	Type	type,
		out object	instance,
		params object[]	parameters
	)

staticprotectedinherited

Internal method for object instantiation following the "Try" convention of returning a bool true upon success and passing the result with out

Parameters

type	The type of the class or struct which to instance
parameters	The parameters passed to the constructor of the class or struct
instance	The assigned instance reference upon instancing of type TOut or `null` upon failure

Returns: Returns bool true upon success or false upon failure and assigning null to instance

Definition at line 105 of file Factory.cs.

         {
             instance = null;
             try { 
                 instance = Instantiate<object>(type: type, args: parameters);
             } catch(Exception)
             {
                 return false;
             }
             return true;
         }

Property Documentation

string Core.TypeCast.Base.Factory< TInstance, TIn1, TIn2 >.Name

getinherited

Gets a string representation of the Base-Factory using ToString()

Definition at line 36 of file Factory.cs.

The documentation for this class was generated from the following file:

TypeCast/Base/ConverterFactoryRT.cs

Public Member Functions

Static Protected Member Functions

Properties

Detailed Description

Member Function Documentation

Property Documentation