本文使用的IDE是Visual Studio 2015 ，驅動程序是Neo4j官方的最新版本：Neo4j.Driver ，創建的類庫工程（Project）要求安裝 .NET Framework 4.5.2及以上版本，Neo4j官方提供的驅動程序使用起來非常簡單，非常依賴於Cypher語言，這使得該驅動程序能夠處理很多任務，但是，官方驅動程序僅支持標量類型的參數（Parameters），由於Neo4j的批量更新，例如，Cypher語言的foreach，unwind命令等用於批量操作，非常依賴於參數，這也成了官方驅動最大的缺點。
一，安裝Neo4j Driver
官方的.NET 驅動程序使用的是Blot協議，目前更新到1.72版本，依賴.NET Framework 4.5.2及以上版本
1，依賴.NET Framework 4.6版本
創建Neo4jApp工程，配置工程的熟悉，設置目標架構（Target Framework）為.NET Framework 4.6
2，安裝驅動程序
點擊工具（Tools）菜單，通過NuGet Package Manager的控制台命令安裝Neo4j的.NET驅動程序，選用1.3.0版本的原因是項目較趕，暫時沒有時間去學習最新的版本。
在C#中引用驅動程序的命名空間：
using Neo4j.Driver.V1;
二，驅動程序主要方法和對象
Neo4j驅動程序最核心的對象是：Driver對象，Session對象和Transaction對象。Driver對象用於連接數據庫，Session對象用於創建事務，事務對象用於執行Cypher查詢。事務只能在Read或Write模式下執行，由於Driver對象不會解析Cypher查詢，它也不會檢測到事務執行的是寫，還是讀操作，因此，當一個寫模式事務執行的是讀操作，Neo4j數據庫會拋出錯誤，執行失敗。
Note that the driver does not parse Cypher and cannot determine whether a transaction is intended to carry out read or write operations. As a result of this, a
writetransaction tagged forreadwill be sent to a read server, but will fail on execution.
1，連接數據庫
Neo4j通過Driver對象來連接圖形數據庫，在創建Driver對象時，需要服務器的連接地址（即bolt監聽地址，地址格式是"bolt://host:7687"）和身份驗證信息：user和password。
private readonly IDriver Driver; public Neo4jProviders(string uri, string user, string password) { Driver = GraphDatabase.Driver(uri, AuthTokens.Basic(user, password)); }
驗證信息通過auth token來提供，基礎驗證是AuthTokens.Basic(user,password)。
2，創建會話（Session）
在連接圖形數據庫之后，創建會話，會話是一系列事務（Transaction）的容器，用於創建事務執行的上下文，也就是說，事務必須在session的上下文中執行。Neo4j驅動程序提供三種格式的事務，最簡單的是自動提交事務模式，自動提交事務模式使用 Session對象的run()方法來實現。
示例代碼如下，在創建Session之后，以自動提交模式執行事務，在數據庫中創建一個節點，該節點具有標簽和屬性。
public void AddPerson(string name) { using (var session = Driver.Session()) { session.Run("CREATE (a:Person {name: $name})", new {name}); } }
在Neo4j的驅動程序中，發送到Neo4j數據庫引擎的Cypher查詢語句包含兩部分：Query和Parameters，其中，Query是在數據庫中執行的Cypher語句，Parameters是傳遞引擎的參數，在Query中以$para_name格式來引用參數，在Parameters中，參數的名詞和$para_name中的para_name保持一致。
自動提交事務只包含一個Cypher語句，這意味着多個事務不能共享網絡數據包，從而表現出比其他形式的事務更低的網絡效率。自動提交事務旨在用於簡單的用例，例如學習Cypher或編寫一次性腳本時。 建議不要在生產環境中使用自動提交事務，或者在性能或彈性是主要問題時使用。
3，創建事務函數
事務函數是推薦的創建事務的方式，這種形式能夠以最小的查詢代碼實現多個多個查詢的輸入，能夠分離數據庫查詢和應用程序邏輯。
在Neo4j的事務中，讀寫操作都必須處於事務的上下文中。在Session對象中，當事務以自動提交模式執行（通過session.Run()函數調用）時，事務只包含一個Cypher語句，但是，這種模式有一個缺點，當Cypher語句執行失敗時，事務不能重新執行（Replay）。Neo4j推薦使用事務函數模式，通過Session對象調用WriteTransaction()或 ReadTransaction()函數，並在事務函數包含事務單元，在事務執行失敗時，能夠在異常處理代碼中重新執行Cypher語句。
public void AddPerson(string name) { using (var session = Driver.Session()) { session.WriteTransaction(tx => tx.Run("CREATE (a:Person {name: $name})", new {name})); } }
三，參數化查詢
Cypher支持參數化查詢，在Cypher語句中，使用參數替代表達式，實體的ID，參數不能用於關系類型和標簽。在Neo4j數據庫中，參數能夠優化查詢，使得Cypher的執行計划更容易被緩存，查詢更快速。在Cypher中，通過$param引用參數。
1，使用參數創建節點
在執行事務之后，Session返回數據庫執行的結果，通過result.Summary查看Cypher語句執行的結果。
public bool CreateSingleNode(string lable,string name) { string query = string.Format("CREATE (n:{0} ", lable)+ @"{name: $name})"; using (var session = Driver.Session(AccessMode.Write)) { var result = session.WriteTransaction(tx=>tx.Run(query, new { name })); IResultSummary rs = result.Summary; return rs.Counters.NodesCreated == 1; } }
2，使用參數創建關系
通過new創建匿名類型，參數名是匿名類型的字段，字段名必須和Cypher語句中的參數($para)保持一致。
public bool CreateRelationship(string RelationshipType,string SourceNodeName,string TargetNodeName) { string query = string.Format(@"match (n),(m) where n.name=$source and m.name=$target create (n)-[:{0}]->(m);",RelationshipType); using (var session = Driver.Session()) { var result = session.WriteTransaction(tx => tx.Run(query,new {source=SourceNodeName,target= TargetNodeName } )); IResultSummary rs = result.Summary; return rs.Counters.RelationshipsCreated == 1; } }
四，查詢數據庫
向Neo4j數據庫發送請求，返回的是數據結構是一個表格，Title是return子句的投影的字段。
如示例圖所示，查詢返回的結構是表格（行-列）式的，列值主要分為兩種，要么是節點的屬性列表，以JSON結構顯示，要么是標量值。
驅動程序的Session返回查詢的結果，Keys字段是Cypher語句中return子句投影的字段列表；Values字段返回是查詢結果。
public void MatchNodes(string lable, string name) { string query = string.Format(@"MATCH (n:{0} ", lable)+ @"{name: $name})-[r]->(m) RETURN n,id(n);"; using (var session = Driver.Session(AccessMode.Read)) { var result = session.ReadTransaction(rx => rx.Run(query, new { name })); //return 子句投影的字段列表 IReadOnlyList<string> keys = result.Keys; //查詢返回的數據行 var rows = result.ToList(); foreach(var row in rows) { //每個數據行都包含多個數據列 var columns = row.Values; foreach (var column in columns) { //每個數據列，可能是一個節點，也可能是一個標量值 if(column.Key=="n") { var node = column.Value as INode; long NodeID = node.Id; string NodeLables = string.Join(",", node.Labels.ToArray()); foreach (var property in node.Properties) { string Property=string.Format("Property[Key:{0},Value:{1}", property.Key, property.Value); } } if(column.Key=="id(n)") { long NodeID=long.Parse(column.Value.ToString()); } } } } }
五，Cypher和.NET的類型映射
驅動程序把編程語言翻譯成Cypher的類型系統，為了處理數據，需要了解編程語言的類型和Cypher的類型系統的映射。圖的特有類型是：Node、Relationship和Path，基礎類型：Boolean、Integer、Float、String、List、Map，對.NET的類型映射是：
語句執行的結果是由記錄流（record stream）構成，結果通常由接收應用程序在到達時處理。一個記錄是一個由Key/Value對構成的有序字典（Map），記錄可以通過位置索引（0-based整數）和鍵（key，字符串）來訪問。
例如，通過位置索引來選擇記錄：
public List<string> GetPeople() { using (var session = Driver.Session()) { //return session.ReadTransaction(tx => tx.Run("MATCH (a:Person) RETURN a.name AS name").ToList()); return session.ReadTransaction(tx => { var result = tx.Run("MATCH (a:Person) RETURN a.name ORDER BY a.name"); return result.Select(record => record[0].As<string>()).ToList(); }); } }
參考文檔：