neo4j-driver-dotnet-skill

What problem does it solve?

It solves the problem of writing correct, production-ready Neo4j connection and query code in C#/.NET, especially when dealing with driver lifecycle, sessions/transactions, result streaming, and type-safe record mapping.

Core Features & Use Cases

• Driver lifecycle and safe disposal: Establishes a single thread-safe IDriver per application and uses await using for correct IAsyncDisposable behavior.
• Managed transactions for correctness and retry safety: Guides when to use ExecuteReadAsync/ExecuteWriteAsync versus explicit transactions, and how to keep managed callbacks idempotent.
• Result consumption and mapping: Explains Cursor handling (FetchAsync, ToListAsync, ConsumeAsync, SingleAsync) and robust record value access with .Get<T>()/.As<T>() including null and absent-key scenarios.
• Practical .NET integration patterns: Covers DI registration as a singleton, cancellation token propagation, UNWIND batching parameterization, and Preview object mapping with AsObject<T>/AsObjectsAsync<T>().
• Error handling and common traps: Provides an exception-handling approach (e.g., ClientException vs Neo4jException) and a checklist of frequent mistakes.

Quick Start

Use this skill to correctly implement Neo4j.Driver v6 in your C# service by registering IDriver as a singleton and running read/write operations with ExecuteReadAsync/ExecuteWriteAsync while consuming results inside the managed transaction callback.