deploy webservice static-file routing for docsite folder URLs, per-instance step-cache db, and constant-height panel title bars.

2026-08-27 14:51:37 +08:00
parent 1fc510af5e
commit 2a98ae7556
1468 changed files with 182837 additions and 18888 deletions
@@ -265,6 +265,58 @@ Class FileUtil



+  <a id="Hi_Common_FileLines_FileUtil_DetectRoundTripEncoding_" data-uid="Hi.Common.FileLines.FileUtil.DetectRoundTripEncoding*"></a>
+
+  <h3 id="Hi_Common_FileLines_FileUtil_DetectRoundTripEncoding_System_String_" data-uid="Hi.Common.FileLines.FileUtil.DetectRoundTripEncoding(System.String)">
+  DetectRoundTripEncoding(string)
+  
+  </h3>
+
+  <div class="markdown level1 summary"><p>Detects a text encoding for <code class="paramref">filePath</code> that survives a
+read-modify-write round trip byte for byte on untouched lines.</p>
+</div>
+  <div class="markdown level1 conceptual"></div>
+
+  <div class="codewrapper">
+    <pre><code class="lang-csharp hljs">public static Encoding DetectRoundTripEncoding(string filePath)</code></pre>
+  </div>
+
+  <h4 class="section">Parameters</h4>
+  <dl class="parameters">
+    <dt><code>filePath</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.string">string</a></dt>
+    <dd><p>The path of the file to sniff.</p>
+</dd>
+  </dl>
+
+  <h4 class="section">Returns</h4>
+  <dl class="parameters">
+    <dt><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.text.encoding">Encoding</a></dt>
+    <dd><p>The encoding of the UTF-8 / UTF-16 byte-order mark when one is
+present; otherwise strict-validated UTF-8 (without a mark); otherwise
+Latin-1.</p>
+</dd>
+  </dl>
+
+
+
+
+
+
+
+  <h4 class="section" id="Hi_Common_FileLines_FileUtil_DetectRoundTripEncoding_System_String__remarks">Remarks</h4>
+  <div class="markdown level1 remarks"><p>The Latin-1 fallback maps every byte to the char of the same value, so
+a file in any ANSI-family encoding (GBK, Big5, Shift-JIS, ...)
+re-encodes to its original bytes. ASCII-keyed parsing is unaffected:
+those encodings never reuse bytes below 0x40 as trail bytes, so
+delimiters such as &lsquo;;&rsquo; and &lsquo;(&rsquo; cannot occur inside a multi-byte
+character. The BCL's default UTF-8 reader instead replaces every
+undecodable byte with U+FFFD, which irreversibly destroys such content
+on write-back.</p>
+</div>
+
+
+
+
  <a id="Hi_Common_FileLines_FileUtil_EnsureDirectory_" data-uid="Hi.Common.FileLines.FileUtil.EnsureDirectory*"></a>

  <h3 id="Hi_Common_FileLines_FileUtil_EnsureDirectory_System_String_" data-uid="Hi.Common.FileLines.FileUtil.EnsureDirectory(System.String)">