增刪改查入門

新建控制檯項目（.NET Core），從nuget引用NewLife.XCode，（也可以從別的項目引用下載後拷貝XCode.dll和NewLife.Core.dll來使用，區分nfx和netcore版本），敲入以下代碼

// 啓用控制檯日誌
XTrace.UseConsole();

// 添加
var user = new UserX
{
    Name = "大石頭",
    Enable = true
};
user.Insert();
// 自增字段user.ID已經取得值
XTrace.WriteLine("用戶ID：{0}", user.ID);

// 查詢
var user2 = UserX.Find(UserX._.Name == "大石頭");

// 更新
user2.Logins++;
user2.LastLogin = DateTime.Now;
user2.Update();

// 刪除
var user3 = UserX.FindByID(user.ID);
user3.Delete();

Console.ReadLine();

先跑起來看看效果：

#Software: ConsoleApp4
#ProcessID: 21252 x64
#AppDomain: ConsoleApp4
#FileName: C:\Program Files\dotnet\dotnet.exe
#BaseDirectory: D:\Test\ConsoleApp4\ConsoleApp4\bin\Debug\netcoreapp2.1\
#CommandLine: D:\Test\ConsoleApp4\ConsoleApp4\bin\Debug\netcoreapp2.1\ConsoleApp4.dll
#ApplicationType: Console
#CLR: 4.0.30319.42000, 
#OS: Microsoft Windows NT 6.2.9200.0, X3/Stone
#CPU: 8
#GC: IsServerGC=False, LatencyMode=Interactive
#Date: 2019-02-25
#字段: 時間 線程ID 線程池Y網頁W普通N 線程名 消息內容
#Fields: Time ThreadID IsPoolThread ThreadName Message
22:57:13.089  1 N - NewLife.Core v8.0.2019.0101 Build 2019-01-26 23:22:36 
22:57:13.104  1 N - 新生命X組件核心庫 ©2002-2019 新生命開發團隊
22:57:13.114  1 N - ConsoleApp4 v1.0.0.0 Build 2000-01-01 
22:57:13.115  1 N - ConsoleApp4 
22:57:13.115  1 N - Setting的配置文件Config\Core.config 不存在，準備用默認配置覆蓋！
22:57:13.277  1 N - Setting的配置文件Config\XCode.config 不存在，準備用默認配置覆蓋！
22:57:13.282  1 N - XCode v9.10.2019.0101 Build 2019-01-26 23:22:38 
22:57:13.282  1 N - 數據中間件 ©2002-2019 新生命開發團隊
22:57:13.628  1 N - 自動爲[Membership]設置SQLite連接字符串：Data Source=.\Membership.db;Migration=On
22:57:13.652  1 N - System.Data.SQLite.dll不存在或平臺版本不正確，準備聯網獲取 http://x.newlifex.com/
22:57:13.835  1 N - 下載鏈接 http://x.newlifex.com/，目標 System.Data.SQLite.win-x64,System.Data.SQLite.win,System.Data.SQLite.st,System.Data.SQLite
22:57:13.964  4 Y 1 WebClientX.Get http://x.newlifex.com/
22:57:15.660  1 N - 分析得到文件 System.Data.SQLite.win-x64_20180823112512.zip，準備下載 http://x.newlifex.com/System.Data.SQLite.win-x64_20180823112512.zip
22:57:15.663  4 Y 19 WebClientX.Get http://x.newlifex.com/System.Data.SQLite.win-x64_20180823112512.zip
22:57:16.897  1 N - 下載完成，共924,475字節，耗時1,232毫秒
22:57:16.897  1 N - 解壓縮到 D:\Test\ConsoleApp4\ConsoleApp4\bin\Debug\netcoreapp2.1\Plugins
22:57:17.074  1 N - TypeX.GetType("System.Data.SQLite.SQLiteFactory") => Plugins\System.Data.SQLite.dll
22:57:17.074  1 N - System.Data.SQLite驅動D:\Test\ConsoleApp4\ConsoleApp4\bin\Debug\netcoreapp2.1\Plugins\System.Data.SQLite.dll 版本v1.0.109.0
22:57:17.145  1 N - Data Source=D:\Test\ConsoleApp4\ConsoleApp4\bin\Debug\netcoreapp2.1\Membership.db;Cache Size=-524288;Synchronous=Off;Journal Mode=WAL
22:57:17.154  4 Y 198 檢查實體XCode.Membership.UserX的數據表架構，模式：CheckTableWhenFirstUse
22:57:17.160  4 Y 198 創建數據庫：Membership
22:57:17.161  4 Y 198 創建數據庫：D:\Test\ConsoleApp4\ConsoleApp4\bin\Debug\netcoreapp2.1\Membership.db
22:57:17.181  4 Y 198 select * from sqlite_master
22:57:17.284  4 Y 198 創建表：User(用戶)
22:57:17.298  4 Y 198 Create Table User(
    ID integer Primary Key AUTOINCREMENT,
    Name nvarchar(50) NOT NULL COLLATE NOCASE,
    Password nvarchar(50) NULL COLLATE NOCASE,
    DisplayName nvarchar(50) NULL COLLATE NOCASE,
    Sex int NOT NULL,
    Mail nvarchar(50) NULL COLLATE NOCASE,
    Mobile nvarchar(50) NULL COLLATE NOCASE,
    Code nvarchar(50) NULL COLLATE NOCASE,
    Avatar nvarchar(200) NULL COLLATE NOCASE,
    RoleID int NOT NULL,
    RoleIDs nvarchar(200) NULL COLLATE NOCASE,
    DepartmentID int NOT NULL,
    Online bit NOT NULL,
    Enab...etime NULL,
    LastLoginIP nvarchar(50) NULL COLLATE NOCASE,
    RegisterTime datetime NULL,
    RegisterIP nvarchar(50) NULL COLLATE NOCASE,
    Ex1 int NOT NULL,
    Ex2 int NOT NULL,
    Ex3 real NOT NULL,
    Ex4 nvarchar(50) NULL COLLATE NOCASE,
    Ex5 nvarchar(50) NULL COLLATE NOCASE,
    Ex6 nvarchar(50) NULL COLLATE NOCASE,
    UpdateUser nvarchar(50) NULL COLLATE NOCASE,
    UpdateUserID int NOT NULL,
    UpdateIP nvarchar(50) NULL COLLATE NOCASE,
    UpdateTime datetime NULL,
    Remark nvarchar(200) NULL COLLATE NOCASE
)
22:57:17.309  4 Y 198 Create Unique Index IU_User_Name On User (Name)
22:57:17.311  4 Y 198 Create Index IX_User_RoleID On User (RoleID)
22:57:17.312  4 Y 198 Create Index IX_User_UpdateTime On User (UpdateTime)
22:57:17.320  4 Y 198 UserX.Count 快速計算表記錄數（非精確）[User/Membership] 參考值 -2
22:57:17.332  4 Y 198 開始檢查連接[Membership/SQLite]的數據庫架構……
22:57:17.355  4 Y 198 [Membership]的所有實體類（5個）：Parameter,UserX,Menu,Role,Department
22:57:17.356  4 Y 198 [Membership]需要檢查架構的實體類（1個）：Parameter
22:57:17.357  4 Y 198 Membership待檢查表架構的實體個數：1
22:57:17.358  4 Y 198 select * from sqlite_master
22:57:17.365  4 Y 198 創建表：Parameter(字典參數)
22:57:17.368  4 Y 198 Create Table Parameter(
    ID integer Primary Key AUTOINCREMENT,
    Category nvarchar(50) NULL COLLATE NOCASE,
    Name nvarchar(50) NULL COLLATE NOCASE,
    Value nvarchar(200) NULL COLLATE NOCASE,
    LongValue nvarchar(2000) NULL COLLATE NOCASE,
    Kind int NOT NULL,
    Enable bit NOT NULL,
    Ex1 int NOT NULL,
    Ex2 int NOT NULL,
    Ex3 real NOT NULL,
    Ex4 nvarchar(50) NULL COLLATE NOCASE,
    Ex5 nvarchar(50) NULL COLLATE NOCASE,
    Ex6 nvarchar(50) NULL COLLATE NOCASE,
    CreateUser nvarchar(50) NULL COLLATE NOCASE,
    CreateUserID int NOT NULL,
    CreateIP nvarchar(50) NULL COLLATE NOCASE,
    CreateTime datetime NULL,
    UpdateUser nvarchar(50) NULL COLLATE NOCASE,
    UpdateUserID int NOT NULL,
    UpdateIP nvarchar(50) NULL COLLATE NOCASE,
    UpdateTime datetime NULL,
    Remark nvarchar(200) NULL COLLATE NOCASE
)
22:57:17.369  4 Y 198 Create Unique Index IU_Parameter_Category_Name On Parameter (Category, Name)
22:57:17.370  4 Y 198 Create Index IX_Parameter_Name On Parameter (Name)
22:57:17.370  4 Y 198 Create Index IX_Parameter_UpdateTime On Parameter (UpdateTime)
22:57:17.372  4 Y 198 檢查連接[Membership/SQLite]的數據庫架構耗時38ms
22:57:17.383  4 Y 198 Select * From User Order By ID Desc limit 1
22:57:17.388  4 Y 198 Select Count(*) From User
22:57:17.398  4 Y 198 Select Count(*) From User
22:57:17.401  4 Y 198 開始初始化UserX用戶數據……
22:57:17.455  4 Y 198 Insert Into User(Name, Password, DisplayName, Sex, Mail, Mobile, Code, Avatar, RoleID, RoleIDs, DepartmentID, Online, Enable, Logins, LastLogin, LastLoginIP, RegisterTime, RegisterIP, Ex1, Ex2, Ex3, Ex4, Ex5, Ex6, UpdateUser, UpdateUserID, UpdateIP, UpdateTime, Remark) Values('admin', '21232F297A57A5A743894A0E4A801FC3', '管理員', 0, null, null, null, null, 1, '', 0, 0, 1, 0, null, null, null, null, 0, 0, 0, null, null, null, null, 0, null, null, null);Select last_insert_rowid() newid
22:57:17.479  4 Y 198 自動爲[Log]設置SQLite連接字符串：Data Source=.\Log.db;Migration=On
22:57:17.491  4 Y 198 Data Source=D:\Test\ConsoleApp4\ConsoleApp4\bin\Debug\netcoreapp2.1\Log.db;Cache Size=-524288;Synchronous=Off;Journal Mode=WAL
22:57:17.514  4 Y 198 完成初始化UserX用戶數據！
22:57:17.548  1 N - Insert Into User(Name, Password, DisplayName, Sex, Mail, Mobile, Code, Avatar, RoleID, RoleIDs, DepartmentID, Online, Enable, Logins, LastLogin, LastLoginIP, RegisterTime, RegisterIP, Ex1, Ex2, Ex3, Ex4, Ex5, Ex6, UpdateUser, UpdateUserID, UpdateIP, UpdateTime, Remark) Values('大石頭', null, null, 0, null, null, null, null, 0, null, 0, 0, 1, 0, null, null, null, null, 0, 0, 0, null, null, null, null, 0, null, null, null);Select last_insert_rowid() newid
22:57:17.561  1 N - 用戶ID：2
22:57:17.574  1 N - Select * From User Where Name='大石頭' Order By ID Desc limit 1
22:57:17.601  1 N - Update User Set Logins=Logins+1, LastLogin='2019-02-25 22:57:17' Where ID=2
22:57:17.613  1 N - Select * From User Order By ID Desc
22:57:17.620  1 N - Delete From User Where ID=2
22:57:18.519  6 Y 199 檢查實體XCode.Membership.Log的數據表架構，模式：CheckTableWhenFirstUse
22:57:18.520  6 Y 199 創建數據庫：Log
22:57:18.521  6 Y 199 創建數據庫：D:\Test\ConsoleApp4\ConsoleApp4\bin\Debug\netcoreapp2.1\Log.db
22:57:18.532  6 Y 199 創建表：Log(日誌)
22:57:18.537  4 Y EQ 開始檢查連接[Log/SQLite]的數據庫架構……
22:57:18.555  4 Y EQ [Log]的所有實體類（3個）：Log,UserOnline,VisitStat
22:57:18.555  4 Y EQ [Log]需要檢查架構的實體類（2個）：UserOnline,VisitStat
22:57:18.558  4 Y EQ Log待檢查表架構的實體個數：2
22:57:18.559  4 Y EQ 創建表：UserOnline(用戶在線)
22:57:18.561  4 Y EQ 創建表：VisitStat(訪問統計)
22:57:18.564  4 Y EQ 檢查連接[Log/SQLite]的數據庫架構耗時24ms

