---
description: >-
  Learn how to customize the set of characters used for ID generation by
  enabling or disabling numbers and special characters, or by supplying a custom
  character set while also excluding the prohibited.
---

# Character Set Customization

## Overview

Character Set Customization provides a mechanism to tailor the pool of characters from which the unique ID is built. Developers can opt for default alphabetical characters with optional numbers and special characters, or override this with a custom set, while ensuring certain characters are excluded.

***

### Key Points

<table><thead><tr><th width="206">Aspect</th><th>Details</th></tr></thead><tbody><tr><td>IncludeNumbers</td><td>A boolean property to enable or disable the inclusion of numeric characters (0-9) in the generated ID.</td></tr><tr><td>IncludeSpecialChars</td><td>A boolean property to enable or disable the inclusion of a predefined set of special characters in the generated ID.</td></tr><tr><td>CustomCharacterSet</td><td>A string property that allows developers to provide their own set of characters; if set, this replaces the default alphabetical character pool.</td></tr><tr><td>ProhibitedCharacters</td><td>A string property where developers can list (comma-separated) characters that should be excluded from the allowed character set during ID generation.</td></tr></tbody></table>

***

### Best Practices

<table><thead><tr><th width="228">Practice Area</th><th>Recommendation</th></tr></thead><tbody><tr><td>Custom Set vs. Defaults</td><td>Use CustomCharacterSet when a specific character composition is required; otherwise, rely on default settings for letters with optional numbers and special characters.</td></tr><tr><td>Enabling Numbers</td><td>Enable IncludeNumbers if numerical values are acceptable and can enhance the randomness of the ID, but consider potential conflicts with other systems.</td></tr><tr><td>Enabling Special Chars</td><td>Enable IncludeSpecialChars only if your application can safely process special characters; this is useful for improving ID complexity.</td></tr><tr><td>Excluding Characters</td><td>Use ProhibitedCharacters to remove any characters that may be visually confusing, similar in appearance, or reserved by other system components.</td></tr></tbody></table>

***

### Common Pitfalls

<table><thead><tr><th width="226">Issue</th><th>Explanation</th><th>Recommendation</th></tr></thead><tbody><tr><td>Overlapping Characters</td><td>Using a CustomCharacterSet that includes characters similar to those in ProhibitedCharacters can lead to conflicts.</td><td>Ensure the custom set does not include any characters listed in ProhibitedCharacters.</td></tr><tr><td>Unintended Exclusion</td><td>Setting ProhibitedCharacters incorrectly (e.g., extra spaces or wrong delimiters) might exclude unintended characters.</td><td>Verify the format of ProhibitedCharacters, ensuring characters are separated by commas without extra spaces.</td></tr><tr><td>Inconsistent Character Pool</td><td>Changing IncludeNumbers or IncludeSpecialChars without calling UpdateConfiguration can lead to an outdated allowed character set.</td><td>Always trigger UpdateConfiguration after modifying these properties to refresh the character set.</td></tr></tbody></table>

***

### Usage Scenarios

<table><thead><tr><th width="214">Scenario</th><th>Description</th><th>Example Integration</th></tr></thead><tbody><tr><td>Default Character Set</td><td>Use the default set (alphabetical characters) with numbers and special characters optionally included.</td><td>Set IncludeNumbers and IncludeSpecialChars as required; leave CustomCharacterSet empty.</td></tr><tr><td>Custom Character Requirements</td><td>When a specific set of characters is needed (e.g., alphanumeric without confusing letters), provide a custom character set.</td><td>Set CustomCharacterSet to a defined string and leave IncludeNumbers/IncludeSpecialChars unchanged.</td></tr><tr><td>Excluding Problematic Characters</td><td>Exclude certain characters that may be misinterpreted (e.g., "I", "l", "O", "0").</td><td>Populate ProhibitedCharacters with the problematic characters in a comma-separated format.</td></tr></tbody></table>

***

### Real Life Usage Scenarios

