首页>编程相关>其他源码
下载

瓦拉

该项目包含各种.NET组件，其中包含来自Windows库的P/Indoke功能，接口，枚举和结构。每个组件都与一个或几个紧密相关的库相关联。例如，shlwapi.dll具有shlwapi.lib的所有导出函数； kernel32.dll适用于kernel32.lib和kernelbase.lib。

所有组件均可通过Nuget获得，并提供针对.NET 4.5、4.8、5.0、6.0、7.0、8.0，.NET Standard 2.0，Core 3.1和Support Sourcelink的构建。扩展程序可用于Winforms，WPF和UWP项目。如果您需要支持其他.NET版本，请查看版本3.3.15和更早的版本。

该项目在经过充分测试后每隔几周就会发布新版本。在版本部分中将新版本以及发行说明进行了分类，所有Nuget软件包均已发布到Nuget.org。每个GitHub推动都会触发Appveyor构建。业主感谢他们提供的免费开源帐户！该构建的状态在此页面的标题中。这些构建的Nuget软件包可在Appveyor的Project Nuget源上可用于测试，网址为https://ci.appveyor.com/nuget/vanara-prerelease。

使用

  1. 在Microsoft文档中查找您需要的功能。注意该函数在哪个库或dll。
  2. 通过查看下面的受支持的库来确认存在Vanara库并具有您的功能。单击装配链接将带您进入该组件覆盖范围的钻探。查找您的功能，如果有匹配的实现，它将显示在右边。您还可以使用GitHub的项目搜索（页面左上）来搜索您的功能，方法或常数。确保选择“在此存储库中”。
  3. 通过Nuget将组件添加到您的项目中。
  4. 要使用该功能，您可以：
    1. 将其直接称为var bret = Vanara.PInvoke.Kernel32.GetComputerName(sb, ref sbSz);
    2. 在C＃6.0及以后的情况下，使用静态使用指令，并调用它： 
     using static Vanara.PInvoke.Kernel32;

var bret = GetComputerName(sb, ref sbSz);
  5. 在某些情况下，其中一个支持组件中有一个相应的助手/包装器类，尤其是用于安全，系统服务，表格和外壳。转到他们的库页面（单击部分中的链接），然后查看每个库中包含的类。

设计概念

  • 从单个DLL导入的所有函数都应将其放入以DLL命名的单个组件中。
    • （例如汇编Vanara.PInvoke.Gdi32.dll托管所有功能，并支持从系统目录中gdi32.dll导出的所有功能，常数和结构。）
  • 许多库使用的任何结构，宏观或枚举（无功能）都将其放入Vanara.Core Vanara.PInvoke.Shared 。
    • （例如，宏HIWORD和结构SIZE都在Vanara.PInvoke.Shared中，并且可以简化Interop调用，而本机内存管理则在Vanara.Core中。）
  • 在项目中，所有构造都包含在以标题文件（*.h）为名的文件中，其中在Windows API中定义了它们。
    • （例如，在Vanara.PInvoke.Kernel32项目目录中，您会发现一个fileapi.cs，winbase.cs和一个代表fileapi.h，winbase.h和winnt.h的winnt.cs文件。）
  • 如果直接解释结构或功能会导致内存泄漏或滥用，我试图简化其使用。
  • 在始终通过引用传递结构以及该结构需要清理内存分配的地方，我将结构更改为实现IDisposable类。
  • 在可能的情况下，所有手柄都将其变成以Windows API手柄命名的SafeHandle衍生物。如果这些手柄需要调用函数以释放/关闭/破坏，则存在执行该功能时执行该功能的派生SafeHANDLE 。
    • 例如，定义了HTOKEN 。 SafeHTOKEN通过自动释放拨打CloseHandle的构建。
  • 在可能的情况下，所有分配由呼叫者释放的内存的功能都使用安全的内存手柄。
  • 所有Pinvoke呼叫都在Vanara.PInvoke前缀的组件中。
  • 如果结构将作为常数传递到一个函数中，则使用in填写该结构，该结构将通过参考传递而无需ref关键字来通过结构。
    • Windows API： BOOL MapDialogRect(HWND hDlg, LPRECT lpRect)
    • Vanara： bool MapDialogRect(HWND hDlg, in RECT lpRect);
  • 如果有使用PINVOKE调用的类或扩展名，则它们位于Vanara前缀的包装组件中，然后在功能上逻辑名称。今天，这些是核心，安全性，系统服务，Windows.Forms和Windows.shell。