這是前述代碼的完整執行日誌，這裏我們不做過多分析。

日誌大意是：自動配置SQLite數據庫，下載平臺要求的SQLite驅動，建庫建表，增刪改查

這裏特別需要關注的是這幾行：

22:57:17.548  1 N - Insert Into User(Name, Password, DisplayName, Sex, Mail, Mobile, Code, Avatar, RoleID, RoleIDs, DepartmentID, Online, Enable, Logins, LastLogin, LastLoginIP, RegisterTime, RegisterIP, Ex1, Ex2, Ex3, Ex4, Ex5, Ex6, UpdateUser, UpdateUserID, UpdateIP, UpdateTime, Remark) Values('大石頭', null, null, 0, null, null, null, null, 0, null, 0, 0, 1, 0, null, null, null, null, 0, 0, 0, null, null, null, null, 0, null, null, null);Select last_insert_rowid() newid
22:57:17.561  1 N - 用戶ID：2
22:57:17.574  1 N - Select * From User Where Name='大石頭' Order By ID Desc limit 1
22:57:17.601  1 N - Update User Set Logins=Logins+1, LastLogin='2019-02-25 22:57:17' Where ID=2
22:57:17.613  1 N - Select * From User Order By ID Desc
22:57:17.620  1 N - Delete From User Where ID=2