<table><thead><tr><th width="206">Scenario</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td>User-Facing IDs</td><td>Generating IDs that are displayed to users, where clarity is crucial, such as avoiding ambiguous characters.</td><td>Use a CustomCharacterSet that omits characters like 'I' and 'l'; use ProhibitedCharacters for 'O', '0'.</td></tr><tr><td>Security-Sensitive Applications</td><td>Applications requiring IDs with high entropy and controlled character sets for enhanced security.</td><td>Enable IncludeNumbers and IncludeSpecialChars with a carefully crafted CustomCharacterSet.</td></tr><tr><td>System Compatibility</td><td>Ensuring the generated ID does not include characters that may conflict with other system components or protocols.</td><td>Configure ProhibitedCharacters to remove reserved or problematic characters.</td></tr></tbody></table>

***

### Troubleshooting Tips

| Problem                      | Possible Cause                                                                                                     | Suggested Fix                                                                                               |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| Unexpected Characters in IDs | The allowed character set may include undesired characters due to not updating configuration after changes.        | Call UpdateConfiguration after setting CustomCharacterSet or modifying IncludeNumbers/IncludeSpecialChars.  |
| Missing Characters           | CustomCharacterSet might be empty while expecting a different pool, or ProhibitedCharacters is excluding too much. | Verify the values of CustomCharacterSet and ProhibitedCharacters to ensure they meet the expected criteria. |
| Confusing or Ambiguous IDs   | Characters that look similar might be included inadvertently.                                                      | Use ProhibitedCharacters to exclude visually similar or ambiguous characters.                               |

***

### Review

<table><thead><tr><th width="171">Aspect</th><th>Review</th></tr></thead><tbody><tr><td>Flexibility</td><td>The feature provides extensive options to tailor the allowed character set for ID generation.</td></tr><tr><td>Control</td><td>Developers have fine control over which characters are included or excluded, ensuring clarity and security.</td></tr><tr><td>Integration Ease</td><td>The configuration properties are simple to set and adjust, making it easy to integrate into any .NET WinForms project.</td></tr></tbody></table>

***

### Summary

<table><thead><tr><th width="217">Summary Point</th><th>Details</th></tr></thead><tbody><tr><td>Customization Options</td><td>Developers can choose to use default alphabets, numbers, and special characters or specify a custom set entirely.</td></tr><tr><td>Exclusion Capability</td><td>ProhibitedCharacters ensures that any unwanted or problematic characters are excluded from the allowed set.</td></tr><tr><td>Adaptability</td><td>The feature adapts to both user-facing and backend system requirements, offering a balance between complexity and clarity.</td></tr><tr><td>Seamless Integration</td><td>By updating configuration settings via UpdateConfiguration, the feature seamlessly integrates into existing ID generation workflows.</td></tr></tbody></table>

***

### Code Samples and Examples

#### Example 1: Using the Default Character Set with Numbers and Special Characters

```csharp
using System;
using SiticoneNetFrameworkUI;

namespace CharacterSetDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize the ID generator
            SiticoneIdGen idGen = new SiticoneIdGen();

            // Configure character set options for the default set
            idGen.IncludeNumbers = true;
            idGen.IncludeSpecialChars = true;
            idGen.CustomCharacterSet = ""; // Use default alphabet if empty
            idGen.ProhibitedCharacters = "I,l,O,0"; // Exclude ambiguous characters

            // Refresh configuration to update allowed characters
            idGen.UpdateConfiguration();

            // Generate a unique ID
            string uniqueId = idGen.GenerateId();
            Console.WriteLine("Generated ID with default character set: " + uniqueId);
        }
    }
}
```

#### Example 2: Defining a Custom Character Set

```csharp
using System;
using SiticoneNetFrameworkUI;

namespace CustomCharacterSetDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize the ID generator
            SiticoneIdGen idGen = new SiticoneIdGen();

            // Specify a custom character set (for example, only uppercase vowels)
            idGen.CustomCharacterSet = "AEIOU";
            // Disable the inclusion of numbers and special characters
            idGen.IncludeNumbers = false;
            idGen.IncludeSpecialChars = false;

            // Exclude any unwanted characters (if needed)
            idGen.ProhibitedCharacters = ""; // No characters to exclude in this scenario

            // Refresh configuration to update allowed characters based on new settings
            idGen.UpdateConfiguration();

            // Generate a unique ID using the custom character set
            string uniqueId = idGen.GenerateId();
            Console.WriteLine("Generated ID with custom character set: " + uniqueId);
        }
    }
}
```