支持的库

库/DLL集会覆盖范围Nuget链接
aclui.dll vanara.pinvoke.aclui
Activeds.dll vanara.pinvoke.activeds
advapi32.dll，secur32.dll，authz.dll，sspicli.dll，schannel.dll，tdh.dll vanara.pinvoke.security
amsi.dll vanara.pinvoke.amsi
avicap32.dll，avifil32.dll，msacm32.dll，msvfw32.dll，winmm.dll vanara.pinvoke.Multimedia
avrt.dll vanara.pinvoke.avrt
机柜vanara.pinvoke.cabinet
cfgmgr32.dll VANARA.PINVOKE.CFGMGR32
cimfs.dll vanara.pinvoke.cimfs
cldapi.dll vanara.pinvoke.cldapi
clfsw32.dll VANARA.PINVOKE.CLFSW32
comctl32.dll vanara.pinvoke.comctl32
comdlg32.dll vanara.pinvoke.comdlg32
credui.dll vanara.pinvoke.credui
crypt32.dll，bcrypt.dll，ncrypt.dll，tokenbinding.dll，cryptui.dll，cryptnet.dll，cryptdlg.dll vanara.pinvoke.Cryptography
d2d1.dll vanara.pinvoke.direct2d
d3d11.dll，d3dcsx.dll，d3d11sdklayers.dll vanara.pinvoke.direct3d11
d3d12.dll vanara.pinvoke.direct3d12
d3dcompiler_47.dll vanara.pinvoke.d3dcompiler
davclnt.dll vanara.pinvoke.davclnt
dbghelp.dll，imageHlp.dll vanara.pinvoke.dbghelp
dhcpcsvc6.dll，dhcpcsvc.dll vanara.pinvoke.dhcp
dnsapi.dll vanara.pinvoke.dnsapi
dosvc.dll vanara.pinvoke.dosvc
drt.dll，drtprov.dll，drttransport.dll vanara.pinvoke.drt
dstorage.dll vanara.pinvoke.dstorage
dwmapi.dll vanara.pinvoke.dwmapi
dwrite.dll vanara.pinvoke.dwrite
dxcore.dll vanara.pinvoke.dxcore
dxgi.dll vanara.pinvoke.dxgi
ehstorapi.dll vanara.pinvoke.enhancedstorage
elscore.dll vanara.pinvoke.elscore
fhsvcctl.dll vanara.pinvoke.fhsvcctl
firewallapi.dll vanara.pinvoke.firewallapi
Fundisc.dll VANARA.PINVOKE.FUNDISC
fwpuclnt.dll vanara.pinvoke.fwpuclnt
gdi32.dll VANARA.PINVOKE.GDI32
httpapi.dll vanara.pinvoke.httpapi
imapi2.dll，imapi2fs.dll vanara.pinvoke.imapi
Imm32.dll vanara.pinvoke.imm32
iphlpapi.dll vanara.pinvoke.iphlpapi
iscsidsc.dll vanara.pinvoke.iscsidsc
kernel32.dll，kernelbase.dll，strumaniz.dll，vertdll.dll vanara.pinvoke.kernel32
ktmw32.dll VANARA.PINVOKE.KTMW32
lz32.dll VANARA.PINVOKE.LZ32
放大倍数Vanara.pinvoke.Magnification
mmdevapi.dll vanara.pinvoke.coreaudio
mpr.dll vanara.pinvoke.mpr
msctf.dll，input.dll，msimtf.dll vanara.pinvoke.textservicesframework
msftedit.dll，Riched20.dll vanara.pinvoke.msftedit
msi.dll vanara.pinvoke.msi
msrdc.dll vanara.pinvoke.msrdc
ndfapi.dll vanara.pinvoke.ndfapi
netapi32.dll vanara.pinvoke.netapi32
netprofm.dll vanara.pinvoke.netlistmgr
newdev.dll vanara.pinvoke.newdev
ntdll.dll vanara.pinvoke.ntdll
ntdsapi.dll vanara.pinvoke.ntdsapi
odbc32.dll VANARA.PINVOKE.ODBC32
ole32.dll，oleaut32.dll，propsys.dll vanara.pinvoke.ole
OLEACC.DLL vanara.pinvoke.Actible
oledb.dll vanara.pinvoke.oledb
oledlg.dll vanara.pinvoke.oledlg
opcservices.dll vanara.pinvoke.opc
p2p.dll vanara.pinvoke.p2p
pdh.dll vanara.pinvoke.pdh
peerdist.dll vanara.pinvoke.peerdist
Photoacq.dll vanara.pinvoke.photoAcquire
portabledeviceapi.dll，portabledeviceconnectapi.dll，portabledevicetypes.dll vanara.pinvoke.portabledeviceapi
powrprof.dll vanara.pinvoke.powrprof
Projectedfslib.dll vanara.pinvoke.projectedfslib
qmgr.dll vanara.pinvoke.bits
qwave.dll，traffic.dll vanara.pinvoke.qos
rpcrt4.dll vanara.pinvoke.rpc
rstrtmgr.dll VANARA.PINVOKE.RSTRTMGR
SEARCHAPI vanara.pinvoke.searchapi
Sensorsapi.dll vanara.pinvoke.sensorsapi
setupapi.dll vanara.pinvoke.setupapi
shcore.dll vanara.pinvoke.shcore
shell32.dll，url.dll vanara.pinvoke.shell32
shlwapi.dll vanara.pinvoke.shlwapi
taskschd.dll，mstask.dll vanara.pinvoke.taskschd
uianimation.dll vanara.pinvoke.uianimation
uiautomationcore.dll vanara.pinvoke.uiautomation
urlmon.dll vanara.pinvoke.urlmon
user32.dll vanara.pinvoke.user32
userenv.dll vanara.pinvoke.userenv
USP10.dll vanara.pinvoke.usp10
uxtheme.dll vanara.pinvoke.uxtheme
version.dll vanara.pinvoke.version
virtdisk.dll vanara.pinvoke.virtdisk
vssapi.dll vanara.pinvoke.vssapi
wcmapi.dll vanara.pinvoke.wcmapi
wcnapi.dll vanara.pinvoke.wcnapi
WebSocket.dll vanara.pinvoke.websocket
wer.dll vanara.pinvoke.wer
winbio.dll vanara.pinvoke.winbio
winhttp.dll vanara.pinvoke.winhttp
wininet.dll vanara.pinvoke.wininet
winscard.dll vanara.pinvoke.winscard
winspool.drv，prntvpt.dll vanara.pinvoke.printing
wintrust.dll vanara.pinvoke.wintrust
wlanapi.dll，wlanui.dll vanara.pinvoke.wlanapi
WS2_32.DLL VANARA.PINVOKE.WS2_32
wscapi.dll vanara.pinvoke.wscapi
wslapi.dll vanara.pinvoke.wslapi
wsmsvc.dll vanara.pinvoke.wsmsvc
wtsapi32.dll VANARA.PINVOKE.WTSAPI32
wuapi.dll vanara.pinvoke.wuapi