一句user.Insert，生成了一個Insert Into語句，並取得自增字段賦值給ID。

一個簡單的Find單字段查找，通過user2.Update更新了兩個字段，user3.Delete則刪除了這行數據。

這就是一個完整的增刪改查！

短短的一段代碼，也許帶給你許多疑問，這些疑問都將在後續文章中得到詳細解答：

UserX類來自哪裏？（XCode內置權限體系Membership）
爲何不需要配置數據庫？（無配置時默認使用SQLite）
下載了什麼東西？（SQLite驅動分爲.Net2.0/.Net4.0/.Net4.5等，還有.netstandard以及Linux版本之分，XCode根據平臺自動下載正確版本）
爲何會自動建表？（這是XCode最爲強大的反向工程，2008年開始支持，類似於EF後來的數據遷移）
自增ID。Insert後會即刻取回新插入的自增值
Logins=Logins+1。這叫做累加字段
UserX.FindByID爲何生成不帶where的Select查詢？（UserX.FindByID內部帶有實體緩存，並非簡單的Find(ID==2)）

系列教程

NewLife.XCode教程系列[2019版]

增刪改查入門。快速展現用法，代碼配置連接字符串
數據模型文件。建立表格字段和索引，名字以及數據類型規範，推薦字段（時間，用戶，IP）
實體類結構。數據類業務類，泛型基類，接口
功能設置。連接字符串，調試開關，SQL日誌，慢日誌，參數化，執行超時。代碼與配置文件設置，連接字符串局部設置
反向工程。自動建立數據庫數據表
數據初始化。InitData寫入初始化數據
高級增刪改。重載攔截，自增字段，Valid驗證，實體模型（時間，用戶，IP）
髒數據。如何產生，怎麼利用
增量累加。高併發統計
事務處理。單表和多表，不同連接，多種寫法
擴展屬性。多表關聯，Map映射
高級查詢。複雜條件，分頁，自定義擴展FieldItem，查總記錄數，查彙總統計
數據層緩存。Sql緩存，更新機制
實體緩存。全表整理緩存，更新機制
對象緩存。字典緩存，適用用戶等數據較多場景。
百億級性能。字段精煉，索引完備，合理查詢，充分利用緩存
實體工廠。元數據，通用處理程序
角色權限。Membership
導入導出。Xml，Json，二進制，網絡或文件
分表分庫。常見拆分邏輯
高級統計。聚合統計，分組統計
批量寫入。批量插入，批量Upsert，異步保存
實體隊列。寫入級緩存，提升性能。
備份同步。備份數據，恢復數據，同步數據
數據服務。提供RPC接口服務，遠程執行查詢，例如SQLite網絡版
大數據分析。ETL抽取，調度計算處理，結果持久化

End.

[NewLife.XCode]增刪改查入門

增刪改查入門

系列教程

如何在低代碼平臺中引用 JavaScript ？

探究職業發展的關鍵：能力模型解讀

高效率使用windows

如何使用 JavaScript 獲取當前頁面幀率 FPS

工程款拖欠，農民工怎麼了？就得一直忍着委屈求全嗎？

HarmonyOS 實現下拉刷新，上拉加載更多

語音信號處理中的“窗函數”

智能決策新時代：可視化大屏是否能夠超越傳統白板？

解密Prompt系列28. LLM Agent之金融領域摸索：FinMem & FinAgent

分享幾個.NET開源的AI和LLM相關項目框架

[NewLife.XCode]備份恢復與同步（數據搬運專家）

[NewLife.XCode]實體隊列（多線程生產的大數據集中保存）

[NewLife.XCode]批量添刪改操作（提升吞吐率）

[NewLife.Net]單機400萬長連接壓力測試

[NewLife.XCode]實體列表緩存（最土的方法實現百萬級性能）

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結