#### Example 3: Updating Character Set Configuration on the Fly in a WinForms Application

```csharp
using System;
using System.Windows.Forms;
using SiticoneNetFrameworkUI;

namespace WinFormsCharacterSetDemo
{
    public partial class MainForm : Form
    {
        private SiticoneIdGen idGen;

        public MainForm()
        {
            InitializeComponent();

            // Initialize the ID generator
            idGen = new SiticoneIdGen();

            // Configure initial character set options
            idGen.IncludeNumbers = true;
            idGen.IncludeSpecialChars = false;
            idGen.CustomCharacterSet = ""; // Default alphabet
            idGen.ProhibitedCharacters = "O,0"; // Exclude commonly confused characters

            // Update configuration to apply changes
            idGen.UpdateConfiguration();
        }

        private void generateButton_Click(object sender, EventArgs e)
        {
            // Generate and display the unique ID in a text box
            string id = idGen.GenerateId();
            generatedIdTextBox.Text = id;
        }

        private void updateConfigButton_Click(object sender, EventArgs e)
        {
            // Change configuration dynamically based on user input
            idGen.CustomCharacterSet = customSetTextBox.Text;
            idGen.ProhibitedCharacters = prohibitedCharsTextBox.Text;

            // Apply the updated configuration
            idGen.UpdateConfiguration();
        }
    }
}
```

***

### Additional Useful Sections

#### Integration Checklist

<table><thead><tr><th width="283">Checklist Item</th><th>Requirement/Action</th></tr></thead><tbody><tr><td>Verify CustomCharacterSet</td><td>Confirm the custom set meets the application requirements.</td></tr><tr><td>Set IncludeNumbers</td><td>Decide whether numbers should be included in the ID.</td></tr><tr><td>Set IncludeSpecialChars</td><td>Determine if special characters are necessary.</td></tr><tr><td>Configure ProhibitedCharacters</td><td>Ensure that any characters that could cause confusion are excluded.</td></tr></tbody></table>

#### FAQ

| Question                                     | Answer                                                                                                                |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| What happens if CustomCharacterSet is empty? | The generator uses the default set of alphabetical characters (with numbers and/or special characters as configured). |
| How are prohibited characters processed?     | ProhibitedCharacters is split by commas, and each specified character is removed from the allowed set.                |
| Do I need to call UpdateConfiguration?       | Yes, after changing any character set properties, call UpdateConfiguration to refresh the allowed characters.         |

***

### Final Review

<table><thead><tr><th width="140">Aspect</th><th>Review</th></tr></thead><tbody><tr><td>Flexibility</td><td>The feature allows for complete customization of the allowed character pool, either through defaults or user-defined sets.</td></tr><tr><td>Control</td><td>Developers can fine-tune which characters appear in the generated ID, reducing the chance of ambiguity.</td></tr><tr><td>Adaptability</td><td>It is easily adjusted to suit different application requirements, from security-focused systems to user-friendly interfaces.</td></tr></tbody></table>

***

### Summary

<table><thead><tr><th width="218">Summary Aspect</th><th>Recap</th></tr></thead><tbody><tr><td>Customization Options</td><td>Offers properties to enable numbers, special characters, or a complete custom set for ID generation.</td></tr><tr><td>Exclusion Capabilities</td><td>ProhibitedCharacters ensures that any confusing or unwanted characters are omitted from the generated IDs.</td></tr><tr><td>Ease of Integration</td><td>Straightforward property settings and clear update procedures (via UpdateConfiguration) allow for seamless integration.</td></tr><tr><td>Practical Application</td><td>Ideal for systems that require specific character constraints, such as user-facing identifiers or secure token generation.</td></tr></tbody></table>

***

This documentation for the Character Set Customization feature should serve as a comprehensive guide for developers to customize and control the pool of characters used in the SiticoneIdGen control within their .NET WinForms applications.