支持组件

集会Nuget链接描述
vanara.bits完整的.NET覆盖Windows位（背景智能传输服务）功能。通过Windows 11提供对所有库功能的访问权限，并在旧的OS版本上没有新功能时优雅地失败。
Vanara.Core该库包括整个Vanara组件中使用的共享方法，结构和常数。将其视为Windows.h，并具有一些有用的扩展。它包括：
  • 使用枚举类型（ENUM），Filetime以及方法和属性提取的扩展方法
  • 扩展和辅助方法，用于编制结构阵列和字符串
  • 基于安全汉语的类，用于通过CotaskMem，HGlobal分配的内存或处理包装和提取阵列，结构和原始内存的本地调用
  • 安全固定在内存中
  • 基于填充内存的内存流
Vanara.DirectoryServices WIN32 ADS方法和接口的包装类别可提供简化和面向对象的Active Directory和其他目录服务调用的访问。
VANARA。管理用于系统的扩展名和辅助课程。
vanara.net围绕WIN32网络功能的摘要类，以提供简化和面向对象的访问权限的关键网络功能，例如DNS，DHCP，过滤，访问和发现。
VANARA.PINVOKE.DIRECTX从DirectX导入的PINVOKE API（方法，接口，结构和常数）。
vanara.pinvoke.shared共享的方法，结构和常数在整个Vanara.pinvoke组件中使用。包括：
  • 枚举
  • CotaskMem指针的定制元帅
  • 增强了Hresult，Win32Error和NTSTATUS的错误结果类
  • 标准Windows.h宏（例如HiWord，Makelong等）
  • 重叠的方法包装器
  • 资源ID持有人
  • 共享结构和枚举（请参阅发行说明）
