IP2Region.Net

.NET client library for IP2Region

Installation

Install the package with NuGet

Install-Package IP2Region.Net

Usage

using IP2Region.Net.Abstractions;
using IP2Region.Net.XDB;

ISearcher searcher = new Searcher(CachePolicy , "your xdb file path");

Cache Policy Description

Cache Policy	Description	Thread Safe
CachePolicy.Content	Cache the entire `xdb` data.	Yes
CachePolicy.VectorIndex	Cache `vecotorIndex` to speed up queries and reduce system io pressure by reducing one fixed IO operation.	Yes
CachePolicy.File	Completely file-based queries	Yes

XDB File Description

Generate using maker, or download pre-generated xdb files

ASP.NET Core Usage

services.AddSingleton<ISearcher>(new Searcher(CachePolicy , "your xdb file path"));

Performance


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

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

Apache License 2.0

Showing the top 20 packages that depend on IP2Region.Net.

Packages	Downloads
ZhonTai.Admin 中台Admin权限管理接口库	55
ZhonTai.Admin 中台Admin权限管理接口库	77
ZhonTai.Admin 中台Admin权限管理接口库	107
ZhonTai.Admin.Core 中台Admin权限管理核心库	44
ZhonTai.Admin.Core 中台Admin权限管理核心库	49
ZhonTai.Admin.Core 中台Admin权限管理核心库	53
ZhonTai.Admin.Core 中台Admin权限管理核心库	60
ZhonTai.Admin.Core 中台Admin权限管理核心库	65
ZhonTai.Admin.Core 中台Admin权限管理核心库	66
ZhonTai.Admin.Core 中台Admin权限管理核心库	67
ZhonTai.Admin.Core 中台Admin权限管理核心库	71
ZhonTai.Admin.Core 中台Admin权限管理核心库	73
ZhonTai.Admin.Core 中台Admin权限管理核心库	76
ZhonTai.Admin.Core 中台Admin权限管理核心库	77
ZhonTai.Admin.Core 中台Admin权限管理核心库	80
ZhonTai.Admin.Core 中台Admin权限管理核心库	81
ZhonTai.Admin.Core 中台Admin权限管理核心库	84
ZhonTai.Admin.Core 中台Admin权限管理核心库	88
ZhonTai.Admin.Core 中台Admin权限管理核心库	91

Please refer to CHANGELOG.md for details

.NET 6.0

No dependencies.

.NET 7.0

No dependencies.

.NET Standard 2.0

System.Buffers (>= 4.5.1)
System.Memory (>= 4.5.5)

.NET Standard 2.1

No dependencies.

Version	Downloads	Last updated
3.0.0	49	12/03/2025
2.0.2	81	12/04/2024
2.0.1	65	12/09/2024
2.0.0	69	12/06/2024
1.0.10	74	12/09/2024
1.0.6	62	12/12/2024
1.0.5	92	12/12/2024
1.0.4	110	12/08/2024
1.0.3	82	12/13/2024
1.0.2	62	12/08/2024
1.0.1	68	12/08/2024
1.0.0	69	12/12/2024

IP2Region.Net 2.0.2

Readme