首页
/ IPAddressRange 类库技术文档

IPAddressRange 类库技术文档

2024-12-28 09:09:17作者:羿妍玫Ivan

本文档将为您提供详细的 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 类库。如果您在安装或使用过程中遇到任何问题,请查阅项目文档或向维护者寻求帮助。

热门项目推荐
相关项目推荐

项目优选

收起
Python-100-DaysPython-100-Days
Python - 100天从新手到大师
Python
643
120
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
9
19
arkanalyzerarkanalyzer
方舟分析器:面向ArkTS语言的静态程序分析框架
TypeScript
6
10
open-eBackupopen-eBackup
open-eBackup是一款开源备份软件,采用集群高扩展架构,通过应用备份通用框架、并行备份等技术,为主流数据库、虚拟化、文件系统、大数据等应用提供E2E的数据备份、恢复等能力,帮助用户实现关键数据高效保护。
HTML
90
65
Cangjie-ExamplesCangjie-Examples
本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。
Cangjie
205
61
RuoYi-Cloud-Vue3RuoYi-Cloud-Vue3
🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统
Vue
45
31
HarmonyOS-ExamplesHarmonyOS-Examples
本仓将收集和展示仓颉鸿蒙应用示例代码,欢迎大家投稿,在仓颉鸿蒙社区展现你的妙趣设计!
Cangjie
287
82
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
901
0
RuoYi-VueRuoYi-Vue
🎉 基于SpringBoot,Spring Security,JWT,Vue & Element 的前后端分离权限管理系统,同时提供了 Vue3 的版本
Java
182
44
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
60
49