{"id":243,"date":"2010-01-12T09:53:25","date_gmt":"2010-01-12T09:53:25","guid":{"rendered":"http:\/\/dirk.forbiddendream.be\/?p=243"},"modified":"2016-01-07T10:50:18","modified_gmt":"2016-01-07T10:50:18","slug":"creating-plugins-in-c-the-application-part-44","status":"publish","type":"post","link":"https:\/\/dirk.schuermans.me\/?p=243","title":{"rendered":"Creating plugins in C#: The Application (Part 4\/4)"},"content":{"rendered":"

Welcome to the fourth and final part of our little tutorial ^.^<\/p>\n

In this part I’ll explain how the application <\/strong>works and what you need in order for it to work…<\/p>\n

<\/p>\n

The application<\/h1>\n

Alright, we have our handler and plugin. It’s time to load the plugin from within our application \ud83d\ude09<\/p>\n

Add a new C# Windows Form project<\/strong> called TestApplication <\/strong>(Add > New Project<\/em>)<\/p>\n

Add a reference to the PluginHandler <\/strong>project<\/p>\n

\"\"<\/a>
Adding a reference to an existing project<\/figcaption><\/figure>\n

Open the code view of the application (TestApplication.cs<\/em>) and add the following using statements:<\/p>\n

using System.Reflection;\r\nusing System.IO;<\/pre>\n
Drag a TextBox<\/strong> onto the form and call it txtPlugin
\nDrag a <\/span>Button onto the form and call it <\/span>btnBrowse
\nDrag a <\/span>Button onto the form and call it <\/span>btnLoad
\nDrag an <\/span>OpenFileDialog onto the form and call it <\/span>ofdPlugin<\/strong><\/p>\n
\"\"<\/a>
This is how it could look like<\/figcaption><\/figure>\n
Double click the btnBrowse<\/strong> button and add the following code:<\/p>\n
private void btnBrowse_Click(object sender, EventArgs e)\r\n{\r\n        ofdPlugin.Filter = \"Plugin | *.dll\";\r\n        ofdPlugin.FileName = \"\";\r\n        ofdPlugin.CheckFileExists = true;\r\n        ofdPlugin.FileOk += new CancelEventHandler(ofdPlugin_FileOk);\r\n\r\n        ofdPlugin.ShowDialog();\r\n}<\/pre>\n
Add the following method aswel (This is the ofdPlugin.FileOk event handler<\/em>)l:<\/p>\n
private void ofdPlugin_FileOk(object sender, CancelEventArgs e)\r\n{\r\n        if (e.Cancel == false)\r\n        {\r\n                txtPlugin.Text = ofdPlugin.FileName;\r\n                btnLoad.Enabled = true;\r\n        }\r\n}<\/pre>\n
The above code will show an open file dialog when you click the browse button, allowing you to select the plugin you wish to load.
\nWhen you’ve selected the DLL you wish to load and it’s a file that exists, it’ll show the full path to the file in the textbox and enable the load button.<\/p>\n
Now double click the btnLoad<\/strong> button and add the following code:<\/p>\n
private void btnLoad_Click(object sender, EventArgs e)\r\n{\r\n        this.LoadPlugin(txtPlugin.Text);\r\n}<\/pre>\n
Now, if you honestly thought that it would be th\u00e1t simple, you’re wrong ^.^
\nBefore all of that works, we’ll need some extra code that acutally deals with the whole plugin loading thing:<\/p>\n
\/\/ Code snippet for loading the plugin\r\n        private void LoadPlugin(string p_sPlugin)\r\n        {\r\n            try\r\n            {\r\n                FileInfo fiPlugin = new FileInfo(p_sPlugin);\r\n                Assembly assembly = null;\r\n                string typeName = string.Empty;\r\n                Type pluginType = null;\r\n\r\n                assembly = Assembly.LoadFile(fiPlugin.FullName);\r\n\r\n                if (null != assembly)\r\n                {\r\n                    foreach (Type type in assembly.GetTypes())\r\n                    {\r\n                        if (type.IsAbstract) continue;\r\n                        if (type.IsDefined(typeof(PluginAttribute), true))\r\n                        {\r\n                            pluginType = type;\r\n                            break;\r\n                        }\r\n                    }\r\n\r\n                    if (null != pluginType)\r\n                    {\r\n                        ((IPlugin)Activator.CreateInstance(pluginType)).ShowPlugin();\r\n                    }\r\n                    else\r\n                    {\r\n                        this.ShowError(fiPlugin.Name + \" is not a valid plugin.\" + Environment.NewLine + Environment.NewLine + \"(Invalid plugin type)\");\r\n                    }\r\n                }\r\n\r\n            }\r\n            catch (System.InvalidCastException)\r\n            {\r\n                this.ShowError(fiPlugin.Name + \" is not a valid plugin.\" + Environment.NewLine + Environment.NewLine + \"(Missing interface)\");\r\n            }\r\n            catch (System.BadImageFormatException)\r\n            {\r\n                this.ShowError(fiPlugin.Name + \" is not a valid plugin.\" + Environment.NewLine + Environment.NewLine + \"(Invalid .NET Assembly)\");\r\n            }\r\n            catch (System.Exception ex)\r\n            {\r\n                this.ShowError(\"There was a problem loading \" + fiPlugin.Name);\r\n            }\r\n        }<\/pre>\n
The above method will do the following things:<\/p>\n
It will first check if we managed to load the assembly information of the DLL file.
\nAfter that it goes over each Type from the DLL and checks if it is an abstract type and if the type equals our PluginAttribute.<\/p>\n
When thats the case it will load the Plugin using the ShowPlugin() method \ud83d\ude42<\/p>\n
There we go, that’s it \ud83d\ude42
\nRun the application, select the plugin we created and load it! (Make sure you hit ctrl + shift + b<\/span> first so that it builds our entire solution<\/em>)<\/p>\n
If you have encountered any errors during this tutorial, please let me know so I can correct them \ud83d\ude09
\nBut as far as I know there shouldn’t be any \ud83d\ude00<\/p>\n
Enjoy!<\/p>\n
– Dirk<\/p>\n","protected":false},"excerpt":{"rendered":"
Welcome to the fourth and final part of our little tutorial ^.^ In this part I’ll explain how the application works and what you need in order for it to work…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[38,6],"tags":[],"_links":{"self":[{"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/posts\/243"}],"collection":[{"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=243"}],"version-history":[{"count":9,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/posts\/243\/revisions"}],"predecessor-version":[{"id":539,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=\/wp\/v2\/posts\/243\/revisions\/539"}],"wp:attachment":[{"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=243"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=243"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dirk.schuermans.me\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=243"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}