From 1ad01ff98b8dbfade0aa5ad7d2e3d3d9c4239852 Mon Sep 17 00:00:00 2001 From: Argo Zhang Date: Sun, 19 Oct 2025 17:37:09 +0800 Subject: [PATCH] =?UTF-8?q?doc:=20=E6=9B=B4=E6=96=B0=20readme=20=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- binding/csharp/IP2Region.Net.slnx | 3 +++ binding/csharp/README.md | 27 ++++++++++++++++----------- 2 files changed, 19 insertions(+), 11 deletions(-) diff --git a/binding/csharp/IP2Region.Net.slnx b/binding/csharp/IP2Region.Net.slnx index a4663b7..559f5de 100644 --- a/binding/csharp/IP2Region.Net.slnx +++ b/binding/csharp/IP2Region.Net.slnx @@ -1,4 +1,7 @@ + + + diff --git a/binding/csharp/README.md b/binding/csharp/README.md index 8f8c78c..f203c57 100644 --- a/binding/csharp/README.md +++ b/binding/csharp/README.md @@ -30,28 +30,33 @@ Generate using [maker](https://github.com/lionsoul2014/ip2region/tree/master/mak ## ASP.NET Core Usage ```csharp -services.AddSingleton(new Searcher(CachePolicy , "your xdb file path")); +services.AddIP2RegionService("your xdb file path", cachePolicy: CachePolicy.Content); +``` + +NET6/7 +```csharp +provider.GetRequiredService() +``` + +NET8+ support keyed service +```csharp +provider.GetRequiredKeyedService("IP2Region.Net"); ``` ## Performance ``` ini - BenchmarkDotNet=v0.13.2, OS=macOS 13.4.1 (c) (22F770820d) [Darwin 22.5.0] Apple M1, 1 CPU, 8 logical and 8 physical cores .NET SDK=7.0.306 [Host] : .NET 6.0.20 (6.0.2023.32017), Arm64 RyuJIT AdvSIMD DefaultJob : .NET 6.0.20 (6.0.2023.32017), Arm64 RyuJIT AdvSIMD - - ``` -| Method | Mean | Error | StdDev | -|-------------------------|-----------:|---------:|---------:| -| CachePolicy_Content | 155.7 ns | 0.46 ns | 0.39 ns | -| CachePolicy_File | 2,186.8 ns | 34.27 ns | 32.06 ns | -| CachePolicy_VectorIndex | 1,570.3 ns | 27.53 ns | 22.99 ns | - - +| Method | Mean | Error | StdDev | +|------------------------ |-------------:|----------:|----------:| +| CachePolicy_Content | 58.32 ns | 0.182 ns | 0.170 ns | +| CachePolicy_File | 16,417.56 ns | 50.569 ns | 47.302 ns | +| CachePolicy_VectorIndex | 9,348.11 ns | 38.492 ns | 65.363 ns | ## Contributing Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.