الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

فانارا

يحتوي هذا المشروع على مختلف مجموعات .NET التي تحتوي على وظائف P/استدعاء وواجهات وعدادات وهياكل من مكتبات Windows. يرتبط كل مجموعة بواحدة أو بضع مكتبات ذات صلة بإحكام. على سبيل المثال ، يحتوي 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 من تلك التصميم لأغراض الاختبار على مشروع Nuget Project الخاص بـ Appveyor على https://ci.appveyor.com/nuget/vanara-prelease.

يستخدم

  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.
    • (على سبيل المثال ، يستضيف Assembly Vanara.PInvoke.Gdi32.dll جميع الوظائف ودعم التعدادات والثوابت والهياكل التي يتم تصديرها من gdi32.dll في دليل النظام.)
  • يتم وضع أي بنية أو ماكرو أو تعداد (بدون وظيفة) تستخدمها العديد من المكتبات إما في Vanara.Core أو Vanara.PInvoke.Shared .
    • (على سبيل المثال ، يوجد Macro HIWORD SIZE الهيكل في Vanara.PInvoke.Shared والفصول لتبسيط المكالمات بين الطوائف وإدارة الذاكرة الأصلية في Vanara.Core .)
  • داخل المشروع ، يتم تضمين جميع الإنشاءات في ملف سمي على اسم ملف الرأس (*.H) الذي يتم تعريفه في واجهة برمجة تطبيقات Windows.
    • (على سبيل المثال في دليل مشروع Vanara.PInvoke.Kernel32 ، ستجد fileapi.cs ، وينبيز.
  • عندما يؤدي التفسير المباشر للهيكل أو الدالة إلى تسرب الذاكرة أو سوء الاستخدام ، فقد حاولت تبسيط استخدامه.
  • عندما يتم تمرير الهيكل دائمًا بالرجوع إليه وحيث يحتاج هذا الهيكل إلى تنظيف تخصيصات الذاكرة ، قمت بتغيير الهيكل إلى فئة تنفذ IDisposable .
  • كلما كان ذلك ممكنًا ، تم تحويل جميع المقابض إلى مشتقات SafeHandle التي تم تسميتها على اسم مقبض Windows API. إذا كانت هذه المقابض تتطلب دعوة إلى وظيفة لإغلاق/إغلاق/تدمير ، فإن هناك 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 ثم يتبعها اسم منطقي للوظائف. اليوم ، هذه هي الأساسية ، الأمان ، Systemservices ، Windows.forms و Windows.shell.

المكتبات المدعومة

مكتبة/DLL حَشد التغطية Nuget Link
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 ، normaliz.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.Accessable
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
portabledevicapi.dll ، portabledeviceConnectapi.dll ، portabledeviceTypes.dll vanara.pinvoke.portabledevicapi
POWRPROF.DLL vanara.pinvoke.powrprof
prossisedfslib.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
SESSORSAPI.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
الإصدار 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. الطباعة
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 Link وصف
vanara.bits استكمال .NET تغطية وظائف Windows BITS (خدمة النقل الذكي في الخلفية). يوفر الوصول إلى جميع وظائف المكتبة من خلال Windows 11 ويفشل برشاقة عندما لا تكون الميزات الجديدة متوفرة على إصدارات OS القديمة.
vanara.core تتضمن هذه المكتبة الطرق المشتركة والهياكل والثوابت للاستخدام في جميع أنحاء مجموعات Vanara. فكر في الأمر على أنه Windows.h مع بعض الامتدادات المفيدة. ويشمل:
  • طرق التمديد للعمل مع الأنواع المخصصة (enum) ، و filetime ، والطريقة واستخراج الممتلكات عن طريق الانعكاس
  • أساليب التمديد والمساعد لإلهام المصفوفات والسلاسل الهياكل
  • فصول قائمة على SafeHandle للعمل مع الذاكرة المخصصة عبر cotaskmem أو hglobal أو المكالمات المحلية التي تتولى التعبئة واستخراج المصفوفات والهياكل والذاكرة الخام
  • تثبيت آمن للكائنات في الذاكرة
  • دفق الذاكرة بناءً على الذاكرة
Vanara.DirectoryServices فئات التفاف حول طرق وواجهات الإعلانات Win32 لتوفير وصول مبسط وموجه إلى كائن إلى Active Directory ومكالمات خدمة الدليل الأخرى.
Vanara.Management الامتدادات وفصول المساعد للنظام. الإدارة.
vanara.net فئات مجردة حول وظائف الشبكات Win32 لتوفير وصول مبسط وموجه إلى الكائنات إلى إمكانات الشبكات الرئيسية مثل DNS ، DHCP ، التصفية ، الوصول ، والاكتشاف.
vanara.pinvoke.directx Pinvoke API (الأساليب والواجهات والهياكل والثوابت) المستوردة من DirectX.
vanara.pinvoke.shared الأساليب المشتركة والهياكل والثوابت للاستخدام في جميع أنحاء تجميعات vanara.pinvoke. يشمل:
  • مساعدون غير مقصمين لتعداد كوم
  • مارشالر مخصص لمؤشرات Cotaskmem
  • فئات نتائج الخطأ المحسنة لـ HRESULT و WIN32ERROR و NTSTATUS
  • وحدات ماكرو Windows.H القياسية (مثل HiWord ، Makelong ، إلخ)
  • غلاف طريقة متداخلة
  • حامل معرف الموارد
  • الهياكل المشتركة والعوالم (انظر ملاحظات الإصدار)
vanara.pinvoke.spellcheckingapi Pinvoke API (الأساليب والهياكل والثوابت) المستوردة من واجهة برمجة تطبيقات الإملائية Windows.
Vanara.Security فصول العناصر المتعلقة بالأمان المستمدة من مكتبات Vanara Pinvoke. يتضمن طرق التمديد لفئات Active Directory و Access Control ، وطرق العمل مع الحسابات ، و UAC ، والامتيازات ، والوصول إلى النظام ، والانتحال ، و SIDS ، وغلاف LSA كامل.
Vanara.Systemservices فصول للعناصر المتعلقة بالنظام المستمدة من مكتبات Vanara Pinvoke. يتضمن امتدادات للعملية (الامتيازات والإخلاص) ، FileInfo (معلومات الضغط) ، محركات وأجهزة الشبكة المشتركة ، و ServiceController (setStartType) التي تسحب المعلومات الموسعة من خلال مكالمات API الأصلية.
vanara.VirtualDisk .NET فئات لإدارة Windows Virtual Storage (VHD و VHDX) باستخدام وظائف P/Invoke من VirtDisk.dll.
Vanara.Windows.Extensions أساليب التمديد والتحويلات من أنواع وأساليب Vanara P/Invoke لأنواع وأساليب Windows.
vanara.windows.forms فئات لعناصر واجهة المستخدم المرتبطة المستمدة من مكتبات Vanara Pinvoke. يتضمن امتدادات لجميع عناصر التحكم المشتركة تقريبًا لإعطاء إمكانيات ما بعد Vista ، وعناصر التحكم في WinForms (لوحة ، ووصلة Command ، وصناديق التحرير والسرد المحسّنة ، و ipaddress ، وزر الانقسام ، وأدوات التحكم في Tracks و Omered) ، وإغلاق/إعادة تشغيل/قفل التحكم ، واللوحة المخزنة ، وملفات الموارد ، ومحرر التحكم في الوصول ، الإطار المصمم المبسط للنوافذ.
vanara.windows.shell.common الفصول الشائعة لعناصر Windows Shell المستمدة من مكتبات Vanara Pinvoke. يتضمن عناصر Shell والملفات والرموز والروابط وقوائم شريط المهام.
vanara.windows.shell فصول لعناصر Windows Shell المستمدة من مكتبات Vanara Pinvoke. يتضمن عناصر Shell والملفات والرموز والروابط وقوائم شريط المهام.
vanara.winui.Extensions طرق التمديد والتحويلات من أنواع وأساليب الاستدعاء Vanara P/Invoke لأنواع وطرق Winui.
vanara.wpf.extensions أساليب التمديد والتحويلات من أنواع وأساليب Vanara P/Invoke لأنواع وطرق WPF.

روابط سريعة

  • الوثائق
  • مشاكل

نموذج الرمز

هناك العديد من الأمثلة في مجلد Unittest وفي مشروع WinClassicsAmplescs الذي يعيد إنشاء عينات Windows في C# باستخدام Vanara.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل