From 75d944eaf774184bf385ca84fa604299f26b2863 Mon Sep 17 00:00:00 2001
From: Argo Zhang <argo@live.ca>
Date: Fri, 21 Nov 2025 08:52:17 +0800
Subject: [PATCH] =?UTF-8?q?doc:=20=E5=A2=9E=E5=8A=A0=E7=B1=BB=E6=B3=A8?=
 =?UTF-8?q?=E9=87=8A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../IP2Region.Net/Abstractions/ISearcher.cs   | 20 ++++++++++++++++++-
 binding/csharp/IP2Region.Net/XDB/Util.cs      |  2 +-
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/binding/csharp/IP2Region.Net/Abstractions/ISearcher.cs b/binding/csharp/IP2Region.Net/Abstractions/ISearcher.cs
index ffd64b9..d270e4e 100644
--- a/binding/csharp/IP2Region.Net/Abstractions/ISearcher.cs
+++ b/binding/csharp/IP2Region.Net/Abstractions/ISearcher.cs
@@ -8,13 +8,31 @@ using System.Net;
 
 namespace IP2Region.Net.Abstractions;
 
+/// <summary>
+/// IP 转化为地理位置搜索器接口
+/// </summary>
 public interface ISearcher
 {
+    /// <summary>
+    /// 搜索方法
+    /// </summary>
+    /// <param name="ipStr">IP 地址字符串 如 192.168.0.1</param>
+    /// <returns></returns>
     string? Search(string ipStr);
 
+    /// <summary>
+    /// 搜索方法
+    /// </summary>
     string? Search(IPAddress ipAddress);
 
+    /// <summary>
+    /// 搜索方法 仅限 IPv4 使用
+    /// </summary>
+    /// <param name="ipAddress">IPv4 地址字节数组小端读取 uint 数值</param>
     string? Search(uint ipAddress);
 
+    /// <summary>
+    /// 获得 内部 IO 访问次数
+    /// </summary>
     int IoCount { get; }
-}
\ No newline at end of file
+}
diff --git a/binding/csharp/IP2Region.Net/XDB/Util.cs b/binding/csharp/IP2Region.Net/XDB/Util.cs
index d92a613..b151df2 100644
--- a/binding/csharp/IP2Region.Net/XDB/Util.cs
+++ b/binding/csharp/IP2Region.Net/XDB/Util.cs
@@ -73,4 +73,4 @@ public static class Util
 
         return ret;
     }
-}
\ No newline at end of file
+}