Can someone explain Activator.CreateInstance()
purpose in detail?
10 Answers
Say you have a class called MyFancyObject
like this one below:
class MyFancyObject
{
public int A { get;set;}
}
It lets you turn:
String ClassName = "MyFancyObject";
Into
MyFancyObject obj;
Using
obj = (MyFancyObject)Activator.CreateInstance("MyAssembly", ClassName))
and can then do stuff like:
obj.A = 100;
That's its purpose. It also has many other overloads such as providing a Type
instead of the class name in a string. Why you would have a problem like that is a different story. Here's some people who needed it:
-
3This proved useful to me. In my case, the class was in a different namespace, so I had to make sure that I included the namespace in my ClassName string (i.e.
String ClassName = "My.Namespace.MyFancyObject";
).– ScottJun 17, 2013 at 20:14 -
3You forgot to add the Unwrap(). You can also put null, instead of "MyAssembly", and system will search current Assembly.– TonySep 18, 2013 at 1:34
-
1Can I do something like this
obj = (MyFancyObject)Activator.CreateInstance("MyAssembly", ClassName))
but instead of casting with the type. Cast with type made from the ClassName? Like thisType type = Type.GetType(ClassName);obj = (type )Activator.CreateInstance("MyAssembly", ClassName))
?– rluksMar 26, 2015 at 16:09 -
@Pan.student YES for more info, here is a perfect tutorial video showcasing that exact line of code, using generics and delegates. JeremyBytes - C# Generics - Part 3: Methods & Delegates - You Tube Nov 9, 2015 at 8:21
-
If I simply use MyFancyObject obj = new MyFancyObject() I can do the same with much lesser code. Apr 26 at 6:39
Well i can give you an example why to use something like that. Think of a game where you want to store your level and enemies in an XML file. When you parse this file, you might have an element like this.
<Enemy X="10" Y="100" Type="MyGame.OrcGuard"/>
what you can do now is, create dynamically the objects found in your level file.
foreach(XmlNode node in doc)
var enemy = Activator.CreateInstance(null, node.Attributes["Type"]);
This is very useful, for building dynamic enviroments. Of course its also possible to use this for Plugin or addin scenarios and alot more.
-
7I understood that it was to create a new instance of a type, but this is a nice simple example of why one would want to do so. Feb 8, 2012 at 13:51
-
Are you saying that the benefit is that using dynamic environments allows for polymorphic-like (polymorphism-like) programming? May 21, 2021 at 20:44
-
Your code sets the local variable "enemy" to whatever the current node is and after the loop is done you have nothing? Apr 26 at 6:43
-
Well, it is an pseudo-code example, not meant as a full a-z program. So whatever you do with enemy is up to you and not important for the example. May 18 at 11:07
My good friend MSDN can explain it to you, with an example
Here is the code in case the link or content changes in the future:
using System;
class DynamicInstanceList
{
private static string instanceSpec = "System.EventArgs;System.Random;" +
"System.Exception;System.Object;System.Version";
public static void Main()
{
string[] instances = instanceSpec.Split(';');
Array instlist = Array.CreateInstance(typeof(object), instances.Length);
object item;
for (int i = 0; i < instances.Length; i++)
{
// create the object from the specification string
Console.WriteLine("Creating instance of: {0}", instances[i]);
item = Activator.CreateInstance(Type.GetType(instances[i]));
instlist.SetValue(item, i);
}
Console.WriteLine("\nObjects and their default values:\n");
foreach (object o in instlist)
{
Console.WriteLine("Type: {0}\nValue: {1}\nHashCode: {2}\n",
o.GetType().FullName, o.ToString(), o.GetHashCode());
}
}
}
// This program will display output similar to the following:
//
// Creating instance of: System.EventArgs
// Creating instance of: System.Random
// Creating instance of: System.Exception
// Creating instance of: System.Object
// Creating instance of: System.Version
//
// Objects and their default values:
//
// Type: System.EventArgs
// Value: System.EventArgs
// HashCode: 46104728
//
// Type: System.Random
// Value: System.Random
// HashCode: 12289376
//
// Type: System.Exception
// Value: System.Exception: Exception of type 'System.Exception' was thrown.
// HashCode: 55530882
//
// Type: System.Object
// Value: System.Object
// HashCode: 30015890
//
// Type: System.Version
// Value: 0.0
// HashCode: 1048575
-
1Unlikely to happen for MSDN, and copying the content here is almost a violation of copyright ;) Jun 22, 2013 at 18:07
-
16You're right. Personally I feel the principle also works to give better answers. I often come to SO with a lot on my mind from my current project. I usually just want a simple and to-the-point answer, so I can continue where I left off. I hate having to open up articles, which sometimes even link to other articles. Many answerers don't realize that many people don't come here with time on their hands to read through several articles, with a ton of unnecessary introductions and talks. Briefly summing up the important parts of a good article is key to some of the greatest answers I've seen.– Aske B.Jun 26, 2013 at 20:42
You can also do this -
var handle = Activator.CreateInstance("AssemblyName",
"Full name of the class including the namespace and class name");
var obj = handle.Unwrap();
-
-
I can't find the 'Unwrap()' method above to use (as above). Has something changed in the new .NET APIs?– SamMay 6, 2015 at 14:36
-
-
2Could you provide some additional explanation on what
.Unwrap()
does precisely and how this relates to other solutions? May 10, 2015 at 23:36 -
@Sam it's on a different overload of
CreateInstance
where it returnsSystem.Runtime.Remoting.ObjectHandle
.– nawfalJul 3, 2016 at 12:35
A good example could be next: for instance you have a set of Loggers and you allows user to specify type to be used in runtime via configuration file.
Then:
string rawLoggerType = configurationService.GetLoggerType();
Type loggerType = Type.GetType(rawLoggerType);
ILogger logger = Activator.CreateInstance(loggerType.GetType()) as ILogger;
OR another case is when you have a common entities factory, which creates entity, and is also responsible on initialization of an entity by data received from DB:
(pseudocode)
public TEntity CreateEntityFromDataRow<TEntity>(DataRow row)
where TEntity : IDbEntity, class
{
MethodInfo methodInfo = typeof(T).GetMethod("BuildFromDataRow");
TEntity instance = Activator.CreateInstance(typeof(TEntity)) as TEntity;
return methodInfo.Invoke(instance, new object[] { row } ) as TEntity;
}
-
This does not work,
typeof(loggerType)
results inloggerType is a variable and used like a type
Mar 5, 2017 at 21:36
The Activator.CreateInstance
method creates an instance of a specified type using the constructor that best matches the specified parameters.
For example, let's say that you have the type name as a string, and you want to use the string to create an instance of that type. You could use Activator.CreateInstance
for this:
string objTypeName = "Foo";
Foo foo = (Foo)Activator.CreateInstance(Type.GetType(objTypeName));
Here's an MSDN article that explains it's application in more detail:
-
7Or you could just use
new Foo()
. I think the OP wanted a more realistic example. Sep 29, 2011 at 13:38 -
1I agree with @Konrad. The reason for using
CreateInstance
is if you don't know the type of object you are going to instantiate at design time. In this example, you clearly know it's of typeFoo
since you are casting it as typeFoo
. You would never do this because you can just doFoo foo = new Foo()
. Dec 23, 2013 at 16:15
Building off of deepee1 and this, here's how to accept a class name in a string, and then use it to read and write to a database with LINQ. I use "dynamic" instead of deepee1's casting because it allows me to assign properties, which allows us to dynamically select and operate on any table we want.
Type tableType = Assembly.GetExecutingAssembly().GetType("NameSpace.TableName");
ITable itable = dbcontext.GetTable(tableType);
//prints contents of the table
foreach (object y in itable) {
string value = (string)y.GetType().GetProperty("ColumnName").GetValue(y, null);
Console.WriteLine(value);
}
//inserting into a table
dynamic tableClass = Activator.CreateInstance(tableType);
//Alternative to using tableType, using Tony's tips
dynamic tableClass = Activator.CreateInstance(null, "NameSpace.TableName").Unwrap();
tableClass.Word = userParameter;
itable.InsertOnSubmit(tableClass);
dbcontext.SubmitChanges();
//sql equivalent
dbcontext.ExecuteCommand("INSERT INTO [TableNme]([ColumnName]) VALUES ({0})", userParameter);
Coupled with reflection, I found Activator.CreateInstance to be very helpful in mapping stored procedure result to a custom class as described in the following answer.
Why would you use it if you already knew the class and were going to cast it? Why not just do it the old fashioned way and make the class like you always make it? There's no advantage to this over the way it's done normally. Is there a way to take the text and operate on it thusly:
label1.txt = "Pizza"
Magic(label1.txt) p = new Magic(lablel1.txt)(arg1, arg2, arg3);
p.method1();
p.method2();
If I already know its a Pizza there's no advantage to:
p = (Pizza)somefancyjunk("Pizza"); over
Pizza p = new Pizza();
but I see a huge advantage to the Magic method if it exists.
We used it for something like e.g.
public interface IExample
{
void DoSomethingAmazing();
}
public class ExampleA : IExample
{
public void DoSomethingAmazing()
{
Console.WriteLine("AAAA");
}
public void DoA()
{
Console.WriteLine("A")
}
}
public class ExampleB : IExample
{
public void DoSomethingAmazing()
{
Console.WriteLine("BBBB");
}
public void DoB()
{
Console.WriteLine("B")
}
}
and then provided the type serialized from a settings file
=> Even after compilation we can still change the applications behaviour by using different settings
Something like e.g.
public static class Programm
{
public static void Main()
{
var type = MagicMethodThatReadsASerializedTypeFromTheSettings();
var example = (IExample) Activator.CreateInstance(type);
example.DoSomethingAmazing();
switch(example)
{
case ExampleA a:
a.DoA();
break;
case ExampleB b:
b.DoB();
break;
}
}
}
And I use it in a custom multi-user serialization where I send RPC (Remote Procedure Calls) to other devices with parameters.
Extremly cropped to the necesarry it basically does
public ISendable
{
public byte[] ToBytes();
public void FromBytes(byte[] bytes);
}
// Converts any ISendable into a byte[] with the content
// typeBytes + contentBytes
public byte[] ToBytes(ISendable toSend)
{
var typeBytes = Encoding.ASCII.GetBytes(toSend.GetType().AssemblyQualifiedName);
var contentBytes = ISendable.ToBytes();
return MagicMethodToCombineByteArrays(typeBytes, contentBytes);
}
// Coonverts back from byte[] to the according ISendable
// by first reading the type, creating the instance and filling it with
// contentBytes
public T FromBytes<T>(byte[] bytes) where T : ISendable
{
MagicMethodToSplitInputBytes(out var typeBytes, out var contentBytes);
var type = Encoding.ASCII.GetString(typeBytes);
var instance = (T) Activator.CreateInstance(type);
instance.FromBytes(contentBytes);
return instance;
}
CreateInstance(Type type)
is matched with theCreateInstance<T>()
overload.c#.net
way of doingObject xyz = Class.forName(className).newInstance();
.