IPAddressRange 类库技术文档

本文档将为您提供详细的 IPAddressRange 类库安装指南、使用说明以及 API 使用文档，帮助您更好地理解和应用该类库。

1. 安装指南

通过 NuGet 包管理器安装

您可以使用 NuGet 包管理器将 IPAddressRange 类库添加到您的项目中。在 Visual Studio 的包管理器控制台中运行以下命令：

Install-Package IPAddressRange -Version 6.1.0

或者在项目文件中添加以下引用：

<PackageReference Include="IPAddressRange" Version="6.1.0" />

手动安装

1. 下载 IPAddressRange 类库的 DLL 文件。
2. 将 DLL 文件添加到您的项目引用中。

2. 项目的使用说明

IPAddressRange 类库允许您解析 IP 地址范围字符串，例如 "192.168.0.0/24"、"192.168.0.0/255.255.255.0" 以及 "192.168.0.0-192.168.0.255"，并可以进行包含性检查。该类库同时支持 IPv4 和 IPv6。

以下是一些使用示例：

using NetTools;

// 解析 IP 地址范围
var rangeA = IPAddressRange.Parse("192.168.0.0/255.255.255.0");
Console.WriteLine(rangeA.Contains(IPAddress.Parse("192.168.0.34"))); // 输出 True
Console.WriteLine(rangeA.Contains(IPAddress.Parse("192.168.10.1"))); // 输出 False
Console.WriteLine(rangeA.ToCidrString()); // 输出 192.168.0.0/24

// 解析带短语的 IP 地址范围
var rangeB1 = IPAddressRange.Parse("192.168.0.10 - 192.168.10.20");
Console.WriteLine(rangeB1.Contains(IPAddress.Parse("192.168.3.45"))); // 输出 True
Console.WriteLine(rangeB1.Contains(IPAddress.Parse("192.168.0.9"))); // 输出 False

// 支持简写范围描述
var rangeB2 = IPAddressRange.Parse("192.168.10.10-20");

// 支持 CIDR 表达式和 IPv6
var rangeC = IPAddressRange.Parse("fe80::/10");
Console.WriteLine(rangeC.Contains(IPAddress.Parse("fe80::d503:4ee:3882:c586%3"))); // 输出 True
Console.WriteLine(rangeC.Contains(IPAddress.Parse("::1"))); // 输出 False

// "Contains()" 方法也支持 IPAddressRange 参数
var rangeD1 = IPAddressRange.Parse("192.168.0.0/16");
var rangeD2 = IPAddressRange.Parse("192.168.10.0/24");
Console.WriteLine(rangeD1.Contains(rangeD2)); // 输出 True

// 支持 IEnumerable<IPAddress>，它是懒加载
foreach (var ip in IPAddressRange.Parse("192.168.0.1/23"))
{
    Console.WriteLine(ip);
}

// 使用 LINQ 通过 "AsEnumerable()" 方法
var longValues = IPAddressRange.Parse("192.168.0.1/23")
    .AsEnumerable()
    .Select(ip => BitConvert.ToInt32(ip.GetAddressBytes(), 0))
    .Select(adr => adr.ToString("X8"));
Console.WriteLine(string.Join(",", longValues));

// 从 IPAddress 对象构造
var ipBegin = IPAddress.Parse("192.168.0.1");
var ipEnd = IPAddress.Parse("192.168.0.128");
var ipSubnet = IPAddress.Parse("255.255.255.0");

var rangeE = new IPAddressRange(); // 表示 "0.0.0.0/0"
var rangeF = new IPAddressRange(ipBegin, ipEnd);
var rangeG = new IPAddressRange(ipBegin, maskLength: 24);
var rangeH = new IPAddressRange(ipBegin, IPAddressRange.SubnetMaskLength(ipSubnet));

// 计算 CIDR 子网
var rangeI = IPAddressRange.Parse("192.168.0.0-192.168.0.254");
Console.WriteLine(rangeI.ToCidrString()); // 输出 192.168.0.0/24

3. 项目 API 使用文档

以下是一些主要的 API 方法：

• Parse(string ipRange): 解析 IP 地址范围字符串。
• Contains(IPAddress ip): 检查 IP 地址是否在范围内。
• ToCidrString(): 将 IP 地址范围转换为 CIDR 字符串。

更多 API 方法和详细信息，请参考项目源代码和文档。

4. 项目安装方式

如前所述，您可以通过 NuGet 包管理器或手动下载 DLL 文件的方式安装 IPAddressRange 类库。

请遵循上述指南和示例代码，以便顺利地在您的项目中使用 IPAddressRange 类库。如果您在安装或使用过程中遇到任何问题，请查阅项目文档或向维护者寻求帮助。