Add new method

src/Microsoft.Security.Utilities/CustomAlphabetEncoder.cs

@@ -115,5 +115,41 @@ public byte[] Decode(string encodedValue)
 
             return BitConverter.GetBytes(decodedValue);
         }
+
+        /// <summary>
+        /// Sets a custom alphabet to be used for all encoding and decoding operations.
+        /// </summary>
+        /// <param name="customAlphabet">A string representing the custom alphabet. It must consist of non-whitespace ASCII characters, including letters, numbers, and/or punctuation.</param>
+        /// <exception cref="ArgumentException">Throws an exception if the alphabet contains duplicates or contains forbidden characters.</exception>
+        /// <remarks>
+        /// This method allows dynamic changes to the alphabet used for encoding and decoding data. Before setting a new alphabet, the method performs checks for duplicates and the presence of forbidden characters.
+        /// </remarks>
+        public void SetCustomAlphabet(string customAlphabet)
+        {
+            if (customAlphabet == null)
+            {
+                throw new ArgumentNullException(nameof(customAlphabet));
+            }
+
+            Dictionary<char, uint> newCharToValueMap = new Dictionary<char, uint>();
+
+            for (int i = 0; i < customAlphabet.Length; i++)
+            {
+                if (newCharToValueMap.ContainsKey(customAlphabet[i]))
+                {
+                    throw new ArgumentException(nameof(customAlphabet), "Duplicate value detected in the new alphabet.");
+                }
+
+                if (Char.IsWhiteSpace(customAlphabet[i]) || Char.IsSurrogate(customAlphabet[i]) || (int)customAlphabet[i] > 127)
+                {
+                    throw new ArgumentException(nameof(customAlphabet), $"Forbidden character type detected in the new alphabet: {customAlphabet[i]}.");
+                }
+
+                newCharToValueMap[customAlphabet[i]] = (uint)i;
+            }
+
+            alphabet = customAlphabet;
+            charToValueMap = newCharToValueMap;
+        }
     }
 }

src/Microsoft.Security.Utilities/Microsoft.Security.Utilities.csproj

@@ -18,6 +18,10 @@
     <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
   </PropertyGroup>
 
+  <PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">
+    <DocumentationFile>C:\Users\User\RiderProjects\Fork\bld\bin\AnyCPU_Debug\Microsoft.Security.Utilities\Microsoft.Security.Utilities.xml</DocumentationFile>
+  </PropertyGroup>
+
   <ItemGroup Condition="$(TargetFramework) == 'netstandard2.0'">
     <PackageReference Include="System.Memory" Version="4.5.4" />
   </ItemGroup>

src/Tests.Microsoft.Security.Utilities/CustomAlphabetEncoderTests.cs

@@ -198,6 +198,23 @@ public void CustomAlphabetEncoder_VerifyStaticAndInstanceDate()
 
             encodedChecksum1.Should().Be(encodedChecksum2);
         }
+
+        [TestMethod]
+        public void CustomAlphabetEncoder_SetCustomAlphabetShouldChangeAlphabetAndWorkCorrectly()
+        {
+            var testEncoder = new CustomAlphabetEncoder("123");
+            uint input = 42;
+            string originalEncoded = testEncoder.Encode(input);
+
+            testEncoder.SetCustomAlphabet("ABC");
+
+            string newEncoded = testEncoder.Encode(input);
+            byte[] newDecoded = testEncoder.Decode(newEncoded);
+            uint newDecodedUint = BitConverter.ToUInt32(newDecoded, 0);
+
+            newEncoded.Should().NotBe(originalEncoded);
+            newDecodedUint.Should().Be(input);
+        }
 
         private IEnumerable<string> GenerateValidAlphabetTestCases()
         {