vanara.pinvoke.spellcheckingapi从Windows拼写检查API导入的PINVOKE API（方法，结构和常数）。
Vanara从Vanara Pinvoke库得出的安全性相关项目的类。包括用于Active Directory和Access Control类的扩展方法，使用帐户，UAC，特权，系统访问，模仿和SIDS的方法以及完整的LSA包装器。
Vanara.Systemservices来自Vanara Pinvoke库的系统相关项目的类。包括用于进程（特权和省略），FileInfo（压缩信息），共享网络驱动器和设备的扩展名，以及ServiceController（SetstartType），通过本机API调用来提取扩展信息。
VANARA.VIRTUALDISK .NET类，用于使用virtdisk.dll的p/Invoke函数管理Windows Virtual Storage（VHD和VHDX）。
vanara.windows.extensions扩展方法和从Vanara P/Invoke类型和方法到Windows表单类型和方法的转换。
vanara.windows.forms从Vanara Pinvoke库得出的用户界面相关项目的类。包括几乎所有通用控件的扩展，以提供后远景功能，Winforms控件（面板，命令链接，增强的组合盒，iPaddress，split Button，TrackBar和Themed控件），关闭/重新启动/锁定/锁定控制，缓冲绘画，资源文件，资源文件，访问控制编辑器，简化Windows.form.form.form.form.forms.forms.forms.forms.forms.forms.form.forms.forms.forms.forms.forms.forms.forms.forms.forms.forms.forms.forms.forms.forms。
vanara.windows.shell.common Windows Shell项目的常见类，这些类别来自Vanara Pinvoke库。包括外壳项目，文件，图标，链接和任务栏列表。
vanara.windows.shell从Vanara Pinvoke库中得出的Windows Shell项目的类。包括外壳项目，文件，图标，链接和任务栏列表。
vanara.winui.extensions扩展方法和从Vanara P/Invoke类型和方法转换为UWP和Winui类型和方法。
vanara.wpf.extensions扩展方法和从Vanara P/Invoke类型和方法到WPF类型和方法的转换。

快速链接

  • 文档
  • 问题

示例代码

Unittest文件夹和Winclassicsampless项目中有许多示例，这些示例使用Vanara在C＃中重新创建Windows样本。

展开
附加信息
相关应用
为您推荐
相关资讯 全部