ModBase.vb 123 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573
  1. Imports System.IO.Compression
  2. Imports System.Management
  3. Imports System.Security.Cryptography
  4. Imports System.Security.Principal
  5. Imports System.Windows.Markup
  6. Imports Newtonsoft.Json
  7. Public Module ModBase
  8. #Region "声明"
  9. '下列版本信息由更新器自动修改
  10. Public Const VersionBaseName As String = "2.4.3" '不含分支前缀的显示用版本名
  11. Public Const VersionStandardCode As String = "2.4.3." & VersionBranchCode '标准格式的四段式版本号
  12. #If BETA Then
  13. Public Const VersionCode As Integer = 270 'Release
  14. #Else
  15. Public Const VersionCode As Integer = 271 'Snapshot
  16. #End If
  17. '自动生成的版本信息
  18. Public Const VersionDisplayName As String = VersionBranchName & " " & VersionBaseName
  19. #If RELEASE Then
  20. Public Const VersionBranchName As String = "Snapshot"
  21. Public Const VersionBranchCode As String = "0"
  22. #ElseIf BETA Then
  23. Public Const VersionBranchName As String = "Release"
  24. Public Const VersionBranchCode As String = "50"
  25. #ElseIf DEBUG Then
  26. Public Const VersionBranchName As String = "Debug"
  27. Public Const VersionBranchCode As String = "100"
  28. #End If
  29. ''' <summary>
  30. ''' 主窗口句柄。
  31. ''' </summary>
  32. Public Handle As IntPtr
  33. ''' <summary>
  34. ''' 程序的启动路径,以“\”结尾。
  35. ''' </summary>
  36. Public Path As String = AppDomain.CurrentDomain.SetupInformation.ApplicationBase
  37. ''' <summary>
  38. ''' 包含程序名的完整路径。
  39. ''' </summary>
  40. Public PathWithName As String = Path & AppDomain.CurrentDomain.SetupInformation.ApplicationName
  41. ''' <summary>
  42. ''' 程序内嵌图片文件夹路径,以“/”结尾。
  43. ''' </summary>
  44. Public PathImage As String = "pack://application:,,,/images/"
  45. ''' <summary>
  46. ''' 当前程序的语言。
  47. ''' </summary>
  48. Public Lang As String = "zh_CN"
  49. ''' <summary>
  50. ''' 设置对象。
  51. ''' </summary>
  52. Public Setup As New ModSetup
  53. ''' <summary>
  54. ''' 程序的打开计时。
  55. ''' </summary>
  56. Public ApplicationStartTick As Long
  57. ''' <summary>
  58. ''' 程序打开时的时间。
  59. ''' </summary>
  60. Public ApplicationOpenTime As Date = Date.Now
  61. ''' <summary>
  62. ''' 设备唯一标识符。
  63. ''' </summary>
  64. Public UniqueAddress As String = SecretGetUniqueAddress()
  65. ''' <summary>
  66. ''' 程序是否已结束。
  67. ''' </summary>
  68. Public IsProgramEnded As Boolean = False
  69. ''' <summary>
  70. ''' 是否为 32 位系统。
  71. ''' </summary>
  72. Public Is32BitSystem As Boolean = Not Environment.Is64BitOperatingSystem
  73. ''' <summary>
  74. ''' 操作系统版本。Win10 为 10.0。
  75. ''' </summary>
  76. Public OsVersion As Version = Environment.OSVersion.Version
  77. ''' <summary>
  78. ''' 程序的缓存文件夹路径,以“\”结尾。
  79. ''' </summary>
  80. Public PathTemp As String = If(Setup.Get("SystemSystemCache") = "", IO.Path.GetTempPath() & "PCL\", Setup.Get("SystemSystemCache")).ToString.Replace("/", "\").TrimEnd("\") & "\"
  81. ''' <summary>
  82. ''' AppData 中的 PCL 文件夹路径,以“\”结尾。
  83. ''' </summary>
  84. Public PathAppdata As String = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData) & "\PCL\"
  85. #End Region
  86. #Region "矢量图标"
  87. Public Class Logo
  88. ''' <summary>
  89. ''' 图标按钮,心(空心),1.1x
  90. ''' </summary>
  91. Public Const IconButtonLikeLine As String = "M512 896a42.666667 42.666667 0 0 1-30.293333-12.373333l-331.52-331.946667a224.426667 224.426667 0 0 1 0-315.733333 223.573333 223.573333 0 0 1 315.733333 0L512 282.026667l46.08-46.08a223.573333 223.573333 0 0 1 315.733333 0 224.426667 224.426667 0 0 1 0 315.733333l-331.52 331.946667A42.666667 42.666667 0 0 1 512 896zM308.053333 256a136.533333 136.533333 0 0 0-97.28 40.106667 138.24 138.24 0 0 0 0 194.986666L512 792.746667l301.226667-301.653334a138.24 138.24 0 0 0 0-194.986666 141.653333 141.653333 0 0 0-194.56 0l-76.373334 76.8a42.666667 42.666667 0 0 1-60.586666 0L405.333333 296.106667A136.533333 136.533333 0 0 0 308.053333 256z"
  92. ''' <summary>
  93. ''' 图标按钮,心(实心),1.1x
  94. ''' </summary>
  95. Public Const IconButtonLikeFill As String = "M700.856 155.543c-74.769 0-144.295 72.696-190.046 127.26-45.737-54.576-115.247-127.26-190.056-127.26-134.79 0-244.443 105.78-244.443 235.799 0 77.57 39.278 131.988 70.845 175.713C238.908 694.053 469.62 852.094 479.39 858.757c9.41 6.414 20.424 9.629 31.401 9.629 11.006 0 21.998-3.215 31.398-9.63 9.782-6.662 240.514-164.703 332.238-291.701 31.587-43.724 70.874-98.143 70.874-175.713-0.001-130.02-109.656-235.8-244.445-235.8z m0 0"
  96. ''' <summary>
  97. ''' 图标按钮,垃圾桶,1.1x
  98. ''' </summary>
  99. Public Const IconButtonDelete As String = "M520.192 0C408.43 0 317.44 82.87 313.563 186.734H52.736c-29.038 0-52.663 21.943-52.663 49.079s23.625 49.152 52.663 49.152h58.075v550.473c0 103.35 75.118 187.757 167.717 187.757h472.43c92.599 0 167.716-83.894 167.716-187.757V285.477h52.59c29.038 0 52.59-21.943 52.663-49.08-0.073-27.135-23.625-49.151-52.663-49.151H726.235C723.237 83.017 631.955 0 520.192 0zM404.846 177.957c3.803-50.03 50.176-89.015 107.447-89.015 57.197 0 103.57 38.985 106.788 89.015H404.92zM284.379 933.669c-33.353 0-69.997-39.351-69.997-95.525v-549.01H833.39v549.522c0 56.247-36.645 95.525-69.998 95.525H284.379v-0.512z M357.23 800.695a48.274 48.274 0 0 0 47.616-49.006V471.7a48.274 48.274 0 0 0-47.543-49.08 48.274 48.274 0 0 0-47.69 49.006V751.69c0 27.282 20.846 49.006 47.617 49.006z m166.62 0a48.274 48.274 0 0 0 47.688-49.006V471.7a48.274 48.274 0 0 0-47.689-49.08 48.274 48.274 0 0 0-47.543 49.006V751.69c0 27.282 21.431 49.006 47.543 49.006z m142.92 0a48.274 48.274 0 0 0 47.543-49.006V471.7a48.274 48.274 0 0 0-47.543-49.08 48.274 48.274 0 0 0-47.616 49.006V751.69c0 27.282 20.773 49.006 47.543 49.006z"
  100. ''' <summary>
  101. ''' 图标按钮,笔,1x
  102. ''' </summary>
  103. Public Const IconButtonEdit As String = "M732.64 64.32C688.576 21.216 613.696 21.216 569.6 64.32L120.128 499.52c-17.6 12.896-26.432 30.144-30.848 51.68L32 870.048c0 25.856 8.8 56 26.432 73.248 17.632 17.216 17.632 48.704 88.64 48.704h13.248l326.08-56c22.016-4.32 39.68-12.928 52.864-30.176l449.472-435.2c22.048-21.536 35.264-47.36 35.264-77.536 0-30.176-13.216-56-35.264-77.568l-256.096-251.2zM139.712 903.776l56-326.912 311.04-295.136 267.104 269.44-310.976 295.168-323.168 57.44zM844.576 467.84l-273.984-260.672 61.856-59.84c8.832-8.512 26.528-8.512 39.776 0l234.24 226.496c4.384 4.288 8.832 12.8 8.832 17.088s-4.416 8.544-8.864 12.8l-61.856 64.128z"
  104. ''' <summary>
  105. ''' 图标按钮,齿轮,1.1x
  106. ''' </summary>
  107. Public Const IconButtonSetup As String = "M651.946667 1001.813333c-22.186667 0-42.666667-10.24-61.44-27.306666-23.893333-23.893333-49.493333-35.84-75.093334-35.84-29.013333 0-56.32 11.946667-73.386666 30.72v3.413333c-17.066667 17.066667-42.666667 27.306667-66.56 27.306667h-6.826667c-6.826667 0-11.946667-1.706667-15.36-1.706667l-6.826667-1.706667c-64.853333-20.48-121.173333-54.613333-168.96-98.986666-29.013333-23.893333-37.546667-63.146667-25.6-95.573334 8.533333-23.893333 5.12-51.2-10.24-75.093333-15.36-27.306667-34.133333-40.96-59.733333-47.786667h-1.706667l-5.12-1.706666c-35.84-8.533333-61.44-34.133333-66.56-69.973334C1.706667 575.146667 0 537.6 0 512c0-32.426667 3.413333-63.146667 8.533333-93.866667v-6.826666l3.413334-8.533334c10.24-23.893333 23.893333-40.96 44.373333-51.2 5.12-3.413333 11.946667-6.826667 20.48-8.533333 27.306667-8.533333 51.2-25.6 63.146667-44.373333 13.653333-23.893333 17.066667-52.906667 10.24-81.92-11.946667-34.133333 0-71.68 30.72-93.866667 44.373333-37.546667 97.28-68.266667 158.72-93.866667l3.413333-1.706666c44.373333-13.653333 75.093333 3.413333 92.16 20.48 23.893333 23.893333 49.493333 35.84 75.093333 35.84 30.72 0 56.32-10.24 71.68-30.72l3.413334-3.413334c27.306667-27.306667 63.146667-35.84 93.866666-22.186666 63.146667 22.186667 117.76 54.613333 165.546667 97.28 29.013333 23.893333 37.546667 63.146667 25.6 95.573333-8.533333 23.893333-5.12 51.2 10.24 75.093333 15.36 27.306667 34.133333 40.96 59.733333 47.786667h1.706667l5.12 1.706667c35.84 8.533333 61.44 34.133333 66.56 71.68 6.826667 30.72 10.24 63.146667 11.946667 93.866666v3.413334c0 32.426667-3.413333 63.146667-8.533334 93.866666v6.826667l-3.413333 8.533333c-10.24 23.893333-23.893333 40.96-44.373333 51.2-5.12 3.413333-11.946667 6.826667-20.48 8.533334-27.306667 8.533333-51.2 25.6-63.146667 46.08-13.653333 23.893333-17.066667 52.906667-10.24 81.92 11.946667 35.84-1.706667 75.093333-30.72 95.573333-44.373333 35.84-95.573333 66.56-157.013333 92.16-15.36 3.413333-27.306667 3.413333-35.84 3.413333z m3.413333-83.626666z m1.706667 0zM517.12 853.333333c47.786667 0 93.866667 20.48 134.826667 59.733334 1.706667 1.706667 3.413333 1.706667 3.413333 3.413333 52.906667-22.186667 97.28-49.493333 136.533333-80.213333l1.706667-1.706667v-3.413333c-13.653333-52.906667-8.533333-104.106667 17.066667-148.48 23.893333-39.253333 64.853333-69.973333 114.346666-85.333334 1.706667 0 3.413333-1.706667 6.826667-6.826666 5.12-25.6 8.533333-51.2 8.533333-78.506667-1.706667-29.013333-3.413333-56.32-10.24-81.92v-5.12h-1.706666c-51.2-11.946667-90.453333-39.253333-119.466667-87.04-27.306667-44.373333-34.133333-100.693333-17.066667-148.48l-1.706666-1.706667h-3.413334c-39.253333-35.84-85.333333-63.146667-136.533333-80.213333H648.533333s-1.706667 1.706667-3.413333 1.706667c-32.426667 39.253333-80.213333 59.733333-136.533333 59.733333-47.786667 0-93.866667-20.48-134.826667-59.733333l-1.706667-1.706667h-1.706666c-54.613333 22.186667-98.986667 49.493333-136.533334 80.213333l-1.706666 1.706667v3.413333c13.653333 52.906667 8.533333 104.106667-17.066667 148.48-23.893333 39.253333-64.853333 69.973333-114.346667 85.333334-1.706667 0-3.413333 1.706667-6.826666 6.826666-6.826667 25.6-8.533333 51.2-8.533334 78.506667 0 30.72 3.413333 58.026667 6.826667 76.8l1.706667 5.12h1.706666c51.2 11.946667 90.453333 39.253333 119.466667 87.04 27.306667 44.373333 34.133333 100.693333 17.066667 148.48l1.706666 1.706667 1.706667 1.706666c37.546667 35.84 83.626667 63.146667 134.826667 80.213334 1.706667 0 3.413333 0 3.413333 1.706666h1.706667s1.706667 0 5.12-1.706666c34.133333-37.546667 81.92-59.733333 136.533333-59.733334z m-6.826667-146.773333c-110.933333 0-199.68-85.333333-199.68-196.266667 0-109.226667 87.04-196.266667 199.68-196.266666s199.68 85.333333 199.68 196.266666c-1.706667 109.226667-88.746667 196.266667-199.68 196.266667z m0-307.2c-63.146667 0-114.346667 49.493333-114.346666 110.933333 0 63.146667 49.493333 110.933333 114.346666 110.933334 30.72 0 59.733333-11.946667 80.213334-32.426667 20.48-20.48 32.426667-49.493333 32.426666-78.506667 0-63.146667-49.493333-110.933333-112.64-110.933333z"
  108. ''' <summary>
  109. ''' 图标按钮,重置,0.9x
  110. ''' </summary>
  111. Public Const IconButtonReset As String = "M667.6817627 313.65283203l-45.28564454 55.76660156L858.06933594 391.27124023 787.61950684 165.93066406l-56.01379395 69.01611328A354.47387695 354.47387695 0 0 0 520.89892578 165.93066406C324.87536621 165.93066406 165.93066406 324.43041992 165.93066406 519.91015625c0 195.52917481 158.94470215 353.97949219 354.96826172 353.97949219a355.06713867 355.06713867 0 0 0 331.73217774-227.66418458 50.52612305 50.52612305 0 0 0-29.21813966-65.25878905 50.77331543 50.77331543 0 0 0-65.50598144 29.16870117A253.61938477 253.61938477 0 0 1 520.94836426 772.78796387c-140.05920411 0-253.61938477-113.21411133-253.61938477-252.87780762 0-139.61425781 113.56018067-252.82836914 253.61938477-252.82836914 53.59130859 0 104.46350098 16.61132813 146.73339843 46.57104492"
  112. ''' <summary>
  113. ''' 图标按钮,刷新,0.85x
  114. ''' </summary>
  115. Public Const IconButtonRefresh As String = "M875.52 148.48C783.36 56.32 655.36 0 512 0 291.84 0 107.52 138.24 30.72 332.8l122.88 46.08C204.8 230.4 348.16 128 512 128c107.52 0 199.68 40.96 271.36 112.64L640 384h384V0L875.52 148.48zM512 896c-107.52 0-199.68-40.96-271.36-112.64L384 640H0v384l148.48-148.48C240.64 967.68 368.64 1024 512 1024c220.16 0 404.48-138.24 481.28-332.8L870.4 645.12C819.2 793.6 675.84 896 512 896z"
  116. ''' <summary>
  117. ''' 图标按钮,软盘,1x
  118. ''' </summary>
  119. Public Const IconButtonSave As String = "M819.392 0L1024 202.752v652.16a168.96 168.96 0 0 1-168.832 168.768h-104.192a47.296 47.296 0 0 1-10.752 0H283.776a47.232 47.232 0 0 1-10.752 0H168.832A168.96 168.96 0 0 1 0 854.912V168.768A168.96 168.96 0 0 1 168.832 0h650.56z m110.208 854.912V242.112l-149.12-147.776H168.896c-41.088 0-74.432 33.408-74.432 74.432v686.144c0 41.024 33.344 74.432 74.432 74.432h62.4v-190.528c0-33.408 27.136-60.544 60.544-60.544h440.448c33.408 0 60.544 27.136 60.544 60.544v190.528h62.4c41.088 0 74.432-33.408 74.432-74.432z m-604.032 74.432h372.864v-156.736H325.568v156.736z m403.52-596.48a47.168 47.168 0 1 1 0 94.336H287.872a47.168 47.168 0 1 1 0-94.336h441.216z m0-153.728a47.168 47.168 0 1 1 0 94.4H287.872a47.168 47.168 0 1 1 0-94.4h441.216z"
  120. ''' <summary>
  121. ''' 图标按钮,信息,1.05x
  122. ''' </summary>
  123. Public Const IconButtonInfo As String = "M512 917.333333c223.861333 0 405.333333-181.472 405.333333-405.333333S735.861333 106.666667 512 106.666667 106.666667 288.138667 106.666667 512s181.472 405.333333 405.333333 405.333333z m0 106.666667C229.226667 1024 0 794.773333 0 512S229.226667 0 512 0s512 229.226667 512 512-229.226667 512-512 512z m-32-597.333333h64a21.333333 21.333333 0 0 1 21.333333 21.333333v320a21.333333 21.333333 0 0 1-21.333333 21.333333h-64a21.333333 21.333333 0 0 1-21.333333-21.333333V448a21.333333 21.333333 0 0 1 21.333333-21.333333z m0-192h64a21.333333 21.333333 0 0 1 21.333333 21.333333v64a21.333333 21.333333 0 0 1-21.333333 21.333333h-64a21.333333 21.333333 0 0 1-21.333333-21.333333v-64a21.333333 21.333333 0 0 1 21.333333-21.333333z"
  124. ''' <summary>
  125. ''' 图标按钮,列表,1x
  126. ''' </summary>
  127. Public Const IconButtonList As String = "M384 128h640v128H384zM160 192m-96 0a96 96 0 1 0 192 0 96 96 0 1 0-192 0ZM384 448h640v128H384zM160 512m-96 0a96 96 0 1 0 192 0 96 96 0 1 0-192 0ZM384 768h640v128H384zM160 832m-96 0a96 96 0 1 0 192 0 96 96 0 1 0-192 0Z"
  128. ''' <summary>
  129. ''' 图标按钮,文件夹,1.15x
  130. ''' </summary>
  131. Public Const IconButtonOpen As String = "M889.018182 418.909091H884.363636V316.509091a93.090909 93.090909 0 0 0-99.607272-89.832727h-302.545455l-93.090909-76.334546A46.545455 46.545455 0 0 0 358.865455 139.636364H146.152727A93.090909 93.090909 0 0 0 46.545455 229.469091V837.818182a46.545455 46.545455 0 0 0 46.545454 46.545454 46.545455 46.545455 0 0 0 16.756364-3.258181 109.381818 109.381818 0 0 0 25.134545 3.258181h586.472727a85.178182 85.178182 0 0 0 87.04-63.301818l163.374546-302.545454a46.545455 46.545455 0 0 0 5.585454-21.876364A82.385455 82.385455 0 0 0 889.018182 418.909091z m-744.727273-186.181818h198.283636l93.09091 76.334545a46.545455 46.545455 0 0 0 29.323636 10.705455h319.301818a12.101818 12.101818 0 0 1 6.516364 0V418.909091H302.545455a85.178182 85.178182 0 0 0-87.04 63.301818L139.636364 622.778182V232.727273a19.549091 19.549091 0 0 1 6.516363 0z m578.094546 552.029091a27.461818 27.461818 0 0 0-2.792728 6.516363H154.530909l147.083636-272.290909a27.461818 27.461818 0 0 0 2.792728-6.981818h565.061818z"
  132. ''' <summary>
  133. ''' 图标按钮,名片,1.1x
  134. ''' </summary>
  135. Public Const IconButtonCard As String = "M834.5 684.1c-31.2-70.4-98.9-120.9-179.1-127.3 63.5-8.5 112.6-63 112.6-128.8 0-71.8-58.2-130-130-130s-130 58.2-130 130c0 65.9 49 120.3 112.6 128.8-80.2 6.4-148 57-179.1 127.3-8.7 19.7 6 42 27.6 42 12.1 0 22.7-7.5 27.7-18.5 24.3-53.9 78.5-91.5 141.3-91.5s117 37.6 141.3 91.5c5 11.1 15.6 18.5 27.7 18.5 21.4 0 36.1-22.3 27.4-42zM567.9 427.9c0-38.6 31.4-70 70-70s70 31.4 70 70-31.4 70-70 70-70-31.4-70-70zM460.3 347.9H216.9c-16.6 0-30 13.4-30 30s13.4 30 30 30h243.3c16.6 0 30-13.4 30-30 0.1-16.5-13.4-30-29.9-30zM367.4 459.6H216.9c-16.6 0-30 13.4-30 30s13.4 30 30 30h150.4c16.6 0 30-13.4 30-30 0.1-16.6-13.4-30-29.9-30zM297.4 571.2H217c-16.6 0-30 13.4-30 30s13.4 30 30 30h80.4c16.6 0 30-13.4 30-30 0-16.5-13.5-30-30-30zM900 236v552H124V236h776m0-60H124c-33.1 0-60 26.9-60 60v552c0 33.1 26.9 60 60 60h776c33.1 0 60-26.9 60-60V236c0-33.1-26.9-60-60-60z"
  136. ''' <summary>
  137. ''' 图标按钮,×,0.85x
  138. ''' </summary>
  139. Public Const IconButtonCross As String = "F1 M 26.9166,22.1667L 37.9999,33.25L 49.0832,22.1668L 53.8332,26.9168L 42.7499,38L 53.8332,49.0834L 49.0833,53.8334L 37.9999,42.75L 26.9166,53.8334L 22.1666,49.0833L 33.25,38L 22.1667,26.9167L 26.9166,22.1667 Z"
  140. ''' <summary>
  141. ''' 图标按钮,Mojang,1.1x
  142. ''' </summary>
  143. Public Const IconButtonMojang As String = "M9.183,18.967c-0.109-2.239,1.336-5.119,3.92-4.96c3.657-0.027,7.319-0.044,10.977,0.005 c3.712,0.214,6.596,2.759,9.652,4.533c0.181-1.697-0.197-3.717,1.237-4.982c1.899,2.091,3.143,4.894,5.677,6.334 c1.577,0.805,2.973-0.668,4.221-1.44c1.55,2.305,2.108,5.075,2.622,7.752c0.657,3.438,0.947,6.925,1.111,10.413 c-1.734-0.733-3.355-1.708-4.971-2.671c-1.396-4.933-5.349-8.656-9.723-11.059c-3.46-1.817-7.752-2.185-11.338-0.52 c-3.761,1.593-6.285,5.666-5.891,9.75c0.121,4.577,3.17,8.765,7.391,10.456c7.746,3.285,16.407,2.234,24.521,1.243 c0.454,2.315-1.511,4.527-3.695,4.889c-10.577,0.038-21.148-0.011-31.725,0.022c-2.217,0.279-4.079-1.879-3.964-4.008 C9.167,36.141,9.216,27.556,9.183,18.967z M40.114,8.09c0.294-0.801,0.872-1.417,1.542-1.924c1.379,2.589,2.742,5.482,2.311,8.491 c-0.332,2.54-4.42,2.507-5.052,0.163C38.349,12.527,39.209,10.178,40.114,8.09z M0,53 l0.1,0 z"
  144. ''' <summary>
  145. ''' 图标按钮,用户,0.95x
  146. ''' </summary>
  147. Public Const IconButtonUser As String = "M660.338 528.065c63.61-46.825 105.131-121.964 105.131-206.83 0-141.7-115.29-256.987-256.997-256.987-141.706 0-256.998 115.288-256.998 256.987 0 85.901 42.52 161.887 107.456 208.562-152.1 59.92-260.185 207.961-260.185 381.077 0 21.276 17.253 38.53 38.53 38.53 21.278 0 38.53-17.254 38.53-38.53 0-183.426 149.232-332.671 332.667-332.671 1.589 0 3.113-0.207 4.694-0.244 0.8 0.056 1.553 0.244 2.362 0.244 183.434 0 332.664 149.245 332.664 332.671 0 21.276 17.255 38.53 38.533 38.53 21.277 0 38.53-17.254 38.53-38.53 0-174.885-110.354-324.13-264.917-382.809z m-331.803-206.83c0-99.22 80.72-179.927 179.935-179.927s179.937 80.708 179.937 179.927c0 99.203-80.721 179.91-179.937 179.91s-179.935-80.708-179.935-179.91z"
  148. ''' <summary>
  149. ''' 图标,音符,1x
  150. ''' </summary>
  151. Public Const IconMusic As String = "M348.293565 716.53287V254.797913c0-41.672348 28.004174-78.358261 68.919652-90.37913L815.994435 40.826435c62.775652-18.610087 125.907478 26.579478 125.907478 89.933913v539.158261c8.013913 42.25113-8.94887 89.177043-47.014956 127.109565a232.848696 232.848696 0 0 1-170.785392 65.758609c-61.885217-2.938435-111.081739-33.435826-129.113043-80.050087-18.031304-46.614261-2.137043-102.177391 41.672348-145.853218a232.848696 232.848696 0 0 1 170.785391-65.80313c21.014261 1.024 40.514783 5.164522 57.878261 12.065391V233.338435c0-12.109913-10.551652-20.034783-20.569044-20.034783a24.620522 24.620522 0 0 0-5.787826 0.934957L439.785739 338.18713a19.545043 19.545043 0 0 0-14.825739 19.144348v438.984348H423.846957c11.53113 43.987478-5.164522 94.208-45.412174 134.322087a232.848696 232.848696 0 0 1-170.785392 65.758609c-61.885217-2.938435-111.081739-33.435826-129.113043-80.050087-18.031304-46.614261-2.137043-102.177391 41.672348-145.853218a232.848696 232.848696 0 0 1 170.785391-65.80313c20.791652 1.024 40.069565 5.075478 57.299478 11.842783z"
  152. ''' <summary>
  153. ''' 图标,播放,0.8x
  154. ''' </summary>
  155. Public Const IconPlay As String = "M803.904 463.936a55.168 55.168 0 0 1 0 96.128l-463.616 264.448C302.848 845.888 256 819.136 256 776.448V247.616c0-42.752 46.848-69.44 84.288-48.064l463.616 264.384z"
  156. End Class
  157. #End Region
  158. #Region "自定义类"
  159. ''' <summary>
  160. ''' 支持小数与常见类型隐式转换的颜色。
  161. ''' </summary>
  162. Public Class MyColor
  163. Public A As Double = 255
  164. Public R As Double = 0
  165. Public G As Double = 0
  166. Public B As Double = 0
  167. '类型转换
  168. Public Shared Widening Operator CType(str As String) As MyColor
  169. Return New MyColor(str)
  170. End Operator
  171. Public Shared Widening Operator CType(col As Color) As MyColor
  172. Return New MyColor(col)
  173. End Operator
  174. Public Shared Widening Operator CType(conv As MyColor) As Color
  175. Return Color.FromArgb(MathByte(conv.A), MathByte(conv.R), MathByte(conv.G), MathByte(conv.B))
  176. End Operator
  177. Public Shared Widening Operator CType(conv As MyColor) As System.Drawing.Color
  178. Return System.Drawing.Color.FromArgb(MathByte(conv.A), MathByte(conv.R), MathByte(conv.G), MathByte(conv.B))
  179. End Operator
  180. Public Shared Widening Operator CType(bru As SolidColorBrush) As MyColor
  181. Return New MyColor(bru.Color)
  182. End Operator
  183. Public Shared Widening Operator CType(conv As MyColor) As SolidColorBrush
  184. Return New SolidColorBrush(Color.FromArgb(MathByte(conv.A), MathByte(conv.R), MathByte(conv.G), MathByte(conv.B)))
  185. End Operator
  186. Public Shared Widening Operator CType(bru As Brush) As MyColor
  187. Return New MyColor(bru)
  188. End Operator
  189. Public Shared Widening Operator CType(conv As MyColor) As Brush
  190. Return New SolidColorBrush(Color.FromArgb(MathByte(conv.A), MathByte(conv.R), MathByte(conv.G), MathByte(conv.B)))
  191. End Operator
  192. '颜色运算
  193. Public Shared Operator +(a As MyColor, b As MyColor) As MyColor
  194. Return New MyColor With {.A = a.A + b.A, .B = a.B + b.B, .G = a.G + b.G, .R = a.R + b.R}
  195. End Operator
  196. Public Shared Operator -(a As MyColor, b As MyColor) As MyColor
  197. Return New MyColor With {.A = a.A - b.A, .B = a.B - b.B, .G = a.G - b.G, .R = a.R - b.R}
  198. End Operator
  199. Public Shared Operator *(a As MyColor, b As Double) As MyColor
  200. Return New MyColor With {.A = a.A * b, .B = a.B * b, .G = a.G * b, .R = a.R * b}
  201. End Operator
  202. Public Shared Operator /(a As MyColor, b As Double) As MyColor
  203. Return New MyColor With {.A = a.A / b, .B = a.B / b, .G = a.G / b, .R = a.R / b}
  204. End Operator
  205. Public Shared Operator =(a As MyColor, b As MyColor) As Boolean
  206. If IsNothing(a) AndAlso IsNothing(b) Then Return True
  207. If IsNothing(a) OrElse IsNothing(b) Then Return False
  208. Return a.A = b.A AndAlso a.R = b.R AndAlso a.G = b.G AndAlso a.B = b.B
  209. End Operator
  210. Public Shared Operator <>(a As MyColor, b As MyColor) As Boolean
  211. If IsNothing(a) AndAlso IsNothing(b) Then Return False
  212. If IsNothing(a) OrElse IsNothing(b) Then Return True
  213. Return Not (a.A = b.A AndAlso a.R = b.R AndAlso a.G = b.G AndAlso a.B = b.B)
  214. End Operator
  215. '构造函数
  216. Public Sub New()
  217. End Sub
  218. Public Sub New(col As Color)
  219. Me.A = col.A
  220. Me.R = col.R
  221. Me.G = col.G
  222. Me.B = col.B
  223. End Sub
  224. Public Sub New(HexString As String)
  225. Dim StringColor As Media.Color = ColorConverter.ConvertFromString(HexString)
  226. A = StringColor.A
  227. R = StringColor.R
  228. G = StringColor.G
  229. B = StringColor.B
  230. End Sub
  231. Public Sub New(newA As Double, col As MyColor)
  232. Me.A = newA
  233. Me.R = col.R
  234. Me.G = col.G
  235. Me.B = col.B
  236. End Sub
  237. Public Sub New(newR As Double, newG As Double, newB As Double)
  238. Me.A = 255
  239. Me.R = newR
  240. Me.G = newG
  241. Me.B = newB
  242. End Sub
  243. Public Sub New(newA As Double, newR As Double, newG As Double, newB As Double)
  244. Me.A = newA
  245. Me.R = newR
  246. Me.G = newG
  247. Me.B = newB
  248. End Sub
  249. Public Sub New(brush As Brush)
  250. Dim Color As Color = CType(brush, SolidColorBrush).Color
  251. A = Color.A
  252. R = Color.R
  253. G = Color.G
  254. B = Color.B
  255. End Sub
  256. Public Sub New(brush As SolidColorBrush)
  257. Dim Color As Color = brush.Color
  258. A = Color.A
  259. R = Color.R
  260. G = Color.G
  261. B = Color.B
  262. End Sub
  263. Public Sub New(obj As Object)
  264. If obj Is Nothing Then
  265. A = 255 : R = 255 : G = 255 : B = 255
  266. Else
  267. If TypeOf obj Is SolidColorBrush Then
  268. '避免反复获取 Color 对象造成性能下降
  269. Dim Color As Color = CType(obj, SolidColorBrush).Color
  270. A = Color.A
  271. R = Color.R
  272. G = Color.G
  273. B = Color.B
  274. Else
  275. A = obj.A
  276. R = obj.R
  277. G = obj.G
  278. B = obj.B
  279. End If
  280. End If
  281. End Sub
  282. 'HSL
  283. Public Function Hue(v1 As Double, v2 As Double, vH As Double) As Double
  284. If vH < 0 Then vH += 1
  285. If vH > 1 Then vH -= 1
  286. If vH < 0.16667 Then Return v1 + (v2 - v1) * 6 * vH
  287. If vH < 0.5 Then Return v2
  288. If vH < 0.66667 Then Return v1 + (v2 - v1) * (4 - vH * 6)
  289. Return v1
  290. End Function
  291. Public Function FromHSL(sH As Double, sS As Double, sL As Double) As MyColor
  292. If sS = 0 Then
  293. R = sL * 2.55
  294. G = R
  295. B = R
  296. Else
  297. Dim H = sH / 360
  298. Dim S = sS / 100
  299. Dim L = sL / 100
  300. S = If(L < 0.5, S * L + L, S * (1.0 - L) + L)
  301. L = 2 * L - S
  302. R = 255 * Hue(L, S, H + 1 / 3)
  303. G = 255 * Hue(L, S, H)
  304. B = 255 * Hue(L, S, H - 1 / 3)
  305. End If
  306. A = 255
  307. Return Me
  308. End Function
  309. Public Function FromHSL2(sH As Double, sS As Double, sL As Double) As MyColor
  310. If sS = 0 Then
  311. R = sL * 2.55 : G = R : B = R
  312. Else
  313. '初始化
  314. sH = (sH + 3600000) Mod 360
  315. Dim cent As Double() = {
  316. +0.1, -0.06, -0.3, '0, 30, 60
  317. -0.19, -0.15, -0.24, '90, 120, 150
  318. -0.32, -0.09, +0.18, '180, 210, 240
  319. +0.05, -0.12, -0.02, '270, 300, 330
  320. +0.1, -0.06} '最后两位与前两位一致,加是变亮,减是变暗
  321. '计算色调对应的亮度片区
  322. Dim center As Double = sH / 30.0
  323. Dim intCenter As Integer = Math.Floor(center) '亮度片区编号
  324. center = 50 - (
  325. (1 - center + intCenter) * cent(intCenter) + (center - intCenter) * cent(intCenter + 1)
  326. ) * sS
  327. 'center = 50 + (cent(intCenter) + (center - intCenter) * (cent(intCenter + 1) - cent(intCenter))) * sS
  328. sL = If(sL < center, sL / center, 1 + (sL - center) / (100 - center)) * 50
  329. FromHSL(sH, sS, sL)
  330. End If
  331. A = 255
  332. Return Me
  333. End Function
  334. Public Overrides Function ToString() As String
  335. Return "(" & A & "," & R & "," & G & "," & B & ")"
  336. End Function
  337. Public Overrides Function Equals(obj As Object) As Boolean
  338. Return Me = obj
  339. End Function
  340. End Class
  341. ''' <summary>
  342. ''' 支持负数与浮点数的矩形。
  343. ''' </summary>
  344. Public Class MyRect
  345. '属性
  346. Public Property Width As Double = 0
  347. Public Property Height As Double = 0
  348. Public Property Left As Double = 0
  349. Public Property Top As Double = 0
  350. '构造函数
  351. Public Sub New()
  352. End Sub
  353. Public Sub New(left As Double, top As Double, width As Double, height As Double)
  354. Me.Left = left
  355. Me.Top = top
  356. Me.Width = width
  357. Me.Height = height
  358. End Sub
  359. End Class
  360. ''' <summary>
  361. ''' 模块加载状态枚举。
  362. ''' </summary>
  363. Public Enum LoadState
  364. Waiting
  365. Loading
  366. Finished
  367. Failed
  368. Aborted
  369. End Enum
  370. ''' <summary>
  371. ''' 执行返回值。
  372. ''' </summary>
  373. Public Enum Result
  374. ''' <summary>
  375. ''' 执行成功,或进程被中断。
  376. ''' </summary>
  377. Aborted = -1
  378. ''' <summary>
  379. ''' 执行成功。
  380. ''' </summary>
  381. Success = 0
  382. ''' <summary>
  383. ''' 执行失败。
  384. ''' </summary>
  385. Fail
  386. ''' <summary>
  387. ''' 执行时出现未经处理的异常。
  388. ''' </summary>
  389. Exception
  390. ''' <summary>
  391. ''' 执行超时。
  392. ''' </summary>
  393. Timeout
  394. ''' <summary>
  395. ''' 取消执行。可能是由于不满足执行的前置条件。
  396. ''' </summary>
  397. Cancel
  398. End Enum
  399. ''' <summary>
  400. ''' 可以使用 Equals 和等号的 List。
  401. ''' </summary>
  402. Public Class EqualableList(Of T)
  403. Inherits List(Of T)
  404. Public Overrides Function Equals(obj As Object) As Boolean
  405. If TryCast(obj, List(Of T)) Is Nothing Then
  406. '类型不同
  407. Return False
  408. Else
  409. '类型相同
  410. Dim objList As List(Of T) = obj
  411. If objList.Count <> Count Then Return False
  412. For i = 0 To objList.Count - 1
  413. If Not objList(i).Equals(Me(i)) Then Return False
  414. Next
  415. Return True
  416. End If
  417. End Function
  418. Public Shared Operator =(left As EqualableList(Of T), right As EqualableList(Of T)) As Boolean
  419. Return EqualityComparer(Of EqualableList(Of T)).Default.Equals(left, right)
  420. End Operator
  421. Public Shared Operator <>(left As EqualableList(Of T), right As EqualableList(Of T)) As Boolean
  422. Return Not left = right
  423. End Operator
  424. End Class
  425. #End Region
  426. #Region "数学"
  427. ''' <summary>
  428. ''' 2~65 进制的转换。
  429. ''' </summary>
  430. Public Function RadixConvert(Input As String, FromRadix As Integer, ToRadix As Integer) As String
  431. Const Digits As String = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz/+="
  432. '零与负数的处理
  433. If String.IsNullOrEmpty(Input) Then Return "0"
  434. Dim IsNegative As Boolean = Input.StartsWith("-")
  435. If IsNegative Then Input = Input.TrimStart("-")
  436. '转换为十进制
  437. Dim RealNum As Long = 0, Scale As Long = 1
  438. For Each Digit In Input.Reverse.Select(Function(l) Digits.IndexOf(l))
  439. RealNum += Digit * Scale
  440. Scale *= FromRadix
  441. Next
  442. '转换为指定进制
  443. Dim Result = ""
  444. While RealNum > 0
  445. Dim NewNum As Integer = RealNum Mod ToRadix
  446. RealNum = (RealNum - NewNum) / ToRadix
  447. Result = Digits(NewNum) & Result
  448. End While
  449. '负数的结束处理与返回
  450. Return If(IsNegative, "-", "") & Result
  451. End Function
  452. ''' <summary>
  453. ''' 计算二阶贝塞尔曲线。
  454. ''' </summary>
  455. Public Function MathBezier(x As Double, x1 As Double, y1 As Double, x2 As Double, y2 As Double, Optional acc As Double = 0.01) As Double
  456. If x <= 0 OrElse Double.IsNaN(x) Then Return 0
  457. If x >= 1 Then Return 1
  458. Dim a, b
  459. a = x
  460. Do
  461. b = 3 * a * ((0.33333333 + x1 - x2) * a * a + (x2 - 2 * x1) * a + x1)
  462. a += (x - b) * 0.5
  463. Loop Until Math.Abs(b - x) < acc '精度
  464. Return 3 * a * ((0.33333333 + y1 - y2) * a * a + (y2 - 2 * y1) * a + y1)
  465. End Function
  466. ''' <summary>
  467. ''' 将一个数字限制为 0~255 的 Byte 值。
  468. ''' </summary>
  469. Public Function MathByte(d As Double) As Byte
  470. If d < 0 Then d = 0
  471. If d > 255 Then d = 255
  472. Return Math.Round(d)
  473. End Function
  474. ''' <summary>
  475. ''' 提供 MyColor 类型支持的 Math.Round。
  476. ''' </summary>
  477. Public Function MathRound(col As MyColor, Optional w As Integer = 0) As MyColor
  478. Return New MyColor With {.A = Math.Round(col.A, w), .R = Math.Round(col.R, w), .G = Math.Round(col.G, w), .B = Math.Round(col.B, w)}
  479. End Function
  480. ''' <summary>
  481. ''' 获取两数间的百分比。小数点精确到 6 位。
  482. ''' </summary>
  483. ''' <returns></returns>
  484. ''' <remarks></remarks>
  485. Public Function MathPercent(ValueA As Double, ValueB As Double, Percent As Double) As Double
  486. Return Math.Round(ValueA * (1 - Percent) + ValueB * Percent, 6) '解决 Double 计算错误
  487. End Function
  488. ''' <summary>
  489. ''' 获取两颜色间的百分比,根据 RGB 计算。小数点精确到 6 位。
  490. ''' </summary>
  491. Public Function MathPercent(ValueA As MyColor, ValueB As MyColor, Percent As Double) As MyColor
  492. Return MathRound(ValueA * (1 - Percent) + ValueB * Percent, 6) '解决Double计算错误
  493. End Function
  494. ''' <summary>
  495. ''' 将数值限定在某个范围内。
  496. ''' </summary>
  497. Public Function MathRange(value As Double, min As Double, max As Double) As Double
  498. Return Math.Max(min, Math.Min(max, value))
  499. End Function
  500. ''' <summary>
  501. ''' 符号函数。
  502. ''' </summary>
  503. Public Function MathSgn(Value As Double) As Integer
  504. If Value = 0 Then
  505. Return 0
  506. ElseIf Value > 0 Then
  507. Return 1
  508. Else
  509. Return -1
  510. End If
  511. End Function
  512. #End Region
  513. #Region "文件"
  514. '注册表
  515. ''' <summary>
  516. ''' 重命名一个注册表子键。不可用于包含子键的子键。
  517. ''' </summary>
  518. Public Sub RegRename(parentKey As Microsoft.Win32.RegistryKey, subKeyName As String, newSubKeyName As String)
  519. If parentKey.GetSubKeyNames().Contains(newSubKeyName) Then parentKey.DeleteSubKeyTree(newSubKeyName, False)
  520. Dim SourceKey As Microsoft.Win32.RegistryKey = parentKey.OpenSubKey(subKeyName)
  521. If IsNothing(SourceKey) Then Exit Sub '没有目标项
  522. Dim NewKey As Microsoft.Win32.RegistryKey = parentKey.CreateSubKey(newSubKeyName)
  523. If SourceKey.GetSubKeyNames().Length > 0 Then Throw New NotSupportedException("不支持对包含子键的子键进行重命名:" & SourceKey.GetSubKeyNames()(0) & "。")
  524. For Each valueName As String In SourceKey.GetValueNames()
  525. Dim objValue As Object = SourceKey.GetValue(valueName)
  526. Dim valKind As Microsoft.Win32.RegistryValueKind = SourceKey.GetValueKind(valueName)
  527. NewKey.SetValue(valueName, objValue, valKind)
  528. Next
  529. parentKey.DeleteSubKeyTree(subKeyName, False)
  530. End Sub
  531. ''' <summary>
  532. ''' 读取程序所属注册表。
  533. ''' </summary>
  534. Public Function ReadReg(Key As String, Optional DefaultValue As String = "") As String
  535. Try
  536. Dim parentKey As Microsoft.Win32.RegistryKey, softKey As Microsoft.Win32.RegistryKey
  537. parentKey = My.Computer.Registry.CurrentUser
  538. softKey = parentKey.OpenSubKey("Software\PCL", True)
  539. If softKey Is Nothing Then
  540. ReadReg = DefaultValue '不存在则返回默认值
  541. Else
  542. Dim readValue As New Text.StringBuilder
  543. readValue.AppendLine(softKey.GetValue(Key))
  544. Dim value = readValue.ToString.Replace(vbCrLf, "") '去除莫名的回车
  545. Return If(value = "", DefaultValue, value) '错误则返回默认值
  546. End If
  547. Catch ex As Exception
  548. Log(ex, "读取注册表出错:" & Key, LogLevel.Hint)
  549. Return DefaultValue
  550. End Try
  551. End Function
  552. ''' <summary>
  553. ''' 写入程序所属注册表。
  554. ''' </summary>
  555. Public Sub WriteReg(Key As String, Value As String, Optional ShowException As Boolean = False)
  556. Try
  557. Dim parentKey As Microsoft.Win32.RegistryKey, softKey As Microsoft.Win32.RegistryKey
  558. parentKey = My.Computer.Registry.CurrentUser
  559. softKey = parentKey.OpenSubKey("Software\PCL", True)
  560. If softKey Is Nothing Then softKey = parentKey.CreateSubKey("Software\PCL") '如果不存在就创建
  561. softKey.SetValue(Key, Value)
  562. Catch ex As Exception
  563. Log(ex, "写入注册表出错:" & Key, If(ShowException, LogLevel.Hint, LogLevel.Developer))
  564. If ShowException Then Throw '如果显示错误就丢一个
  565. End Try
  566. End Sub
  567. 'Ini 文件
  568. Private Class IniCache
  569. Public FileContent As String = ""
  570. Public KVCache As New Dictionary(Of String, String)
  571. End Class
  572. Private ReadOnly IniCacheList As New Dictionary(Of String, IniCache)
  573. ''' <summary>
  574. ''' 清除某 Ini 文件的运行时缓存。
  575. ''' </summary>
  576. ''' <param name="FileName">文件完整路径或简写文件名。简写将会使用“ApplicationName\文件名.ini”作为路径。</param>
  577. Public Sub IniClearCache(FileName As String)
  578. '还原文件路径
  579. If Not FileName.Contains(":\") Then FileName = Path & "PCL\" & FileName & ".ini"
  580. '检索缓存
  581. If IniCacheList.ContainsKey(FileName) Then IniCacheList.Remove(FileName)
  582. End Sub
  583. ''' <summary>
  584. ''' 获取 Ini 文件内容,这可能会使用到缓存。
  585. ''' </summary>
  586. ''' <param name="FileName">文件完整路径或简写文件名。简写将会使用“ApplicationName\文件名.ini”作为路径。</param>
  587. Private Function IniGetContent(FileName As String) As IniCache
  588. Try
  589. '还原文件路径
  590. If Not FileName.Contains(":\") Then FileName = Path & "PCL\" & FileName & ".ini"
  591. '检索缓存
  592. If IniCacheList.ContainsKey(FileName) Then
  593. '返回缓存中的信息
  594. Dim Cache As New IniCache
  595. IniCacheList.TryGetValue(FileName, Cache)
  596. Return Cache '防止ByRef导致缓存变更
  597. Else
  598. Dim Ini As IniCache
  599. If File.Exists(FileName) Then
  600. '返回文件信息并且记入缓存
  601. Dim Cache As String = (vbCrLf & ReadFile(FileName) & vbCrLf).Replace(vbCrLf, vbCr).Replace(vbLf, vbCr).Replace(vbCr, vbCrLf).Replace(vbCrLf & vbCrLf, vbCrLf).Replace(vbNullChar, "")
  602. Ini = New IniCache With {.FileContent = Cache}
  603. Else
  604. '返回空文件信息
  605. Ini = New IniCache With {.FileContent = ""}
  606. End If
  607. If Not IniCacheList.ContainsKey(FileName) Then IniCacheList.Add(FileName, Ini) '避免多线程异步执行此方法时造成多次添加项
  608. Return Ini
  609. End If
  610. Catch ex As Exception
  611. Log(ex, "读取文件失败:" & FileName, LogLevel.Hint)
  612. Return New IniCache With {.FileContent = ""}
  613. End Try
  614. End Function
  615. ''' <summary>
  616. ''' 读取Ini文件,这可能会使用到缓存。
  617. ''' </summary>
  618. ''' <param name="FileName">文件完整路径或简写文件名。简写将会使用“ApplicationName\文件名.ini”作为路径。</param>
  619. ''' <param name="Key">键。</param>
  620. ''' <param name="DefaultValue">没有找到键时返回的默认值。</param>
  621. Public Function ReadIni(FileName As String, Key As String, Optional DefaultValue As String = "") As String
  622. Try
  623. '获取目前文件
  624. Dim NowIni As IniCache = IniGetContent(FileName)
  625. If IsNothing(NowIni) Then Return DefaultValue
  626. '使用缓存
  627. If NowIni.KVCache.ContainsKey(Key) Then Return If(NowIni.KVCache(Key), DefaultValue)
  628. '没有缓存,读取文件
  629. If NowIni.FileContent.Contains(vbCrLf & Key & ":") Then
  630. Dim Ret As String = Mid(NowIni.FileContent, NowIni.FileContent.IndexOf(vbCrLf & Key & ":") + 3)
  631. Ret = If(Ret.Contains(vbCrLf), Mid(Ret, 1, Ret.IndexOf(vbCrLf)), Ret).Replace(Key & ":", "")
  632. NowIni.KVCache.Add(Key, If(Ret = vbLf, "", Ret))
  633. Return If(Ret = vbLf, "", Ret)
  634. Else
  635. Return DefaultValue
  636. End If
  637. Catch ex As Exception
  638. '读取失败
  639. Return DefaultValue
  640. End Try
  641. End Function
  642. ''' <summary>
  643. ''' 写入ini文件,这会更新缓存。
  644. ''' </summary>
  645. ''' <param name="FileName">文件完整路径或简写文件名。简写将会使用“ApplicationName\文件名.ini”作为路径。</param>
  646. ''' <param name="Key">键。</param>
  647. ''' <param name="Value">值。</param>
  648. ''' <remarks></remarks>
  649. Public Sub WriteIni(FileName As String, Key As String, Value As String)
  650. Try
  651. '还原文件路径
  652. If Not FileName.Contains(":\") Then FileName = Path & "PCL\" & FileName & ".ini"
  653. If IsNothing(Value) Then Value = ""
  654. Value = Value.Replace(vbCrLf, "")
  655. '创建文件夹
  656. If Not Directory.Exists(GetPathFromFullPath(FileName)) Then Directory.CreateDirectory(GetPathFromFullPath(FileName))
  657. '获取目前文件
  658. Dim NowFile As String = IniGetContent(FileName).FileContent
  659. If Not NowFile.EndsWith(vbCrLf) Then NowFile += vbCrLf
  660. '如果值一样就不处理
  661. If NowFile.Contains(vbCrLf & Key & ":" & Value & vbCrLf) Then Exit Sub
  662. '处理文件
  663. Dim FindResult As String = ReadIni(FileName, Key)
  664. If FindResult = "" AndAlso Not NowFile.Contains(vbCrLf & Key & ":") Then
  665. '不存在这个键
  666. NowFile = NowFile & vbCrLf & Key & ":" & Value & vbCrLf
  667. Else
  668. '存在这个键
  669. NowFile = NowFile.Replace(vbCrLf & Key & ":" & FindResult & vbCrLf, vbCrLf & Key & ":" & Value & vbCrLf)
  670. End If
  671. WriteFile(FileName, NowFile)
  672. '刷新目前缓存
  673. IniCacheList(FileName).FileContent = NowFile
  674. IniCacheList(FileName).KVCache.Remove(Key)
  675. IniCacheList(FileName).KVCache.Add(Key, Value)
  676. Catch ex As Exception
  677. Log(ex, "写入文件失败:" & FileName & "/" & Key & ": " & Value)
  678. End Try
  679. End Sub
  680. '路径处理
  681. ''' <summary>
  682. ''' 从文件路径或者 Url 获取不包含文件名的路径,或获取文件夹的父文件夹路径。不包含路径将会抛出异常。
  683. ''' </summary>
  684. Public Function GetPathFromFullPath(FilePath As String) As String
  685. If Not (FilePath.Contains("\") OrElse FilePath.Contains("/")) Then Throw New Exception("不包含路径:" & FilePath)
  686. If FilePath.EndsWith("\") OrElse FilePath.EndsWith("/") Then
  687. '是文件夹路径
  688. Dim IsRight As Boolean = FilePath.EndsWith("\")
  689. FilePath = Left(FilePath, Len(FilePath) - 1)
  690. GetPathFromFullPath = Left(FilePath, FilePath.LastIndexOfAny({"\", "/"})) & If(IsRight, "\", "/")
  691. If GetPathFromFullPath = "" Then Throw New Exception("不包含路径:" & FilePath)
  692. Else
  693. '是文件路径
  694. GetPathFromFullPath = Left(FilePath, FilePath.LastIndexOfAny({"\", "/"}) + 1)
  695. If GetPathFromFullPath = "" Then Throw New Exception("不包含路径:" & FilePath)
  696. End If
  697. End Function
  698. ''' <summary>
  699. ''' 从文件路径或者 Url 获取不包含路径的文件名。不包含文件名将会抛出异常。
  700. ''' </summary>
  701. Public Function GetFileNameFromPath(FilePath As String) As String
  702. If FilePath.EndsWith("\") OrElse FilePath.EndsWith("/") Then Throw New Exception("不包含文件名:" & FilePath)
  703. If Not (FilePath.Contains("\") OrElse FilePath.Contains("/")) Then Return FilePath
  704. If FilePath.Contains("?") Then FilePath = Left(FilePath, FilePath.LastIndexOf("?")) '去掉网络参数后的 ?
  705. GetFileNameFromPath = Mid(FilePath, FilePath.LastIndexOfAny({"\", "/"}) + 2)
  706. If GetFileNameFromPath = "" Then Throw New Exception("不包含文件名:" & FilePath)
  707. End Function
  708. ''' <summary>
  709. ''' 从文件路径或者 Url 获取不包含路径与扩展名的文件名。不包含文件名将会抛出异常。
  710. ''' </summary>
  711. Public Function GetFileNameWithoutExtentionFromPath(FilePath As String) As String
  712. Dim Name As String = GetFileNameFromPath(FilePath)
  713. If Name.Contains(".") Then
  714. Return Name.Substring(0, Name.LastIndexOf("."))
  715. Else
  716. Return Name
  717. End If
  718. End Function
  719. ''' <summary>
  720. ''' 从文件夹路径获取文件夹名。
  721. ''' </summary>
  722. Public Function GetFolderNameFromPath(FolderPath As String) As String
  723. If FolderPath.EndsWith(":\") OrElse FolderPath.EndsWith(":\\") Then Return FolderPath.Substring(0, 1)
  724. If FolderPath.EndsWith("\") OrElse FolderPath.EndsWith("/") Then FolderPath = Left(FolderPath, FolderPath.Length - 1)
  725. Return GetFileNameFromPath(FolderPath)
  726. End Function
  727. '读取、写入、复制文件
  728. Public Sub CopyFile(FromPath As String, ToPath As String)
  729. Try
  730. '还原文件路径
  731. If Not FromPath.Contains(":\") Then FromPath = Path & FromPath
  732. If Not ToPath.Contains(":\") Then ToPath = Path & ToPath
  733. '如果复制同一个文件则跳过
  734. If FromPath = ToPath Then Exit Sub
  735. '读取文件内容
  736. Dim FileBytes As Byte()
  737. Using ReadStream As New FileStream(FromPath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite) '支持读取使用中的文件
  738. ReDim FileBytes(ReadStream.Length - 1)
  739. ReadStream.Read(FileBytes, 0, ReadStream.Length)
  740. End Using
  741. '写入文件内容
  742. WriteFile(ToPath, FileBytes)
  743. Catch ex As Exception
  744. Throw New Exception("复制文件出错:" & FromPath & " -> " & ToPath, ex)
  745. End Try
  746. End Sub
  747. ''' <summary>
  748. ''' 读取文件,如果失败则返回空字符串。
  749. ''' </summary>
  750. ''' <param name="FilePath">文件完整或相对路径。</param>
  751. Public Function ReadFile(FilePath As String) As String
  752. Try
  753. '还原文件路径
  754. If Not FilePath.Contains(":\") Then FilePath = Path & FilePath
  755. If File.Exists(FilePath) Then
  756. Dim FileBytes As Byte()
  757. Using ReadStream As New FileStream(FilePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite) '支持读取使用中的文件
  758. ReDim FileBytes(ReadStream.Length - 1)
  759. ReadStream.Read(FileBytes, 0, ReadStream.Length)
  760. End Using
  761. ReadFile = DecodeBytes(FileBytes)
  762. Else
  763. Log("[System] 欲读取的文件不存在,已返回空字符串:" & FilePath)
  764. Return ""
  765. End If
  766. Catch ex As Exception
  767. Log(ex, "读取文件出错:" & FilePath)
  768. Return ""
  769. End Try
  770. End Function
  771. ''' <summary>
  772. ''' 读取流中的所有文本。
  773. ''' </summary>
  774. Public Function ReadFile(Stream As Stream, Optional Encoding As Encoding = Nothing) As String
  775. Try
  776. Dim srcBuf As Byte() = New Byte(16384) {}
  777. Dim DataCount As Integer = Stream.Read(srcBuf, 0, 16384)
  778. Dim Result As New List(Of Byte)
  779. While DataCount > 0
  780. If DataCount > 0 Then Result.AddRange(srcBuf.ToList.GetRange(0, DataCount))
  781. DataCount = Stream.Read(srcBuf, 0, 16384)
  782. End While
  783. Dim Bts = Result.ToArray
  784. Return If(Encoding, GetEncoding(Bts)).GetString(Bts)
  785. Catch ex As Exception
  786. Log(ex, "读取流出错")
  787. Return ""
  788. End Try
  789. End Function
  790. ''' <summary>
  791. ''' 写入文件。
  792. ''' </summary>
  793. ''' <param name="FilePath">文件完整或相对路径。</param>
  794. ''' <param name="Text">文件内容。</param>
  795. ''' <param name="Append">是否将文件内容追加到当前文件,而不是覆盖它。</param>
  796. Public Function WriteFile(FilePath As String, Text As String, Optional Append As Boolean = False, Optional Encoding As Encoding = Nothing) As Boolean
  797. Try
  798. '还原文件路径
  799. If Not FilePath.Contains(":\") Then FilePath = Path & FilePath
  800. '确保目录存在
  801. Directory.CreateDirectory(GetPathFromFullPath(FilePath))
  802. '写入文件
  803. If File.Exists(FilePath) Then
  804. '如果文件存在,刷新目前文件
  805. Using writer As New StreamWriter(FilePath, Append, If(Encoding, GetEncoding(FilePath)))
  806. writer.Write(Text)
  807. writer.Flush()
  808. writer.Close()
  809. End Using
  810. Else
  811. '如果文件不存在,则新建并写入
  812. File.WriteAllText(FilePath, Text, If(Encoding, New UTF8Encoding(False)))
  813. End If
  814. Return True
  815. Catch ex As Exception
  816. Log(ex, "写入文件时出错:" & FilePath)
  817. Return False
  818. End Try
  819. End Function
  820. ''' <summary>
  821. ''' 写入文件。
  822. ''' </summary>
  823. ''' <param name="FilePath">文件完整或相对路径。</param>
  824. ''' <param name="Content">文件内容。</param>
  825. ''' <param name="Append">是否将文件内容追加到当前文件,而不是覆盖它。</param>
  826. Public Function WriteFile(FilePath As String, Content As Byte(), Optional Append As Boolean = False) As Boolean
  827. Try
  828. '还原文件路径
  829. If Not FilePath.Contains(":\") Then FilePath = Path & FilePath
  830. '确保目录存在
  831. Directory.CreateDirectory(GetPathFromFullPath(FilePath))
  832. '写入文件
  833. File.WriteAllBytes(FilePath, Content)
  834. Return True
  835. Catch ex As Exception
  836. Log(ex, "写入文件时出错:" & FilePath)
  837. Return False
  838. End Try
  839. End Function
  840. ''' <summary>
  841. ''' 将流写入文件。
  842. ''' </summary>
  843. ''' <param name="FilePath">文件完整或相对路径。</param>
  844. Public Function WriteFile(FilePath As String, Stream As Stream) As Boolean
  845. Try
  846. '还原文件路径
  847. If Not FilePath.Contains(":\") Then FilePath = Path & FilePath
  848. '确保目录存在
  849. Directory.CreateDirectory(GetPathFromFullPath(FilePath))
  850. '读取流
  851. Using fs As New FileStream(FilePath, FileMode.Create, FileAccess.Write)
  852. Dim srcBuf As Byte() = New Byte(16384) {}
  853. Dim DataCount As Integer = Stream.Read(srcBuf, 0, 16384)
  854. While DataCount > 0
  855. If DataCount > 0 Then fs.Write(srcBuf, 0, DataCount)
  856. DataCount = Stream.Read(srcBuf, 0, 16384)
  857. End While
  858. fs.Close()
  859. End Using
  860. Return True
  861. Catch ex As Exception
  862. Log(ex, "保存流出错")
  863. Return False
  864. End Try
  865. End Function
  866. '文件编码
  867. ''' <summary>
  868. ''' 获取文件编码。
  869. ''' </summary>
  870. ''' <param name="FilePath">文件完整或相对路径。</param>
  871. Public Function GetEncoding(FilePath As String) As Encoding
  872. '还原文件路径
  873. If Not FilePath.Contains(":\") Then FilePath = Path & FilePath
  874. '获取编码
  875. GetEncoding = GetEncoding(File.ReadAllBytes(FilePath))
  876. End Function
  877. ''' <summary>
  878. ''' 获取 Bytes 的编码。
  879. ''' </summary>
  880. Public Function GetEncoding(Bytes As Byte()) As Encoding
  881. Dim Length As Integer = Bytes.Count
  882. If Length <= 2 Then Return New UTF8Encoding(False) '不带 BOM 的 UTF8
  883. '根据 BOM 判断编码
  884. If Bytes(0) >= &HEF Then
  885. '有 BOM 类型
  886. If Bytes(0) = &HEF AndAlso Bytes(1) = &HBB Then
  887. Return New UTF8Encoding(True) '带 BOM 的 UTF8
  888. ElseIf Bytes(0) = &HFE AndAlso Bytes(1) = &HFF Then
  889. Return Encoding.BigEndianUnicode
  890. ElseIf Bytes(0) = &HFF AndAlso Bytes(1) = &HFE Then
  891. Return Encoding.Unicode
  892. Else
  893. Return Encoding.GetEncoding("GB18030")
  894. End If
  895. End If
  896. '无 BOM 文件:GB18030(ANSI)或 UTF8
  897. Dim UTF8 = Encoding.UTF8.GetString(Bytes)
  898. Dim ErrorChar As Char = Encoding.UTF8.GetString({239, 191, 189}).ToCharArray()(0)
  899. If UTF8.Contains(ErrorChar) Then
  900. Return Encoding.GetEncoding("GB18030")
  901. Else
  902. Return New UTF8Encoding(False) '不带 BOM 的 UTF8
  903. End If
  904. End Function
  905. ''' <summary>
  906. ''' 解码 Bytes。
  907. ''' </summary>
  908. Public Function DecodeBytes(Bytes As Byte()) As String
  909. Dim Length As Integer = Bytes.Length
  910. If Length < 3 Then Return Encoding.UTF8.GetString(Bytes)
  911. '根据 BOM 判断编码
  912. If Bytes(0) >= &HEF Then
  913. '有 BOM 类型
  914. If Bytes(0) = &HEF AndAlso Bytes(1) = &HBB Then
  915. Return Encoding.UTF8.GetString(Bytes, 3, Length - 3)
  916. ElseIf Bytes(0) = &HFE AndAlso Bytes(1) = &HFF Then
  917. Return Encoding.BigEndianUnicode.GetString(Bytes, 3, Length - 3)
  918. ElseIf Bytes(0) = &HFF AndAlso Bytes(1) = &HFE Then
  919. Return Encoding.Unicode.GetString(Bytes, 3, Length - 3)
  920. Else
  921. Return Encoding.GetEncoding("GB18030").GetString(Bytes, 3, Length - 3)
  922. End If
  923. End If
  924. '无 BOM 文件:GB18030(ANSI)或 UTF8
  925. Dim UTF8 = Encoding.UTF8.GetString(Bytes)
  926. Dim ErrorChar As Char = Encoding.UTF8.GetString({239, 191, 189}).ToCharArray()(0)
  927. If UTF8.Contains(ErrorChar) Then
  928. Return Encoding.GetEncoding("GB18030").GetString(Bytes)
  929. Else
  930. Return UTF8
  931. End If
  932. End Function
  933. '对话框
  934. ''' <summary>
  935. ''' 弹出保存对话框并且要求保存位置,返回用户输入的完整路径。
  936. ''' </summary>
  937. ''' <param name="FileFilter">要求的格式。如:“常用图片文件(*.png;*.jpg)|*.png;*.jpg”。</param>
  938. ''' <param name="Title">弹窗的标题。</param>
  939. ''' <param name="FileName">默认的文件名。</param>
  940. Public Function SelectAs(Title As String, FileName As String, Optional FileFilter As String = Nothing, Optional DefaultDir As String = Nothing) As String
  941. Using fileDialog As New Forms.SaveFileDialog
  942. fileDialog.AddExtension = True
  943. fileDialog.AutoUpgradeEnabled = True
  944. fileDialog.Title = Title
  945. fileDialog.FileName = FileName
  946. If FileFilter IsNot Nothing Then fileDialog.Filter = FileFilter
  947. If DefaultDir IsNot Nothing Then fileDialog.InitialDirectory = DefaultDir
  948. fileDialog.ShowDialog()
  949. SelectAs = If(fileDialog.FileName.Contains(":\"), fileDialog.FileName, "")
  950. Log("[UI] 选择文件返回:" & SelectAs)
  951. End Using
  952. End Function
  953. ''' <summary>
  954. ''' 弹出选取文件对话框并且要求选取文件。
  955. ''' </summary>
  956. ''' <param name="FileFilter">要求的格式。如:“常用图片文件(*.png;*.jpg)|*.png;*.jpg”。</param>
  957. ''' <param name="Title">弹窗的标题。</param>
  958. Public Function SelectFile(FileFilter As String, Title As String) As String
  959. Using fileDialog As New Forms.OpenFileDialog
  960. fileDialog.AddExtension = True
  961. fileDialog.AutoUpgradeEnabled = True
  962. fileDialog.CheckFileExists = True
  963. fileDialog.Filter = FileFilter
  964. fileDialog.Multiselect = False
  965. fileDialog.Title = Title
  966. fileDialog.ValidateNames = True
  967. fileDialog.ShowDialog()
  968. SelectFile = fileDialog.FileName
  969. Log("[UI] 选择文件返回:" & SelectFile)
  970. End Using
  971. End Function
  972. ''' <summary>
  973. ''' 弹出选取文件夹对话框并且要求选取文件夹。如果没有选择就返回空字符串。
  974. ''' </summary>
  975. Public Function SelectFolder(Optional Title As String = "选择文件夹") As String
  976. Dim folderDialog As New Ookii.Dialogs.Wpf.VistaFolderBrowserDialog With {.ShowNewFolderButton = True, .RootFolder = Environment.SpecialFolder.Desktop, .Description = Title, .UseDescriptionForTitle = True}
  977. folderDialog.ShowDialog()
  978. SelectFolder = If(String.IsNullOrEmpty(folderDialog.SelectedPath), "", folderDialog.SelectedPath & If(folderDialog.SelectedPath.EndsWith("\"), "", "\"))
  979. Log("[UI] 选择文件夹返回:" & SelectFolder)
  980. End Function
  981. '文件校验
  982. ''' <summary>
  983. ''' 检查是否拥有某一文件夹的 I/O 权限。如果文件夹不存在,会返回 False。
  984. ''' </summary>
  985. Public Function CheckPermission(Path As String) As Boolean
  986. Try
  987. If Path = "" Then Return False
  988. If Not Path.EndsWith("\") Then Path += "\"
  989. If Path.EndsWith(":\System Volume Information\") OrElse Path.EndsWith(":\$RECYCLE.BIN\") Then Return False
  990. If Not Directory.Exists(Path) Then Return False
  991. Dim FileName As String = "CheckPermission" & GetUuid()
  992. If File.Exists(Path & FileName) Then File.Delete(Path & FileName)
  993. File.Create(Path & FileName).Dispose()
  994. File.Delete(Path & FileName)
  995. Return True
  996. Catch ex As Exception
  997. Log(ex, "没有对文件夹 " & Path & " 的权限,请尝试以管理员权限运行 PCL")
  998. Return False
  999. End Try
  1000. End Function
  1001. ''' <summary>
  1002. ''' 检查是否拥有某一文件夹的 I/O 权限。如果出错,则抛出异常。
  1003. ''' </summary>
  1004. Public Sub CheckPermissionWithException(Path As String)
  1005. If String.IsNullOrWhiteSpace(Path) Then Throw New ArgumentNullException("文件夹名不能为空!")
  1006. If Not Path.EndsWith("\") Then Path += "\"
  1007. If Not Directory.Exists(Path) Then Throw New DirectoryNotFoundException("文件夹不存在!")
  1008. If File.Exists(Path & "CheckPermission") Then File.Delete(Path & "CheckPermission")
  1009. File.Create(Path & "CheckPermission").Dispose()
  1010. File.Delete(Path & "CheckPermission")
  1011. End Sub
  1012. ''' <summary>
  1013. ''' 获取文件 MD5,若失败则返回空字符串。
  1014. ''' </summary>
  1015. Public Function GetAuthMD5(FilePath As String) As String
  1016. Dim Retry As Boolean = False
  1017. Re:
  1018. Try
  1019. '获取 MD5
  1020. Dim Result As New StringBuilder()
  1021. Dim File As New FileStream(FilePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite)
  1022. Dim MD5 As MD5 = New MD5CryptoServiceProvider()
  1023. Dim Retval As Byte() = MD5.ComputeHash(File)
  1024. File.Close()
  1025. For i = 0 To Retval.Length - 1
  1026. Result.Append(Retval(i).ToString("x2"))
  1027. Next
  1028. Return Result.ToString
  1029. Catch ex As Exception
  1030. If Retry OrElse TypeOf ex Is FileNotFoundException Then
  1031. Log(ex, "获取文件 MD5 失败:" & FilePath)
  1032. Return ""
  1033. Else
  1034. Retry = True
  1035. Log(ex, "获取文件 MD5 可重试失败:" & FilePath, LogLevel.Normal)
  1036. Thread.Sleep(RandomInteger(200, 500))
  1037. GoTo Re
  1038. End If
  1039. End Try
  1040. End Function
  1041. ''' <summary>
  1042. ''' 获取文件 SHA256,若失败则返回空字符串。
  1043. ''' </summary>
  1044. Public Function GetAuthSHA256(FilePath As String) As String
  1045. Dim Retry As Boolean = False
  1046. Re:
  1047. Try
  1048. ''检测该文件是否在下载中,若在下载则放弃检测
  1049. 'If IgnoreOnDownloading AndAlso NetManage.Files.ContainsKey(FilePath) AndAlso NetManage.Files(FilePath).State <= NetState.Merge Then Return ""
  1050. '获取 SHA256
  1051. Dim file As New FileStream(FilePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite)
  1052. Dim sha1 As SHA256 = New SHA256CryptoServiceProvider()
  1053. Dim retval As Byte() = sha1.ComputeHash(file)
  1054. file.Close()
  1055. Dim Result As New StringBuilder()
  1056. For i As Integer = 0 To retval.Length - 1
  1057. Result.Append(retval(i).ToString("x2"))
  1058. Next
  1059. Return Result.ToString
  1060. Catch ex As Exception
  1061. If Retry OrElse TypeOf ex Is FileNotFoundException Then
  1062. Log(ex, "获取文件 SHA256 失败:" & FilePath)
  1063. Return ""
  1064. Else
  1065. Retry = True
  1066. Log(ex, "获取文件 SHA256 可重试失败:" & FilePath, LogLevel.Normal)
  1067. Thread.Sleep(RandomInteger(200, 500))
  1068. GoTo Re
  1069. End If
  1070. End Try
  1071. End Function
  1072. ''' <summary>
  1073. ''' 获取文件 SHA1,若失败则返回空字符串。
  1074. ''' </summary>
  1075. Public Function GetAuthSHA1(FilePath As String) As String
  1076. Dim Retry As Boolean = False
  1077. Re:
  1078. Try
  1079. ''检测该文件是否在下载中,若在下载则放弃检测
  1080. 'If IgnoreOnDownloading AndAlso NetManage.Files.ContainsKey(FilePath) AndAlso NetManage.Files(FilePath).State <= NetState.Merge Then Return ""
  1081. '获取 SHA1
  1082. Dim file As New FileStream(FilePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite)
  1083. Dim sha1 As SHA1 = New SHA1CryptoServiceProvider()
  1084. Dim retval As Byte() = sha1.ComputeHash(file)
  1085. file.Close()
  1086. Dim Result As New StringBuilder()
  1087. For i As Integer = 0 To retval.Length - 1
  1088. Result.Append(retval(i).ToString("x2"))
  1089. Next
  1090. Return Result.ToString
  1091. Catch ex As Exception
  1092. If Retry OrElse TypeOf ex Is FileNotFoundException Then
  1093. Log(ex, "获取文件 SHA1 失败:" & FilePath)
  1094. Return ""
  1095. Else
  1096. Retry = True
  1097. Log(ex, "获取文件 SHA1 可重试失败:" & FilePath, LogLevel.Normal)
  1098. Thread.Sleep(RandomInteger(200, 500))
  1099. GoTo Re
  1100. End If
  1101. End Try
  1102. End Function
  1103. ''' <summary>
  1104. ''' 获取流 SHA1,若失败则返回空字符串。
  1105. ''' </summary>
  1106. Public Function GetAuthSHA1(Stream As Stream) As String
  1107. Try
  1108. Dim sha1 As SHA1 = New SHA1CryptoServiceProvider()
  1109. Dim retval As Byte() = sha1.ComputeHash(Stream)
  1110. Dim Result As New StringBuilder()
  1111. For i As Integer = 0 To retval.Length - 1
  1112. Result.Append(retval(i).ToString("x2"))
  1113. Next
  1114. Return Result.ToString
  1115. Catch ex As Exception
  1116. Log(ex, "获取流 SHA1 失败")
  1117. Return ""
  1118. End Try
  1119. End Function
  1120. ''' <summary>
  1121. ''' 文件的校验规则。
  1122. ''' </summary>
  1123. Public Class FileChecker
  1124. ''' <summary>
  1125. ''' 文件的准确大小。
  1126. ''' </summary>
  1127. Public ActualSize As Long = -1
  1128. ''' <summary>
  1129. ''' 文件的最小大小。
  1130. ''' </summary>
  1131. Public MinSize As Long = -1
  1132. ''' <summary>
  1133. ''' 文件的 MD5、SHA1 或 SHA256。会根据输入字符串的长度自动判断种类。
  1134. ''' </summary>
  1135. Public Hash As String = Nothing
  1136. ''' <summary>
  1137. ''' 是否可以使用已经存在的文件。
  1138. ''' </summary>
  1139. Public CanUseExistsFile As Boolean = True
  1140. ''' <summary>
  1141. ''' 是否为 Json 文件。
  1142. ''' </summary>
  1143. Public IsJson As Boolean = False
  1144. Public Sub New(Optional MinSize As Long = -1, Optional ActualSize As Long = -1, Optional Hash As String = Nothing, Optional CanUseExistsFile As Boolean = True, Optional IsJson As Boolean = False)
  1145. Me.ActualSize = ActualSize
  1146. Me.MinSize = MinSize
  1147. Me.Hash = Hash
  1148. Me.CanUseExistsFile = CanUseExistsFile
  1149. Me.IsJson = IsJson
  1150. End Sub
  1151. ''' <summary>
  1152. ''' 检查文件。若成功则返回 Nothing,失败则返回错误的描述文本,描述文本不以句号结尾。不会抛出错误。
  1153. ''' </summary>
  1154. Public Function Check(LocalPath As String) As String
  1155. Try
  1156. Dim Info As New FileInfo(LocalPath)
  1157. If Not Info.Exists Then Return "文件不存在:" & LocalPath
  1158. Dim FileSize As Long = Info.Length
  1159. If ActualSize >= 0 AndAlso ActualSize <> FileSize Then Return "文件大小应为 " & ActualSize & " B,实际为 " & FileSize & " B"
  1160. If MinSize >= 0 AndAlso MinSize > FileSize Then Return "文件大小应大于 " & MinSize & " B,实际为 " & FileSize & " B"
  1161. If Not String.IsNullOrEmpty(Hash) Then
  1162. If Hash.Length < 35 Then 'MD5
  1163. If Hash <> GetAuthMD5(LocalPath) Then Return "文件 MD5 应为 " & Hash & ",实际为 " & GetAuthMD5(LocalPath)
  1164. ElseIf Hash.Length = 64 Then 'SHA256
  1165. If Hash <> GetAuthSHA256(LocalPath) Then Return "文件 SHA256 应为 " & Hash & ",实际为 " & GetAuthSHA256(LocalPath)
  1166. Else 'SHA1 (40)
  1167. If Hash <> GetAuthSHA1(LocalPath) Then Return "文件 SHA1 应为 " & Hash & ",实际为 " & GetAuthSHA1(LocalPath)
  1168. End If
  1169. End If
  1170. If IsJson Then
  1171. Dim Content As String = ReadFile(LocalPath)
  1172. If Content = "" Then Throw New Exception("读取到的文件为空")
  1173. Try
  1174. GetJson(Content)
  1175. Catch ex As Exception
  1176. Throw New Exception("不是有效的 Json 文件", ex)
  1177. End Try
  1178. End If
  1179. Return Nothing
  1180. Catch ex As Exception
  1181. Log(ex, "检查文件出错")
  1182. Return GetString(ex)
  1183. End Try
  1184. End Function
  1185. End Class
  1186. ''' <summary>
  1187. ''' 尝试根据后缀名判断文件种类并解压文件,支持 gz 与 zip,会尝试将 jar 以 zip 方式解压。
  1188. ''' 会尝试创建,但不会清空目标文件夹。
  1189. ''' 成功返回 True,并非压缩文件或失败返回 False。
  1190. ''' </summary>
  1191. Public Function ExtractFile(CompressFilePath As String, DestDirectory As String, Optional Encode As Encoding = Nothing) As Boolean
  1192. Try
  1193. Directory.CreateDirectory(DestDirectory)
  1194. If CompressFilePath.EndsWith(".zip") OrElse CompressFilePath.EndsWith(".jar") Then
  1195. '以 zip 方式解压
  1196. ZipFile.ExtractToDirectory(CompressFilePath, DestDirectory, If(Encode, Encoding.GetEncoding("GB18030")))
  1197. Return True
  1198. ElseIf CompressFilePath.EndsWith(".gz") Then
  1199. '以 gz 方式解压
  1200. Dim stream As New GZipStream(New FileStream(CompressFilePath, FileMode.Open, FileAccess.ReadWrite), CompressionMode.Decompress)
  1201. Dim decompressedFile As New FileStream(DestDirectory & GetFileNameFromPath(CompressFilePath).ToLower.Replace(".tar", "").Replace(".gz", ""), FileMode.OpenOrCreate, FileAccess.Write)
  1202. Dim data As Integer = stream.ReadByte()
  1203. While data <> -1
  1204. decompressedFile.WriteByte(data)
  1205. data = stream.ReadByte()
  1206. End While
  1207. decompressedFile.Close()
  1208. stream.Close()
  1209. Return True
  1210. Else
  1211. Return False
  1212. End If
  1213. Catch ex As Exception
  1214. Log(ex, "尝试解压文件失败")
  1215. Return False
  1216. End Try
  1217. End Function
  1218. ''' <summary>
  1219. ''' 删除文件夹。失败会抛出异常。
  1220. ''' </summary>
  1221. Public Sub DeleteDirectory(Path As String, Optional IgnoreIssue As Boolean = False)
  1222. If Not Directory.Exists(Path) Then Exit Sub
  1223. Dim Temp As String()
  1224. Temp = Directory.GetFiles(Path)
  1225. For Each str As String In Temp
  1226. Try
  1227. File.Delete(str)
  1228. Catch ex As Exception
  1229. If IgnoreIssue Then
  1230. Log(ex, "删除单个文件可忽略地失败")
  1231. Else
  1232. Throw
  1233. End If
  1234. End Try
  1235. Next
  1236. Temp = Directory.GetDirectories(Path)
  1237. For Each str As String In Temp
  1238. DeleteDirectory(str)
  1239. Next
  1240. Try
  1241. Directory.Delete(Path, True)
  1242. Catch ex As Exception
  1243. If IgnoreIssue Then
  1244. Log(ex, "删除单个文件夹可忽略地失败")
  1245. Else
  1246. Throw
  1247. End If
  1248. End Try
  1249. '这个也不靠谱,目录不是空的警告
  1250. 'My.Computer.FileSystem.DeleteDirectory(Path, FileIO.DeleteDirectoryOption.DeleteAllContents)
  1251. End Sub
  1252. ''' <summary>
  1253. ''' 复制文件夹,失败会抛出异常。
  1254. ''' </summary>
  1255. Public Sub CopyDirectory(FromPath As String, ToPath As String)
  1256. For Each File In EnumerateFiles(FromPath)
  1257. CopyFile(File.FullName, File.FullName.Replace(FromPath, ToPath))
  1258. Next
  1259. End Sub
  1260. ''' <summary>
  1261. ''' 遍历文件夹中的所有文件。
  1262. ''' </summary>
  1263. Public Function EnumerateFiles(Directory As String) As List(Of FileInfo)
  1264. Dim Dir As New DirectoryInfo(Directory)
  1265. Dim ResultList As New List(Of FileInfo)
  1266. '添加文件
  1267. ResultList.AddRange(Dir.EnumerateFiles)
  1268. '添加文件夹中的文件
  1269. For Each SubDir In Dir.EnumerateDirectories
  1270. ResultList.AddRange(EnumerateFiles(SubDir.FullName))
  1271. Next
  1272. Return ResultList
  1273. End Function
  1274. #End Region
  1275. #Region "文本"
  1276. Public vbLQ As Char = Convert.ToChar(8220)
  1277. Public vbRQ As Char = Convert.ToChar(8221)
  1278. ''' <summary>
  1279. ''' 提取 Exception 摘要。
  1280. ''' </summary>
  1281. ''' <param name="IsLine">输出是否强制为单行,单行模型下不会输出调用堆栈。</param>
  1282. Public Function GetString(Ex As Exception, Optional IsLine As Boolean = True, Optional ShowAllTrace As Boolean = False) As String
  1283. If Ex Is Nothing Then Return "无可用错误信息!"
  1284. Dim Desc As New List(Of String)
  1285. '自动错误判断
  1286. Dim RealEx = Ex
  1287. Do Until RealEx.InnerException Is Nothing
  1288. RealEx = RealEx.InnerException
  1289. Loop
  1290. If TypeOf RealEx Is TypeLoadException OrElse TypeOf RealEx Is MissingMethodException OrElse TypeOf RealEx Is NotImplementedException OrElse TypeOf RealEx Is TypeInitializationException Then
  1291. Desc.Add("系统环境存在问题,请尝试重装 .Net Framework 4.6.2 后再试")
  1292. ElseIf TypeOf RealEx Is UnauthorizedAccessException Then
  1293. Desc.Add("PCL2 权限不足,请尝试右键 PCL2,选择以管理员身份运行")
  1294. ElseIf TypeOf RealEx Is OutOfMemoryException Then
  1295. Desc.Add("电脑运行内存不足,PCL2 无法继续运行")
  1296. End If
  1297. If IsLine Then
  1298. '无内部错误的快速处理
  1299. If Ex.InnerException Is Nothing Then
  1300. If Desc.Count = 0 Then
  1301. Return Ex.Message.Replace(vbCrLf, vbCr).Replace(vbLf, vbCr).Replace(vbCr & vbCr, vbCr).Replace(vbCr, " ")
  1302. Else
  1303. Return Desc.First
  1304. End If
  1305. End If
  1306. '构造输出信息
  1307. Do Until Ex Is Nothing
  1308. Desc.Add(Ex.Message.Replace(vbCrLf, vbCr).Replace(vbLf, vbCr).Replace(vbCr & vbCr, vbCr).Replace(vbCr, " "))
  1309. Ex = Ex.InnerException
  1310. Loop
  1311. Desc.Reverse() '让最深层错误在最左边
  1312. GetString = Join(Desc, " → ")
  1313. Else
  1314. Dim Stack As New List(Of String)
  1315. '逐级追加描述与堆栈
  1316. Do Until Ex Is Nothing
  1317. Desc.Add(Ex.Message.Replace(vbCrLf, vbCr).Replace(vbLf, vbCr).Replace(vbCr & vbCr, vbCr).Replace(vbCr, vbCrLf))
  1318. If Ex.StackTrace IsNot Nothing Then
  1319. For Each St As String In Ex.StackTrace.Split(vbCrLf)
  1320. If ShowAllTrace OrElse St.ToLower.Contains("pcl") Then Stack.Add(St.Replace(vbCr, String.Empty).Replace(vbLf, String.Empty))
  1321. Next
  1322. End If
  1323. Ex = Ex.InnerException
  1324. Loop
  1325. '构造输出信息
  1326. Dim TypeName As String = RealEx.GetType.FullName
  1327. GetString = Join(Desc, vbCrLf & "Caused By: ") & If(Stack.Count > 0, vbCrLf & Join(Stack, vbCrLf), "") & If(TypeName = "System.Exception", "", vbCrLf & "错误类型:" & TypeName)
  1328. End If
  1329. End Function
  1330. ''' <summary>
  1331. ''' 返回一个枚举对应的字符串。
  1332. ''' </summary>
  1333. ''' <param name="EnumData">一个已经实例化的枚举类型。</param>
  1334. Public Function GetStringFromEnum(EnumData As [Enum]) As String
  1335. Return [Enum].GetName(EnumData.GetType, EnumData)
  1336. End Function
  1337. ''' <summary>
  1338. ''' 将文件大小转化为适合的文本形式,如“1.28 M”。
  1339. ''' </summary>
  1340. ''' <param name="FileSize">以字节为单位的大小表示。</param>
  1341. Public Function GetString(FileSize As Long) As String
  1342. If FileSize < 1000 Then
  1343. 'B 级
  1344. Return FileSize & " B"
  1345. ElseIf FileSize < 1024 * 1000 Then
  1346. 'K 级
  1347. Dim RoundResult As String = Math.Round(FileSize / 1024)
  1348. Return Math.Round(FileSize / 1024, CInt(MathRange(3 - RoundResult.Length, 0, 2))) & " K"
  1349. ElseIf FileSize < 1024 * 1024 * 1000 Then
  1350. 'M 级
  1351. Dim RoundResult As String = Math.Round(FileSize / 1024 / 1024)
  1352. Return Math.Round(FileSize / 1024 / 1024, CInt(MathRange(3 - RoundResult.Length, 0, 2))) & " M"
  1353. Else
  1354. 'G 级
  1355. Dim RoundResult As String = Math.Round(FileSize / 1024 / 1024 / 1024)
  1356. Return Math.Round(FileSize / 1024 / 1024 / 1024, CInt(MathRange(3 - RoundResult.Length, 0, 2))) & " G"
  1357. End If
  1358. End Function
  1359. ''' <summary>
  1360. ''' 获取 Json 对象。
  1361. ''' </summary>
  1362. Public Function GetJson(Data As String)
  1363. Try
  1364. Return JsonConvert.DeserializeObject(Data, New JsonSerializerSettings With {.DateTimeZoneHandling = DateTimeZoneHandling.Local})
  1365. Catch ex As Exception
  1366. Throw New Exception("格式化 Json 对象失败:" & If(If(Data, "").Length > 10000, Data.Substring(0, 100) & "...", Data))
  1367. End Try
  1368. End Function
  1369. ''' <summary>
  1370. ''' 将字符串统一至某个长度,过短则以 Code 将其右侧填充,过长则截取靠左的指定长度。
  1371. ''' </summary>
  1372. Public Function StrFill(Str As String, Code As String, Length As Byte) As String
  1373. If Str.Length > Length Then Return Mid(Str, 1, Length)
  1374. Return Mid(Str.PadRight(Length, Code), Str.Length + 1) & Str
  1375. End Function
  1376. ''' <summary>
  1377. ''' 将一个小数显示为固定的小数点后位数形式,将向零取整。
  1378. ''' 如 12 保留 2 位则输出 12.00,而 95.678 保留 2 位则输出 95.67。
  1379. ''' </summary>
  1380. Public Function StrFillNum(Num As Double, Length As Integer) As String
  1381. Num = Math.Round(Num, Length, MidpointRounding.AwayFromZero)
  1382. StrFillNum = Num
  1383. If Not StrFillNum.Contains(".") Then Return (StrFillNum & ".").PadRight(StrFillNum.Length + 1 + Length, "0")
  1384. Return StrFillNum.PadRight(StrFillNum.Split(".")(0).Length + 1 + Length, "0")
  1385. End Function
  1386. ''' <summary>
  1387. ''' 移除字符串首尾的标点符号、回车,以及括号中、冒号后的补充说明内容。
  1388. ''' </summary>
  1389. Public Function StrTrim(Str As String, Optional RemoveQuote As Boolean = True)
  1390. If RemoveQuote Then Str = Str.Split("(")(0).Split(":")(0).Split("(")(0).Split(":")(0)
  1391. Return Str.Trim(".", "。", "!", " ", "!", "?", "?", vbCr, vbLf)
  1392. End Function
  1393. ''' <summary>
  1394. ''' 连接字符串。
  1395. ''' </summary>
  1396. Public Function Join(List As ICollection, Split As String) As String
  1397. Dim Builder As New StringBuilder
  1398. Dim LastCount As Integer = List.Count - 1
  1399. For i = 0 To LastCount
  1400. If List(i) IsNot Nothing Then Builder.Append(List(i))
  1401. If i <> LastCount Then Builder.Append(Split)
  1402. Next
  1403. Return Builder.ToString
  1404. End Function
  1405. ''' <summary>
  1406. ''' 获取字符串哈希值。
  1407. ''' </summary>
  1408. Public Function GetHash(Str As String) As ULong
  1409. GetHash = 5381
  1410. For i = 0 To Str.Length - 1
  1411. GetHash = (GetHash << 5) Xor GetHash Xor CType(AscW(Str(i)), ULong)
  1412. Next
  1413. Return GetHash Xor &HA98F501BC684032FUL
  1414. End Function
  1415. ''' <summary>
  1416. ''' 获取字符串 MD5。
  1417. ''' </summary>
  1418. Public Function GetStringMD5(Str As String) As String
  1419. Dim md5Hasher As New MD5CryptoServiceProvider
  1420. Dim hashedDataBytes As Byte()
  1421. hashedDataBytes = md5Hasher.ComputeHash(Encoding.GetEncoding("gb2312").GetBytes(Str))
  1422. Dim tmp As New StringBuilder()
  1423. For Each i As Byte In hashedDataBytes
  1424. tmp.Append(i.ToString("x2"))
  1425. Next
  1426. Return tmp.ToString()
  1427. End Function
  1428. ''' <summary>
  1429. ''' 输入 And 字符不会报错的 Val。
  1430. ''' </summary>
  1431. Public Function Val(Str As Object) As Double
  1432. Return If(TypeOf Str Is String AndAlso Str = "&", 0, Conversion.Val(Str))
  1433. End Function
  1434. '转义
  1435. ''' <summary>
  1436. ''' 为字符串进行 XML 转义。
  1437. ''' </summary>
  1438. Public Function EscapeXML(Str As String) As String
  1439. Return Str.Replace("&", "&amp;").Replace("<", "&lt;").Replace(">", "&gt;").Replace("'", "&apos;").Replace("""", "&quot;")
  1440. End Function
  1441. '正则
  1442. ''' <summary>
  1443. ''' 搜索字符串中的所有正则匹配项。
  1444. ''' </summary>
  1445. Public Function RegexSearch(str As String, regex As String, Optional options As RegularExpressions.RegexOptions = RegularExpressions.RegexOptions.None) As List(Of String)
  1446. Try
  1447. RegexSearch = New List(Of String)
  1448. Dim RegexSearchRes = New RegularExpressions.Regex(regex, options).Matches(str)
  1449. If RegexSearchRes Is Nothing Then Return RegexSearch
  1450. For Each item As RegularExpressions.Match In RegexSearchRes
  1451. RegexSearch.Add(item.Value)
  1452. Next
  1453. Catch ex As Exception
  1454. Log(ex, "正则匹配全部项出错")
  1455. Return New List(Of String)
  1456. End Try
  1457. End Function
  1458. ''' <summary>
  1459. ''' 获取字符串中的第一个正则匹配项,若无匹配则返回 Nothing。
  1460. ''' </summary>
  1461. Public Function RegexSeek(str As String, regex As String, Optional options As RegularExpressions.RegexOptions = RegularExpressions.RegexOptions.None) As String
  1462. Try
  1463. Dim Result = RegularExpressions.Regex.Match(str, regex, options).Value
  1464. Return If(Result = "", Nothing, Result)
  1465. Catch ex As Exception
  1466. Log(ex, "正则匹配第一项出错")
  1467. Return Nothing
  1468. End Try
  1469. End Function
  1470. ''' <summary>
  1471. ''' 检查字符串是否匹配某正则模式。
  1472. ''' </summary>
  1473. Public Function RegexCheck(str As String, regex As String, Optional options As RegularExpressions.RegexOptions = RegularExpressions.RegexOptions.None) As Boolean
  1474. Try
  1475. Return RegularExpressions.Regex.IsMatch(str, regex, options)
  1476. Catch ex As Exception
  1477. Log(ex, "正则检查出错")
  1478. Return False
  1479. End Try
  1480. End Function
  1481. ''' <summary>
  1482. ''' 进行正则替换,会抛出错误。
  1483. ''' </summary>
  1484. Public Function RegexReplace(Input As String, Replacement As String, Regex As String, Optional options As RegularExpressions.RegexOptions = RegularExpressions.RegexOptions.None) As String
  1485. Return RegularExpressions.Regex.Replace(Input, Regex, Replacement, options)
  1486. End Function
  1487. #End Region
  1488. #Region "搜索"
  1489. ''' <summary>
  1490. ''' 获取搜索文本的相似度。
  1491. ''' </summary>
  1492. ''' <param name="Source">被搜索的长内容。</param>
  1493. ''' <param name="Query">用户输入的搜索文本。</param>
  1494. Private Function SearchSimilarity(Source As String, Query As String) As Double
  1495. Dim qp As Integer = 0, lenSum As Double = 0
  1496. Source = Source.ToLower.Replace(" ", "")
  1497. Query = Query.ToLower.Replace(" ", "")
  1498. Dim sourceLength As Integer = Source.Length, queryLength As Integer = Query.Length '用于计算最后因数的长度缓存
  1499. Do While qp < Query.Length
  1500. '对 qp 作为开始位置计算
  1501. Dim sp As Integer = 0, lenMax As Integer = 0, spMax As Integer = 0
  1502. '查找以 qp 为头的最大子串
  1503. Do While sp < Source.Length
  1504. '对每个 sp 作为开始位置计算最大子串
  1505. Dim len As Integer = 0
  1506. Do While (qp + len) < Query.Length AndAlso (sp + len) < Source.Length AndAlso Source(sp + len) = Query(qp + len)
  1507. len += 1
  1508. Loop
  1509. '存储 len
  1510. If len > lenMax Then
  1511. lenMax = len
  1512. spMax = sp
  1513. End If
  1514. '根据结果增加 sp
  1515. sp += Math.Max(1, len)
  1516. Loop
  1517. If lenMax > 0 Then
  1518. Source = Source.Substring(0, spMax) & If(Source.Count > spMax + lenMax, Source.Substring(spMax + lenMax), String.Empty) '将源中的对应字段替换空
  1519. '存储 lenSum
  1520. Dim IncWeight = (Math.Pow(1.4, 3 + lenMax) - 3.6) '根据长度加成
  1521. IncWeight *= (1 + 0.3 * Math.Max(0, 3 - Math.Abs(qp - spMax))) '根据位置加成
  1522. lenSum += IncWeight
  1523. End If
  1524. '根据结果增加 qp
  1525. qp += Math.Max(1, lenMax)
  1526. Loop
  1527. '计算结果:重复字段量 × 源长度影响比例
  1528. Return (lenSum / queryLength) * (3 / Math.Pow(sourceLength + 15, 0.5)) * If(queryLength <= 2, 3 - queryLength, 1)
  1529. End Function
  1530. ''' <summary>
  1531. ''' 获取多段文本加权后的相似度。
  1532. ''' </summary>
  1533. Private Function SearchSimilarityWeighted(Source As List(Of KeyValuePair(Of String, Double)), Query As String) As Double
  1534. Dim TotalWeight As Double = 0
  1535. Dim Sum As Double = 0
  1536. For Each Pair In Source
  1537. Sum += SearchSimilarity(Pair.Key, Query) * Pair.Value
  1538. TotalWeight += Pair.Value
  1539. Next
  1540. Return Sum / TotalWeight
  1541. End Function
  1542. ''' <summary>
  1543. ''' 用于搜索的项目。
  1544. ''' </summary>
  1545. Public Class SearchEntry(Of T)
  1546. ''' <summary>
  1547. ''' 该项目对应的源数据。
  1548. ''' </summary>
  1549. Public Item As T
  1550. ''' <summary>
  1551. ''' 该项目用于搜索的源。
  1552. ''' </summary>
  1553. Public SearchSource As List(Of KeyValuePair(Of String, Double))
  1554. ''' <summary>
  1555. ''' 相似度。
  1556. ''' </summary>
  1557. Public Similarity As Double
  1558. ''' <summary>
  1559. ''' 是否完全匹配。
  1560. ''' </summary>
  1561. Public AbsoluteRight As Boolean
  1562. End Class
  1563. ''' <summary>
  1564. ''' 进行多段文本加权搜索,获取相似度较高的数项结果。
  1565. ''' </summary>
  1566. ''' <param name="MaxBlurCount">返回的最大模糊结果数。</param>
  1567. ''' <param name="MinBlurSimilarity">返回结果要求的最低相似度。</param>
  1568. Public Function Search(Of T)(Entries As List(Of SearchEntry(Of T)), Query As String, Optional MaxBlurCount As Integer = 5, Optional MinBlurSimilarity As Double = 0.1) As List(Of SearchEntry(Of T))
  1569. '初始化
  1570. Dim ResultList As New List(Of SearchEntry(Of T))
  1571. If Entries.Count = 0 Then Return ResultList
  1572. '进行搜索,获取相似信息
  1573. For Each Entry In Entries
  1574. Entry.Similarity = SearchSimilarityWeighted(Entry.SearchSource, Query)
  1575. Entry.AbsoluteRight = False
  1576. For Each Pair In Entry.SearchSource
  1577. If Pair.Key.ToLower.Replace(" ", "").Contains(Query.ToLower.Replace(" ", "")) Then Entry.AbsoluteRight = True
  1578. Next
  1579. Next
  1580. '按照相似度进行排序
  1581. Entries = Sort(Entries, Function(Left As SearchEntry(Of T), Right As SearchEntry(Of T)) As Boolean
  1582. If Left.AbsoluteRight Xor Right.AbsoluteRight Then
  1583. Return Left.AbsoluteRight
  1584. Else
  1585. Return Left.Similarity > Right.Similarity
  1586. End If
  1587. End Function)
  1588. '返回结果
  1589. Dim BlurCount As Integer = 0
  1590. For Each Entry In Entries
  1591. If Entry.AbsoluteRight Then
  1592. ResultList.Add(Entry) '完全匹配,直接加入
  1593. Else
  1594. If Entry.Similarity < MinBlurSimilarity OrElse BlurCount = MaxBlurCount Then Exit For '模糊结果边界条件
  1595. ResultList.Add(Entry)
  1596. BlurCount += 1 '模糊结果计数
  1597. End If
  1598. Next
  1599. Return ResultList
  1600. End Function
  1601. #End Region
  1602. #Region "系统"
  1603. ''' <summary>
  1604. ''' 当前程序是否拥有管理员权限。
  1605. ''' </summary>
  1606. Public Function IsAdmin() As Boolean
  1607. Dim id As WindowsIdentity = WindowsIdentity.GetCurrent()
  1608. Dim principal As New WindowsPrincipal(id)
  1609. Return principal.IsInRole(WindowsBuiltInRole.Administrator)
  1610. End Function
  1611. ''' <summary>
  1612. ''' 以管理员权限重新运行当前程序。返回是否成功。
  1613. ''' </summary>
  1614. Public Function RerunAsAdmin(Argument As String) As Boolean
  1615. Try
  1616. Process.Start(New ProcessStartInfo(PathWithName) With {.Verb = "runas", .Arguments = Argument})
  1617. Return True
  1618. Catch ex As Exception
  1619. Log(ex, "以管理员权限运行程序失败")
  1620. Return False
  1621. End Try
  1622. End Function
  1623. Private Uuid As Integer = 1
  1624. Private UuidLock As Object
  1625. ''' <summary>
  1626. ''' 获取一个全程序内不会重复的数字(伪 Uuid)。
  1627. ''' </summary>
  1628. Public Function GetUuid() As Integer
  1629. If UuidLock Is Nothing Then UuidLock = New Object
  1630. SyncLock UuidLock
  1631. Uuid += 1
  1632. Return Uuid
  1633. End SyncLock
  1634. End Function
  1635. ''' <summary>
  1636. ''' 将元素与 List 的混合体拆分为元素组。
  1637. ''' </summary>
  1638. Public Function GetFullList(Of T)(data As IList) As List(Of T)
  1639. GetFullList = New List(Of T)
  1640. For i = 0 To data.Count - 1
  1641. If TypeOf data(i) Is ICollection Then
  1642. GetFullList.AddRange(data(i))
  1643. Else
  1644. GetFullList.Add(data(i))
  1645. End If
  1646. Next i
  1647. End Function
  1648. ''' <summary>
  1649. ''' 数组去重。
  1650. ''' </summary>
  1651. Public Function ArrayNoDouble(Of T)(Arr As T(), Optional IsEqual As CompareThreadStart = Nothing) As T()
  1652. Dim ResultArray As New List(Of T)
  1653. For i = 0 To UBound(Arr)
  1654. For ii = i + 1 To UBound(Arr)
  1655. If IsEqual Is Nothing Then
  1656. If Arr(i).Equals(Arr(ii)) Then GoTo NextElement
  1657. Else
  1658. If IsEqual(Arr(i), Arr(ii)) Then GoTo NextElement
  1659. End If
  1660. Next
  1661. ResultArray.Add(Arr(i))
  1662. NextElement:
  1663. Next i
  1664. Return ResultArray.ToArray
  1665. End Function
  1666. ''' <summary>
  1667. ''' 数组去重。
  1668. ''' </summary>
  1669. Public Function ArrayNoDouble(Of T)(Arr As List(Of T), Optional IsEqual As CompareThreadStart = Nothing) As List(Of T)
  1670. Dim ResultArray As New List(Of T)
  1671. For i = 0 To Arr.Count - 1
  1672. For ii = i + 1 To Arr.Count - 1
  1673. If IsEqual Is Nothing Then
  1674. If Arr(i).Equals(Arr(ii)) Then GoTo NextElement
  1675. Else
  1676. If IsEqual(Arr(i), Arr(ii)) Then GoTo NextElement
  1677. End If
  1678. Next
  1679. ResultArray.Add(Arr(i))
  1680. NextElement:
  1681. Next i
  1682. Return ResultArray
  1683. End Function
  1684. ''' <summary>
  1685. ''' 若 Key 不存在于辞典,则加入辞典。
  1686. ''' 若 Key 已存在于辞典,则更新 Value。
  1687. ''' </summary>
  1688. Public Sub DictionaryAdd(Of TKey, TValue)(ByRef Dict As Dictionary(Of TKey, TValue), Key As TKey, Value As TValue)
  1689. If Dict.ContainsKey(Key) Then
  1690. Dict(Key) = Value
  1691. Else
  1692. Dict.Add(Key, Value)
  1693. End If
  1694. End Sub
  1695. ''' <summary>
  1696. ''' 获取格式类似于“11:08:52.037”的当前时间的字符串。
  1697. ''' </summary>
  1698. Public Function GetTimeNow() As String
  1699. Return Date.Now.ToString("HH:mm:ss.fff")
  1700. End Function
  1701. ''' <summary>
  1702. ''' 获取系统运行时间(毫秒),保证为正 Long 且大于 1,但可能突变减小。
  1703. ''' </summary>
  1704. Public Function GetTimeTick() As Long
  1705. Return My.Computer.Clock.TickCount + 2147483651L
  1706. End Function
  1707. ''' <summary>
  1708. ''' 将时间间隔转换为类似“5 分 10 秒前”的易于阅读的形式。
  1709. ''' </summary>
  1710. Public Function GetTimeSpanString(Span As TimeSpan) As String
  1711. Dim EndFix = If(Span.TotalMilliseconds > 0, "后", "前")
  1712. If Span.TotalMilliseconds < 0 Then Span = -Span
  1713. Dim TotalMonthes = Math.Floor(Span.Days / 30)
  1714. If TotalMonthes >= 61 Then
  1715. '5+ 年,“5 年”
  1716. GetTimeSpanString = Math.Floor(TotalMonthes / 12) & " 年"
  1717. ElseIf TotalMonthes >= 12 Then
  1718. '12~60 月,“1 年 2 个月”
  1719. GetTimeSpanString = Math.Floor(TotalMonthes / 12) & " 年" & If((TotalMonthes Mod 12) > 0, " " & (TotalMonthes Mod 12) & " 个月", "")
  1720. ElseIf TotalMonthes >= 4 Then
  1721. '4~11 月,“5 月”
  1722. GetTimeSpanString = TotalMonthes & " 月"
  1723. ElseIf TotalMonthes >= 1 Then
  1724. '1~4 月,“2 月 13 天”
  1725. GetTimeSpanString = TotalMonthes & " 月" & If((Span.Days Mod 30) > 0, " " & (Span.Days Mod 30) & " 天", "")
  1726. ElseIf Span.TotalDays >= 4 Then
  1727. '4~30 天,“23 天”
  1728. GetTimeSpanString = Span.Days & " 天"
  1729. ElseIf Span.TotalDays >= 1 Then
  1730. '1~3 天,“2 天 20 小时”
  1731. GetTimeSpanString = Span.Days & " 天" & If(Span.Hours > 0, " " & Span.Hours & " 小时", "")
  1732. ElseIf Span.TotalHours >= 10 Then
  1733. '10 小时 ~ 1 天,“15 小时”
  1734. GetTimeSpanString = Span.Hours & " 小时"
  1735. ElseIf Span.TotalHours >= 1 Then
  1736. '1~10 小时,“1 小时 20 分钟”
  1737. GetTimeSpanString = Span.Hours & " 小时" & If(Span.Minutes > 0, " " & Span.Minutes & " 分钟", "")
  1738. ElseIf Span.TotalMinutes >= 10 Then
  1739. '10 分钟 ~ 1 小时,“49 分钟”
  1740. GetTimeSpanString = Span.Minutes & " 分钟"
  1741. ElseIf Span.TotalMinutes >= 1 Then
  1742. '1~10 分钟,“9 分 23 秒”
  1743. GetTimeSpanString = Span.Minutes & " 分" & If(Span.Seconds > 0, " " & Span.Seconds & " 秒", "")
  1744. ElseIf Span.TotalSeconds >= 1 Then
  1745. '1 秒 ~ 1 分钟,“23 秒”
  1746. GetTimeSpanString = Span.Seconds & " 秒"
  1747. Else
  1748. '不到 1 秒
  1749. GetTimeSpanString = "1 秒"
  1750. End If
  1751. GetTimeSpanString += EndFix
  1752. End Function
  1753. ''' <summary>
  1754. ''' 获取十进制 Unix 时间戳。
  1755. ''' </summary>
  1756. Public Function GetUnixTimestamp() As Long
  1757. Return (Now.ToUniversalTime().Ticks - 621355968000000000) / 10000000
  1758. End Function
  1759. ''' <summary>
  1760. ''' 用于储存 RaiseByMouse 的 EventArgs。
  1761. ''' </summary>
  1762. Public NotInheritable Class RouteEventArgs
  1763. Inherits EventArgs
  1764. Public RaiseByMouse As Boolean
  1765. Public Handled As Boolean = False
  1766. Public Sub New(Optional RaiseByMouse As Boolean = False)
  1767. Me.RaiseByMouse = RaiseByMouse
  1768. End Sub
  1769. End Class
  1770. ''' <summary>
  1771. ''' 前台运行文件。
  1772. ''' </summary>
  1773. ''' <param name="FileName">文件名。可以为“notepad”等缩写。</param>
  1774. ''' <param name="Arguments">运行参数。</param>
  1775. Public Sub ShellOnly(FileName As String, Optional Arguments As String = "")
  1776. Using Program As New Process
  1777. Program.StartInfo.Arguments = Arguments
  1778. Program.StartInfo.FileName = FileName
  1779. Log("[System] 执行外部命令:" & FileName & " " & Arguments)
  1780. Program.Start()
  1781. End Using
  1782. End Sub
  1783. ''' <summary>
  1784. ''' 前台运行文件并返回返回值。
  1785. ''' </summary>
  1786. ''' <param name="FileName">文件名。可以为“notepad”等缩写。</param>
  1787. ''' <param name="Arguments">运行参数。</param>
  1788. ''' <param name="Timeout">等待该程序结束的最长时间(毫秒)。超时会返回 Result.Timeout。</param>
  1789. Public Function ShellAndGetExitCode(FileName As String, Optional Arguments As String = "", Optional Timeout As Integer = 1000000) As Result
  1790. Try
  1791. Using Program As New Process
  1792. Program.StartInfo.Arguments = Arguments
  1793. Program.StartInfo.FileName = FileName
  1794. Log("[System] 执行外部命令并等待返回码:" & FileName & " " & Arguments)
  1795. Program.Start()
  1796. If Program.WaitForExit(Timeout) Then
  1797. Return Program.ExitCode
  1798. Else
  1799. Return Result.Timeout
  1800. End If
  1801. End Using
  1802. Catch ex As Exception
  1803. Log(ex, "执行命令失败:" & FileName, LogLevel.Msgbox)
  1804. Return Result.Fail
  1805. End Try
  1806. End Function
  1807. ''' <summary>
  1808. ''' 静默运行文件并返回输出流字符串。执行失败会抛出异常。
  1809. ''' </summary>
  1810. ''' <param name="FileName">文件名。可以为“notepad”等缩写。</param>
  1811. ''' <param name="Arguments">运行参数。</param>
  1812. ''' <param name="Timeout">等待该程序结束的最长时间(毫秒)。超时会抛出错误。</param>
  1813. Public Function ShellAndGetOutput(FileName As String, Optional Arguments As String = "", Optional Timeout As Integer = 1000000, Optional WorkingDirectory As String = Nothing) As String
  1814. Dim Info = New ProcessStartInfo With {
  1815. .Arguments = Arguments,
  1816. .FileName = FileName,
  1817. .UseShellExecute = False,
  1818. .CreateNoWindow = True,
  1819. .RedirectStandardError = True,
  1820. .RedirectStandardOutput = True,
  1821. .WorkingDirectory = If(WorkingDirectory, Path.TrimEnd("\"c))
  1822. }
  1823. If WorkingDirectory IsNot Nothing Then
  1824. If Info.EnvironmentVariables.ContainsKey("appdata") Then
  1825. Info.EnvironmentVariables("appdata") = WorkingDirectory
  1826. Else
  1827. Info.EnvironmentVariables.Add("appdata", WorkingDirectory)
  1828. End If
  1829. End If
  1830. Log("[System] 执行外部命令并等待返回结果:" & FileName & " " & Arguments)
  1831. Using Program As New Process() With {.StartInfo = Info}
  1832. Program.Start()
  1833. Program.WaitForExit(Timeout)
  1834. Return Program.StandardOutput.ReadToEnd & Program.StandardError.ReadToEnd
  1835. ' Dim Result As New StringBuilder()
  1836. ' AddHandler process.OutputDataReceived, Function(sender As Object, e As DataReceivedEventArgs)
  1837. ' Try
  1838. ' If e.Data IsNot Nothing Then Result.AppendLine(e.Data)
  1839. ' Finally
  1840. ' End Try
  1841. ' Return Nothing
  1842. ' End Function
  1843. ' AddHandler process.ErrorDataReceived, Function(sender As Object, e As DataReceivedEventArgs)
  1844. ' Try
  1845. ' If e.Data IsNot Nothing Then Result.AppendLine(e.Data)
  1846. ' Finally
  1847. ' End Try
  1848. ' Return Nothing
  1849. ' End Function
  1850. ' process.Start()
  1851. ' process.BeginOutputReadLine()
  1852. ' process.BeginErrorReadLine()
  1853. ' If process.WaitForExit(Timeout) Then
  1854. ' process.Close()
  1855. ' Return Result.ToString
  1856. ' Else
  1857. ' process.Close()
  1858. ' Throw New TimeoutException("程序执行超时,已有返回值:" & Result.ToString)
  1859. ' End If
  1860. End Using
  1861. End Function
  1862. ''' <summary>
  1863. ''' 在新的工作线程中执行代码。
  1864. ''' </summary>
  1865. Public Function RunInNewThread(Action As Action, Name As String, Optional Priority As ThreadPriority = ThreadPriority.Normal) As Thread
  1866. Dim th As New Thread(Sub()
  1867. Try
  1868. Action()
  1869. Catch ex As ThreadInterruptedException
  1870. Log(Name & ":线程已中止")
  1871. Catch ex As Exception
  1872. Log(ex, Name & ":线程执行失败", LogLevel.Feedback)
  1873. End Try
  1874. End Sub) With {.Name = Name, .Priority = Priority}
  1875. th.Start()
  1876. Return th
  1877. End Function
  1878. ''' <summary>
  1879. ''' 确保在 UI 线程中执行代码。
  1880. ''' 如果当前并非 UI 线程,则会阻断当前线程,直至 UI 线程执行完毕。
  1881. ''' 为防止线程互锁,请仅在开始加载动画、从 UI 获取输入时使用!
  1882. ''' </summary>
  1883. Public Function RunInUiWait(Of Output)(Action As Func(Of Output)) As Output
  1884. If RunInUi() Then
  1885. Return Action()
  1886. Else
  1887. Return Application.Current.Dispatcher.Invoke(Action)
  1888. End If
  1889. End Function
  1890. ''' <summary>
  1891. ''' 确保在 UI 线程中执行代码。
  1892. ''' 如果当前并非 UI 线程,则会阻断当前线程,直至 UI 线程执行完毕。
  1893. ''' 为防止线程互锁,请仅在开始加载动画、从 UI 获取输入时使用!
  1894. ''' </summary>
  1895. Public Sub RunInUiWait(Action As Action)
  1896. If RunInUi() Then
  1897. Action()
  1898. Else
  1899. Application.Current.Dispatcher.Invoke(Action)
  1900. End If
  1901. End Sub
  1902. ''' <summary>
  1903. ''' 确保在 UI 线程中执行代码,代码按触发顺序执行。
  1904. ''' 如果当前并非 UI 线程,也不阻断当前线程的执行。
  1905. ''' </summary>
  1906. Public Sub RunInUi(Action As Action, Optional ForceWaitUntilLoaded As Boolean = False)
  1907. If ForceWaitUntilLoaded Then
  1908. Application.Current.Dispatcher.InvokeAsync(Action, Threading.DispatcherPriority.Loaded)
  1909. ElseIf RunInUi() Then
  1910. Action()
  1911. Else
  1912. Application.Current.Dispatcher.InvokeAsync(Action)
  1913. End If
  1914. End Sub
  1915. ''' <summary>
  1916. ''' 确保在工作线程中执行代码。
  1917. ''' </summary>
  1918. Public Sub RunInThread(Action As Action)
  1919. If RunInUi() Then
  1920. RunInNewThread(Action, "Runtime Invoke " & GetUuid() & "#")
  1921. Else
  1922. Action()
  1923. End If
  1924. End Sub
  1925. ''' <summary>
  1926. ''' 按照既定的函数进行选择排序。
  1927. ''' </summary>
  1928. ''' <param name="SortRule">传入两个对象,若第一个对象应该排在前面,则返回 True。</param>
  1929. Public Function Sort(Of T)(List As IList(Of T), SortRule As CompareThreadStart) As List(Of T)
  1930. Dim NewList As New List(Of T)
  1931. While List.Count > 0
  1932. Dim Highest = List(0)
  1933. For i = 1 To List.Count - 1
  1934. If SortRule(List(i), Highest) Then Highest = List(i)
  1935. Next
  1936. List.Remove(Highest)
  1937. NewList.Add(Highest)
  1938. End While
  1939. Return NewList
  1940. End Function
  1941. Public Delegate Function CompareThreadStart(Left, Right) As Boolean
  1942. ''' <summary>
  1943. ''' 获取程序启动参数。
  1944. ''' </summary>
  1945. ''' <param name="Name">参数名。</param>
  1946. ''' <param name="DefaultValue">默认值。</param>
  1947. Public Function GetProgramArgument(Name As String, Optional DefaultValue As Object = "")
  1948. Dim AllArguments() As String = Command.Split(" ")
  1949. For i = 0 To AllArguments.Length - 1
  1950. If AllArguments(i) = "-" & Name Then
  1951. If AllArguments.Length = i + 1 OrElse AllArguments(i + 1).StartsWith("-") Then Return True
  1952. Return AllArguments(i + 1)
  1953. End If
  1954. Next
  1955. Return DefaultValue
  1956. End Function
  1957. ''' <summary>
  1958. ''' 时间戳转化为日期。
  1959. ''' </summary>
  1960. Public Function GetDate(timeStamp As Integer) As Date
  1961. Dim dtStart As Date = TimeZone.CurrentTimeZone.ToLocalTime(New Date(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc))
  1962. Dim lTime As Long = (CLng(timeStamp) * 10000000)
  1963. Return dtStart.Add(New TimeSpan(lTime))
  1964. End Function
  1965. ''' <summary>
  1966. ''' 将 UTC 时间转化为当前时区的时间。
  1967. ''' </summary>
  1968. Public Function GetLocalTime(UtcDate As Date) As Date
  1969. Return DateTime.SpecifyKind(UtcDate, DateTimeKind.Utc).ToLocalTime
  1970. End Function
  1971. ''' <summary>
  1972. ''' 打开网页。
  1973. ''' </summary>
  1974. Public Sub OpenWebsite(Url As String)
  1975. Try
  1976. Log("[System] 正在打开网页:" & Url)
  1977. Process.Start(Url)
  1978. Catch ex As Exception
  1979. Log(ex, "无法打开网页(" & Url & ")")
  1980. ClipboardSet(Url, False)
  1981. MyMsgBox("可能由于浏览器未正确配置,PCL2 无法为你打开网页。" & vbCrLf & "网址已经复制到剪贴板,若有需要可以手动粘贴访问。", "无法打开网页")
  1982. End Try
  1983. End Sub
  1984. ''' <summary>
  1985. ''' 打开 explorer。注意参数中的路径要尽量加上双引号!
  1986. ''' </summary>
  1987. Public Sub OpenExplorer(Argument As String)
  1988. Try
  1989. ShellOnly("explorer.exe", Argument)
  1990. Catch ex As Exception
  1991. Log(ex, "打开资源管理器失败,请尝试关闭安全软件(如 360 安全卫士)", LogLevel.Msgbox)
  1992. End Try
  1993. End Sub
  1994. ''' <summary>
  1995. ''' 设置剪贴板。将在另一线程运行,且不会抛出异常。
  1996. ''' </summary>
  1997. Public Sub ClipboardSet(Text As String, Optional ShowSuccessHint As Boolean = True)
  1998. RunInThread(Sub()
  1999. Dim RetryCount As Integer = 0
  2000. Retry:
  2001. Try
  2002. RunInUi(Sub()
  2003. My.Computer.Clipboard.Clear()
  2004. My.Computer.Clipboard.SetText(Text)
  2005. End Sub)
  2006. Catch ex As Exception
  2007. RetryCount += 1
  2008. If RetryCount <= 5 Then
  2009. Thread.Sleep(20)
  2010. GoTo Retry
  2011. Else
  2012. Log(ex, "可能由于剪贴板被其他程序占用,文本复制失败", LogLevel.Hint)
  2013. End If
  2014. End Try
  2015. If ShowSuccessHint Then Hint("已成功复制!", HintType.Finish)
  2016. End Sub)
  2017. End Sub
  2018. ''' <summary>
  2019. ''' 以 Byte() 形式获取程序中的资源。
  2020. ''' </summary>
  2021. Public Function GetResources(ResourceName As String) As Byte()
  2022. Log("[System] 获取资源:" & ResourceName)
  2023. Dim Raw As Byte() = My.Resources.ResourceManager.GetObject(ResourceName)
  2024. Return Raw
  2025. End Function
  2026. #End Region
  2027. #Region "UI"
  2028. '边距改变
  2029. ''' <summary>
  2030. ''' 相对增减控件的左边距。
  2031. ''' </summary>
  2032. Public Sub DeltaLeft(control As FrameworkElement, newValue As Double)
  2033. '安全性检查
  2034. DebugAssert(Not Double.IsNaN(newValue))
  2035. DebugAssert(Not Double.IsInfinity(newValue))
  2036. If TypeOf control Is Window Then
  2037. '窗口改变
  2038. CType(control, Window).Left += newValue
  2039. Else
  2040. '根据 HorizontalAlignment 改变数值
  2041. Select Case control.HorizontalAlignment
  2042. Case HorizontalAlignment.Left, HorizontalAlignment.Stretch
  2043. control.Margin = New Thickness(control.Margin.Left + newValue, control.Margin.Top, control.Margin.Right, control.Margin.Bottom)
  2044. Case HorizontalAlignment.Right
  2045. control.Margin = New Thickness(control.Margin.Left, control.Margin.Top, control.Margin.Right - newValue, control.Margin.Bottom)
  2046. 'control.Margin = New Thickness(control.Margin.Left, control.Margin.Top, CType(control.Parent, Object).ActualWidth - control.ActualWidth - newValue, control.Margin.Bottom)
  2047. Case Else
  2048. DebugAssert(False)
  2049. End Select
  2050. End If
  2051. End Sub
  2052. ''' <summary>
  2053. ''' 设置控件的左边距。(仅针对置左控件)
  2054. ''' </summary>
  2055. Public Sub SetLeft(control As FrameworkElement, newValue As Double)
  2056. DebugAssert(control.HorizontalAlignment = HorizontalAlignment.Left)
  2057. control.Margin = New Thickness(newValue, control.Margin.Top, control.Margin.Right, control.Margin.Bottom)
  2058. End Sub
  2059. ''' <summary>
  2060. ''' 相对增减控件的上边距。
  2061. ''' </summary>
  2062. Public Sub DeltaTop(control As FrameworkElement, newValue As Double)
  2063. '安全性检查
  2064. DebugAssert(Not Double.IsNaN(newValue))
  2065. DebugAssert(Not Double.IsInfinity(newValue))
  2066. If TypeOf control Is Window Then
  2067. '窗口改变
  2068. CType(control, Window).Top += newValue
  2069. Else
  2070. '根据 VerticalAlignment 改变数值
  2071. Select Case control.VerticalAlignment
  2072. Case VerticalAlignment.Top
  2073. control.Margin = New Thickness(control.Margin.Left, control.Margin.Top + newValue, control.Margin.Right, control.Margin.Bottom)
  2074. Case VerticalAlignment.Bottom
  2075. control.Margin = New Thickness(control.Margin.Left, control.Margin.Top, control.Margin.Right, control.Margin.Bottom - newValue)
  2076. 'control.Margin = New Thickness(control.Margin.Left, control.Margin.Top, CType(control.Parent, Object).ActualWidth - control.ActualWidth - newValue, control.Margin.Bottom)
  2077. Case Else
  2078. DebugAssert(False)
  2079. End Select
  2080. End If
  2081. 'If Double.IsNaN(newValue) OrElse Double.IsInfinity(newValue) Then Exit Sub '安全性检查
  2082. 'Select Case control.VerticalAlignment
  2083. ' Case VerticalAlignment.Top, VerticalAlignment.Stretch, VerticalAlignment.Center
  2084. ' control.Margin = New Thickness(control.Margin.Left, newValue, control.Margin.Right, control.Margin.Bottom)
  2085. ' Case VerticalAlignment.Bottom
  2086. ' control.Margin = New Thickness(control.Margin.Left, control.Margin.Top, control.Margin.Right, -newValue)
  2087. ' 'control.Margin = New Thickness(control.Margin.Left, control.Margin.Top, control.Margin.Right, CType(control.Parent, Object).ActualHeight - control.ActualHeight - newValue)
  2088. 'End Select
  2089. End Sub
  2090. ''' <summary>
  2091. ''' 设置控件的顶边距。(仅针对置上控件)
  2092. ''' </summary>
  2093. Public Sub SetTop(control As FrameworkElement, newValue As Double)
  2094. DebugAssert(control.VerticalAlignment = VerticalAlignment.Top)
  2095. control.Margin = New Thickness(control.Margin.Left, newValue, control.Margin.Right, control.Margin.Bottom)
  2096. End Sub
  2097. 'DPI 转换
  2098. Public ReadOnly DPI As Integer = System.Drawing.Graphics.FromHwnd(IntPtr.Zero).DpiX
  2099. ''' <summary>
  2100. ''' 将经过 DPI 缩放的 WPF 尺寸转化为实际的像素尺寸。
  2101. ''' </summary>
  2102. Public Function GetPixelSize(WPFSize As Double) As Double
  2103. Return WPFSize / 96 * DPI
  2104. End Function
  2105. ''' <summary>
  2106. ''' 将实际的像素尺寸转化为经过 DPI 缩放的 WPF 尺寸。
  2107. ''' </summary>
  2108. Public Function GetWPFSize(PixelSize As Double) As Double
  2109. Return PixelSize * 96 / DPI
  2110. End Function
  2111. 'UI 截图
  2112. ''' <summary>
  2113. ''' 将某个控件的呈现转换为图片。
  2114. ''' </summary>
  2115. Public Function ControlBrush(UI As FrameworkElement) As ImageBrush
  2116. Dim Width = UI.ActualWidth, Height = UI.ActualHeight
  2117. If Width < 1 OrElse Height < 1 Then Return New ImageBrush
  2118. Dim bmp As New RenderTargetBitmap(GetPixelSize(Width), GetPixelSize(Height), DPI, DPI, PixelFormats.Pbgra32)
  2119. bmp.Render(UI)
  2120. Return New ImageBrush(bmp)
  2121. End Function
  2122. ''' <summary>
  2123. ''' 将某个控件的模拟呈现转换为图片。
  2124. ''' </summary>
  2125. Public Function ControlBrush(UI As FrameworkElement, Width As Double, Height As Double, Optional Left As Double = 0, Optional Top As Double = 0) As ImageBrush
  2126. UI.Measure(New Size(Width, Height))
  2127. UI.Arrange(New Rect(0, 0, Width, Height))
  2128. Dim bmp As New RenderTargetBitmap(GetPixelSize(Width), GetPixelSize(Height), DPI, DPI, PixelFormats.Default)
  2129. bmp.Render(UI)
  2130. If Not (Left = 0 AndAlso Top = 0) Then UI.Arrange(New Rect(Left, Top, Width, Height))
  2131. Return New ImageBrush(bmp)
  2132. End Function
  2133. ''' <summary>
  2134. ''' 将 UI 内容固定为图片并进行 Clear。
  2135. ''' </summary>
  2136. Public Sub ControlFreeze(UI As Panel)
  2137. UI.Background = ControlBrush(UI)
  2138. UI.Children.Clear()
  2139. End Sub
  2140. ''' <summary>
  2141. ''' 将 UI 内容固定为图片并进行 Clear。
  2142. ''' </summary>
  2143. Public Sub ControlFreeze(UI As Border)
  2144. UI.Background = ControlBrush(UI)
  2145. UI.Child = Nothing
  2146. End Sub
  2147. ''' <summary>
  2148. ''' 将 XML 转换为对应 UI 对象。
  2149. ''' </summary>
  2150. Public Function GetObjectFromXML(Str As XElement)
  2151. Return GetObjectFromXML(Str.ToString)
  2152. End Function
  2153. ''' <summary>
  2154. ''' 将 XML 转换为对应 UI 对象。
  2155. ''' </summary>
  2156. Public Function GetObjectFromXML(Str As String)
  2157. Using Stream As New MemoryStream
  2158. Using Writer As New StreamWriter(Stream)
  2159. Writer.Write(Str)
  2160. Writer.Flush()
  2161. Stream.Position = 0
  2162. Return XamlReader.Load(Stream)
  2163. End Using
  2164. End Using
  2165. End Function
  2166. Private ReadOnly UiThreadId As Integer = Thread.CurrentThread.ManagedThreadId
  2167. ''' <summary>
  2168. ''' 当前线程是否为主线程。
  2169. ''' </summary>
  2170. Public Function RunInUi() As Boolean
  2171. Return Thread.CurrentThread.ManagedThreadId = UiThreadId
  2172. End Function
  2173. #End Region
  2174. #Region "Debug"
  2175. Public ModeDebug As Boolean = False
  2176. 'Log
  2177. Public Enum LogLevel
  2178. ''' <summary>
  2179. ''' 不提示,只记录日志。
  2180. ''' </summary>
  2181. Normal = 0
  2182. ''' <summary>
  2183. ''' 只提示开发者。
  2184. ''' </summary>
  2185. Developer = 1
  2186. ''' <summary>
  2187. ''' 只提示开发者与调试模式用户。
  2188. ''' </summary>
  2189. Debug = 2
  2190. ''' <summary>
  2191. ''' 弹出提示所有用户。
  2192. ''' </summary>
  2193. Hint = 3
  2194. ''' <summary>
  2195. ''' 弹窗,不要求反馈。
  2196. ''' </summary>
  2197. Msgbox = 4
  2198. ''' <summary>
  2199. ''' 弹窗,要求反馈。
  2200. ''' </summary>
  2201. Feedback = 5
  2202. ''' <summary>
  2203. ''' 弹窗,结束程序。
  2204. ''' </summary>
  2205. Assert = 6
  2206. End Enum
  2207. ''' <summary>
  2208. ''' 记录程序是否递交了错误提示,以确保运行测试正确。
  2209. ''' </summary>
  2210. Public IsErrorTriggered As Boolean = False
  2211. Private LogList As New StringBuilder
  2212. Private LogWritter As StreamWriter
  2213. Public Sub LogStart()
  2214. RunInNewThread(Sub()
  2215. Dim IsInitSuccess As Boolean = True
  2216. Try
  2217. For i = 4 To 1 Step -1
  2218. If File.Exists(Path & "PCL\Log" & i & ".txt") Then
  2219. If File.Exists(Path & "PCL\Log" & (i + 1) & ".txt") Then File.Delete(Path & "PCL\Log" & (i + 1) & ".txt")
  2220. CopyFile(Path & "PCL\Log" & i & ".txt", Path & "PCL\Log" & (i + 1) & ".txt")
  2221. End If
  2222. Next
  2223. File.Create(Path & "PCL\Log1.txt").Dispose()
  2224. Catch ex As IOException
  2225. IsInitSuccess = False
  2226. Hint("可能同时开启了多个 PCL2,程序可能会出现未知问题!", HintType.Critical)
  2227. Log(ex, "日志初始化失败(疑似文件占用问题)")
  2228. Catch ex As Exception
  2229. IsInitSuccess = False
  2230. Log(ex, "日志初始化失败", LogLevel.Hint)
  2231. End Try
  2232. Try
  2233. LogWritter = New StreamWriter(Path & "PCL\Log1.txt", True) With {.AutoFlush = True}
  2234. Catch ex As Exception
  2235. LogWritter = Nothing
  2236. Log(ex, "日志写入失败", LogLevel.Hint)
  2237. End Try
  2238. While True
  2239. If IsInitSuccess Then
  2240. LogFlush()
  2241. Else
  2242. LogList = New StringBuilder '清空 LogList 避免内存爆炸
  2243. End If
  2244. Thread.Sleep(50)
  2245. End While
  2246. End Sub, "Log Writer", ThreadPriority.Lowest)
  2247. End Sub
  2248. Private ReadOnly LogFlushLock As New Object '防止外部调用 LogFlush 时同时输出多次日志
  2249. Public Sub LogFlush()
  2250. On Error Resume Next
  2251. If LogWritter Is Nothing Then Exit Sub
  2252. Dim Log As String = Nothing
  2253. SyncLock LogFlushLock
  2254. If LogList.Length > 0 Then
  2255. Dim LogListCache As StringBuilder
  2256. LogListCache = LogList
  2257. LogList = New StringBuilder
  2258. Log = LogListCache.ToString
  2259. End If
  2260. End SyncLock
  2261. If Log IsNot Nothing Then
  2262. LogWritter.Write(Log)
  2263. End If
  2264. End Sub
  2265. Private ReadOnly LogListLock As New Object '防止日志乱码,只在调试模式下启用
  2266. ''' <summary>
  2267. ''' 输出 Log。
  2268. ''' </summary>
  2269. ''' <param name="Title">如果要求弹窗,指定弹窗的标题。</param>
  2270. Public Sub Log(Text As String, Optional Level As LogLevel = LogLevel.Normal, Optional Title As String = "出现错误")
  2271. On Error Resume Next
  2272. '放在最后会导致无法显示极端错误下的弹窗(如无法写入日志文件)
  2273. '处理错误会导致再次调用 Log() 导致无限循环
  2274. '输出日志
  2275. Dim AppendText As String = "[" & GetTimeNow() & "] " & Text & vbCrLf '减轻同步锁占用
  2276. If ModeDebug Then
  2277. SyncLock LogListLock
  2278. LogList.Append(AppendText)
  2279. End SyncLock
  2280. Else
  2281. LogList.Append(AppendText)
  2282. End If
  2283. #If DEBUG Then
  2284. Console.Write(AppendText)
  2285. #End If
  2286. If IsProgramEnded OrElse Level = LogLevel.Normal Then Exit Sub
  2287. '去除前缀
  2288. Text = RegexReplace(Text, "", "\[[^\]]+?\] ")
  2289. '输出提示
  2290. Select Case Level
  2291. #If DEBUG Then
  2292. Case LogLevel.Developer
  2293. Hint("[开发者模式] " & Text, HintType.Info, False)
  2294. Case LogLevel.Debug
  2295. Hint("[调试模式] " & Text, HintType.Info, False)
  2296. #Else
  2297. Case LogLevel.Developer
  2298. Case LogLevel.Debug
  2299. If ModeDebug Then Hint("[调试模式] " & Text, HintType.Info, False)
  2300. #End If
  2301. Case LogLevel.Hint
  2302. IsErrorTriggered = True
  2303. Hint(Text, HintType.Critical, False)
  2304. Case LogLevel.Msgbox
  2305. IsErrorTriggered = True
  2306. MyMsgBox(Text, Title)
  2307. Case LogLevel.Feedback
  2308. IsErrorTriggered = True
  2309. If CanFeedback(False) Then
  2310. If MyMsgBox(Text & vbCrLf & vbCrLf & "是否反馈此问题?如果不反馈,这个问题可能永远无法得到解决!", Title, "反馈", "取消") = 1 Then Feedback(False, True)
  2311. Else
  2312. MyMsgBox(Text & vbCrLf & vbCrLf & "将 PCL2 更新至最新版或许可以解决这个问题……", Title)
  2313. End If
  2314. Case LogLevel.Assert
  2315. IsErrorTriggered = True
  2316. Dim Time As Long = GetTimeTick()
  2317. If CanFeedback(False) Then
  2318. If MsgBox(Text & vbCrLf & vbCrLf & "是否反馈此问题?如果不反馈,这个问题可能永远无法得到解决!", MsgBoxStyle.Critical + MsgBoxStyle.YesNo, Title) = MsgBoxResult.Yes Then Feedback(False, True)
  2319. Else
  2320. MsgBox(Text & vbCrLf & vbCrLf & "将 PCL2 更新至最新版或许可以解决这个问题……", MsgBoxStyle.Critical, Title)
  2321. End If
  2322. If GetTimeTick() - Time < 1500 Then
  2323. '弹窗无法保留
  2324. Log("[System] PCL 已崩溃:" & vbCrLf & Text)
  2325. FormMain.EndProgramForce(Result.Exception)
  2326. Else
  2327. FormMain.EndProgramForce(Result.Fail)
  2328. End If
  2329. End Select
  2330. End Sub
  2331. ''' <summary>
  2332. ''' 输出错误信息。
  2333. ''' </summary>
  2334. ''' <param name="Desc">错误描述。会在处理时在末尾加入冒号。</param>
  2335. Public Sub Log(Ex As Exception, Desc As String, Optional Level As LogLevel = LogLevel.Debug, Optional Title As String = "出现错误")
  2336. On Error Resume Next
  2337. If TypeOf Ex Is ThreadInterruptedException Then Exit Sub
  2338. IsErrorTriggered = True
  2339. '获取错误信息
  2340. Dim ExFull As String = Desc & ":" & GetString(Ex, False)
  2341. '输出日志
  2342. Dim AppendText As String = "[" & GetTimeNow() & "] " & Desc & ":" & GetString(Ex, False, True) & vbCrLf '减轻同步锁占用
  2343. If ModeDebug Then
  2344. SyncLock LogListLock
  2345. LogList.Append(AppendText)
  2346. End SyncLock
  2347. Else
  2348. LogList.Append(AppendText)
  2349. End If
  2350. #If DEBUG Then
  2351. Console.Write(AppendText)
  2352. #End If
  2353. If IsProgramEnded Then Exit Sub
  2354. '输出提示
  2355. Select Case Level
  2356. Case LogLevel.Normal
  2357. #If DEBUG Then
  2358. Case LogLevel.Developer
  2359. Dim ExLine As String = Desc & ":" & GetString(Ex, True)
  2360. Hint("[开发者模式] " & ExLine, HintType.Info, False)
  2361. Case LogLevel.Debug
  2362. Dim ExLine As String = Desc & ":" & GetString(Ex, True)
  2363. Hint("[调试模式] " & ExLine, HintType.Info, False)
  2364. #Else
  2365. Case LogLevel.Developer
  2366. Case LogLevel.Debug
  2367. Dim ExLine As String = Desc & ":" & GetString(Ex, True)
  2368. If ModeDebug Then Hint("[调试模式] " & ExLine, HintType.Info, False)
  2369. #End If
  2370. Case LogLevel.Hint
  2371. Dim ExLine As String = Desc & ":" & GetString(Ex, True)
  2372. Hint(ExLine, HintType.Critical, False)
  2373. Case LogLevel.Msgbox
  2374. MyMsgBox(ExFull, Title)
  2375. Case LogLevel.Feedback
  2376. If CanFeedback(False) Then
  2377. If MyMsgBox(ExFull & vbCrLf & vbCrLf & "是否反馈此问题?如果不反馈,这个问题可能永远无法得到解决!", Title, "反馈", "取消") = 1 Then Feedback(False, True)
  2378. Else
  2379. MyMsgBox(ExFull & vbCrLf & vbCrLf & "将 PCL2 更新至最新版或许可以解决这个问题……", Title)
  2380. End If
  2381. Case LogLevel.Assert
  2382. Dim Time As Long = GetTimeTick()
  2383. If CanFeedback(False) Then
  2384. If MsgBox(ExFull & vbCrLf & vbCrLf & "是否反馈此问题?如果不反馈,这个问题可能永远无法得到解决!", MsgBoxStyle.Critical + MsgBoxStyle.YesNo, Title) = MsgBoxResult.Yes Then Feedback(False, True)
  2385. Else
  2386. MsgBox(ExFull & vbCrLf & vbCrLf & "将 PCL2 更新至最新版或许可以解决这个问题……", MsgBoxStyle.Critical, Title)
  2387. End If
  2388. If GetTimeTick() - Time < 1500 Then
  2389. '弹窗无法保留
  2390. Log("[System] PCL 已崩溃:" & vbCrLf & ExFull)
  2391. FormMain.EndProgramForce(Result.Exception)
  2392. Else
  2393. FormMain.EndProgramForce(Result.Fail)
  2394. End If
  2395. End Select
  2396. End Sub
  2397. '反馈
  2398. Public Sub Feedback(Optional ShowMsgbox As Boolean = True, Optional ForceOpenLog As Boolean = False)
  2399. On Error Resume Next
  2400. FeedbackInfo()
  2401. If ForceOpenLog OrElse (ShowMsgbox AndAlso MyMsgBox("若你在汇报一个 Bug,请点击 打开文件夹 按钮,并上传 Log(1~5).txt 中包含错误信息的文件。" & vbCrLf & "游戏崩溃一般与启动器无关,请不要因为游戏崩溃而提交反馈。", "反馈提交提醒", "打开文件夹", "不需要") = 1) Then
  2402. OpenExplorer("""" & Path & "PCL\""")
  2403. End If
  2404. OpenWebsite("https://github.com/Hex-Dragon/PCL2/issues/")
  2405. End Sub
  2406. Public Function CanFeedback(ShowHint As Boolean) As Boolean
  2407. If False.Equals(PageSetupSystem.IsLauncherNewest) Then
  2408. If ShowHint Then MyMsgBox("你的 PCL2 不是最新版,因此无法提交反馈。" & vbCrLf & "请先在 设置 → 启动器 中更新启动器,确认该问题在最新版中依然存在,然后再提交反馈。", "无法提交反馈")
  2409. Return False
  2410. Else
  2411. Return True
  2412. End If
  2413. End Function
  2414. ''' <summary>
  2415. ''' 在日志中输出系统诊断信息。
  2416. ''' </summary>
  2417. Public Sub FeedbackInfo()
  2418. On Error Resume Next
  2419. Log("[System] 诊断信息:" & vbCrLf &
  2420. "操作系统:" & My.Computer.Info.OSFullName & vbCrLf &
  2421. "剩余内存:" & Int(My.Computer.Info.AvailablePhysicalMemory / 1024 / 1024) & " M / " & Int(My.Computer.Info.TotalPhysicalMemory / 1024 / 1024) & " M" & vbCrLf &
  2422. "DPI:" & DPI & "(" & Math.Round(DPI / 96, 2) * 100 & "%)" & vbCrLf &
  2423. "MC 文件夹:" & If(PathMcFolder, "Nothing") & vbCrLf &
  2424. "文件位置:" & Path)
  2425. End Sub
  2426. '断言
  2427. Public Sub DebugAssert(Exp As Boolean)
  2428. If Not Exp Then Throw New Exception("断言命中")
  2429. End Sub
  2430. '获取当前的堆栈信息
  2431. Public Function GetStackTrace() As String
  2432. Dim Stack As New StackTrace()
  2433. Return Join(Stack.GetFrames().Skip(1).Select(Function(f) f.GetMethod).
  2434. Select(Function(f) f.Name & "(" & Join(f.GetParameters.Select(Function(p) p.ToString).ToList, ", ") & ") - " & f.Module.ToString).ToList,
  2435. vbCrLf).Replace(vbCrLf & vbCrLf, vbCrLf)
  2436. End Function
  2437. #End Region
  2438. #Region "随机"
  2439. Private ReadOnly Random As New Random
  2440. ''' <summary>
  2441. ''' 随机选择其一。
  2442. ''' </summary>
  2443. Public Function RandomOne(Of T)(objects As ICollection(Of T)) As T
  2444. Return objects(RandomInteger(0, objects.Count - 1))
  2445. End Function
  2446. ''' <summary>
  2447. ''' 取随机整数。
  2448. ''' </summary>
  2449. Public Function RandomInteger(min As Integer, max As Integer) As Integer
  2450. Return Math.Floor((max - min + 1) * Random.NextDouble) + min
  2451. End Function
  2452. ''' <summary>
  2453. ''' 将数组随机打乱。
  2454. ''' </summary>
  2455. Public Function RandomChaos(Of T)(array As IList(Of T)) As IList(Of T)
  2456. RandomChaos = New List(Of T)
  2457. Do While array.Count > 0
  2458. Dim i As Integer = RandomInteger(0, array.Count - 1)
  2459. RandomChaos.Add(array(i))
  2460. array.RemoveAt(i)
  2461. Loop
  2462. End Function
  2463. #End Region
  2464. End Module