Merge pull request #3 from ShawnLaMountain/main

Added WinForms sample 'SimpleContacts'

Author: ShawnLaMountain

README.md

@@ -31,6 +31,12 @@ Grab the latest [ThunderDesign.Net-PCL.SQLite NuGet](https://www.nuget.org/packa
 
 Use the `-version` option to specify an [older version](https://www.nuget.org/packages/ThunderDesign.Net-PCL.SQLite#versions-tab) to install.
 
+## Examples
+
+*(TIP: Clone repo, open the solution, build it and run sample app.)*
+- WinForms
+  - [SimpleContacts Examples](https://github.com/ThunderDesign/ThunderDesign.Net-PCL.SQLite/tree/main/samples/WinForms/SimpleContacts)
+
 ## Please Contribute!
 
 This is an open source project that welcomes contributions/suggestions/bug reports from those who use it. If you have any ideas on how to improve the library, please [post an issue here on GitHub](https://github.com/ThunderDesign/ThunderDesign.Net-PCL.SQLite/issues). Please check out the [How to Contribute](https://github.com/ThunderDesign/ThunderDesign.Net-PCL.SQLite/blob/main/.github/CONTRIBUTING.md).

samples/WinForms/SimpleContacts/SimpleContacts.sln

@@ -0,0 +1,31 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.1.32127.271
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SimpleContacts", "SimpleContacts\SimpleContacts.csproj", "{AA88F337-DD27-4C88-8BE5-E1E4F7AFD60D}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ThunderDesign.Net-PCL.SQLite", "..\..\..\src\ThunderDesign.Net-PCL.SQLite\ThunderDesign.Net-PCL.SQLite.csproj", "{00E7FCCF-4240-4E13-9FC1-DD2A60EF8155}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{AA88F337-DD27-4C88-8BE5-E1E4F7AFD60D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AA88F337-DD27-4C88-8BE5-E1E4F7AFD60D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AA88F337-DD27-4C88-8BE5-E1E4F7AFD60D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AA88F337-DD27-4C88-8BE5-E1E4F7AFD60D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{00E7FCCF-4240-4E13-9FC1-DD2A60EF8155}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{00E7FCCF-4240-4E13-9FC1-DD2A60EF8155}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{00E7FCCF-4240-4E13-9FC1-DD2A60EF8155}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{00E7FCCF-4240-4E13-9FC1-DD2A60EF8155}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+	GlobalSection(ExtensibilityGlobals) = postSolution
+		SolutionGuid = {A04264C0-1ABF-4A93-A391-9E3B4F18983A}
+	EndGlobalSection
+EndGlobal

samples/WinForms/SimpleContacts/SimpleContacts/Database/Bridges/ContactsBridge.cs

@@ -0,0 +1,33 @@
+using SimpleContacts.Database.Tables;
+using SimpleContacts.Databases.ORMs;
+using ThunderDesign.Net.SQLite.Bridges;
+
+namespace SimpleContacts.Database.Bridges
+{
+    public class ContactsBridge : BaseBridge<ushort, ContactsORM>
+    {
+        #region constructors
+        public ContactsBridge() : base(ContactsTable.Instance)
+        {
+        }
+        #endregion
+
+        #region properties
+        public static ContactsBridge Instance
+        {
+            get
+            {
+                lock (_Locker)
+                {
+                    return _Instance ??= new ContactsBridge();
+                }
+            }
+        }
+        #endregion
+
+        #region variables
+        protected readonly static object _Locker = new();
+        private static ContactsBridge? _Instance = null;
+        #endregion
+    }
+}

samples/WinForms/SimpleContacts/SimpleContacts/Database/Connections/SimpleContactsConnection.cs

@@ -0,0 +1,31 @@
+using ThunderDesign.Net.SQLite.Connections;
+
+namespace SimpleContacts.Databases.Connections
+{
+    public class SimpleContactsConnection : BaseSQLiteConnection
+    {
+        #region constructors
+        public SimpleContactsConnection() : base(_DatabaseFilename)
+        {
+        }
+        #endregion
+
+        #region properties
+        public static SimpleContactsConnection Instance
+        {
+            get
+            {
+                lock (_Locker)
+                {
+                    return _Instance ??= new SimpleContactsConnection();
+                }
+            }
+        }
+        #endregion
+
+        #region variables
+        private const string _DatabaseFilename = "Contacts.db3";
+        private static SimpleContactsConnection? _Instance = null;
+        #endregion
+    }
+}

samples/WinForms/SimpleContacts/SimpleContacts/Database/ORMs/ContactsORM.cs

@@ -0,0 +1,53 @@
+using SQLite;
+using ThunderDesign.Net.SQLite.ORMs;
+using ThunderDesign.Net.Threading.Extentions;
+
+namespace SimpleContacts.Databases.ORMs
+{
+    [Table("Contacts")]
+    public class ContactsORM : BaseSQLiteORM_AutoIncrement<ushort>
+    {
+        #region properties
+        [Column("first_name")]
+        public string FirstName
+        {
+            get { return this.GetProperty(ref _FirstName, _Locker); }
+            set
+            {
+                if (this.SetProperty(ref _FirstName, value, _Locker, true))
+                    this.OnPropertyChanged(nameof(FullName));
+            }
+        }
+
+        [Column("last_name")]
+        public string LastName
+        {
+            get { return this.GetProperty(ref _LastName, _Locker); }
+            set
+            {
+                if (this.SetProperty(ref _LastName, value, _Locker, true))
+                    this.OnPropertyChanged(nameof(FullName));
+            }
+        }
+
+        [Ignore]
+        public string FullName
+        {
+            get { return GetFullName(); }
+        }
+        #endregion
+
+        #region methods
+        private string GetFullName()
+        {
+            return $"{LastName}, {FirstName} = {Id}";
+        }
+        #endregion
+
+        #region variables
+        protected string _FirstName = String.Empty;
+        protected string _LastName = String.Empty;
+        #endregion
+
+    }
+}

samples/WinForms/SimpleContacts/SimpleContacts/Database/Tables/ContactsTable.cs

@@ -0,0 +1,33 @@
+using SimpleContacts.Databases.Connections;
+using SimpleContacts.Databases.ORMs;
+using ThunderDesign.Net.SQLite.Tables;
+
+namespace SimpleContacts.Database.Tables
+{
+    public class ContactsTable : BaseSQLiteTable<ContactsORM>
+    {
+        #region constructors
+        public ContactsTable() : base(SimpleContactsConnection.Instance)
+        {
+        }
+        #endregion
+
+        #region properties
+        public static ContactsTable Instance
+        {
+            get
+            {
+                lock (_Locker)
+                {
+                    return _Instance ??= new ContactsTable();
+                }
+            }
+        }
+        #endregion
+
+        #region variables
+        private static ContactsTable? _Instance = null;
+        #endregion
+
+    }
+}

samples/WinForms/SimpleContacts/SimpleContacts/FormContactInfo.Designer.cs

@@ -0,0 +1,54 @@
+using SimpleContacts.Databases.ORMs;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Data;
+using System.Drawing;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using System.Windows.Forms;
+
+namespace SimpleContacts
+{
+    public partial class Form_ContactInfo : Form
+    {
+        #region constructors
+        public Form_ContactInfo(ContactsORM contactsORM) : base()
+        {
+            InitializeComponent();
+            _ContactsORM = contactsORM;
+            TextBox_FirstName.Text = contactsORM.FirstName;
+            TextBox_LastName.Text = contactsORM.LastName;
+        }
+        #endregion
+
+        #region methods
+        private void Button_Save_Click(object sender, EventArgs e)
+        {
+            if (String.IsNullOrEmpty(TextBox_LastName.Text))
+            {
+                MessageBox.Show("Last Name is required");
+                TextBox_LastName.Focus();
+                return;
+            }
+
+            if (String.IsNullOrEmpty(TextBox_FirstName.Text))
+            {
+                MessageBox.Show("First Name is required");
+                TextBox_FirstName.Focus();
+                return;
+            }
+
+            _ContactsORM.FirstName = TextBox_FirstName.Text;
+            _ContactsORM.LastName = TextBox_LastName.Text;
+
+            this.DialogResult = DialogResult.OK;
+        }
+        #endregion
+
+        #region variables
+        private readonly ContactsORM _ContactsORM;
+        #endregion
+    }
+}