From 4df4e4e5fd05d82d9dcd5fdc0e643dab5f254507 Mon Sep 17 00:00:00 2001 From: VinothSF5015 Date: Thu, 30 Apr 2026 16:24:19 +0530 Subject: [PATCH 1/2] 992378 - Content Added --- Document-Processing-toc.html | 11 +++-- ...hould-be-avoided-when-naming-worksheets.md | 46 +++++++++++++++++++ 2 files changed, 53 insertions(+), 4 deletions(-) create mode 100644 Document-Processing/Excel/Excel-Library/NET/faqs/which-characters-should-be-avoided-when-naming-worksheets.md diff --git a/Document-Processing-toc.html b/Document-Processing-toc.html index 861971b97..534fa7839 100644 --- a/Document-Processing-toc.html +++ b/Document-Processing-toc.html @@ -6753,15 +6753,18 @@
  • How to retrieve data from merged cells using XlsIO?
    • -
  • +
  • How to convert inches to points in Syncfusion XlsIO? -
    • -
  • - How to preserve line breaks when saving Excel as CSV? +
    • +
  • + How to preserve line breaks when saving Excel as CSV?
  • Why does text with double quotes get enclosed in double quotes when saving as CSV?
    • +
  • + Which characters should be avoided when naming worksheets? +
    • diff --git a/Document-Processing/Excel/Excel-Library/NET/faqs/which-characters-should-be-avoided-when-naming-worksheets.md b/Document-Processing/Excel/Excel-Library/NET/faqs/which-characters-should-be-avoided-when-naming-worksheets.md new file mode 100644 index 000000000..a39f3de10 --- /dev/null +++ b/Document-Processing/Excel/Excel-Library/NET/faqs/which-characters-should-be-avoided-when-naming-worksheets.md @@ -0,0 +1,46 @@ +--- +title: Which characters should be avoided when naming worksheets? | Syncfusion +description: Worksheet names containing characters like '/' or ':' can corrupt a workbook. This FAQ shows how to validate and replace invalid characters in worksheet names using XlsIO. +platform: document-processing +control: XlsIO +documentation: UG +--- + +# Which characters should be avoided when naming worksheets? + +Worksheets that include invalid characters such as `:` or `/` in their names can cause workbook corruption when opened in some viewers or when round-tripping between formats. Use XlsIO to validate and sanitize worksheet names before saving. + +## Invalid Characters in Worksheet Names + +Excel does not allow the following seven characters in worksheet names: + +| Character | Symbol | Issue | +|---|---|---| +| Colon | `:` | Causes path confusion in some file systems | +| Backslash | `\` | Used as path separator, causes file system errors | +| Forward Slash | `/` | Used as directory separator, creates ambiguity | +| Question Mark | `?` | Wildcard character, causes parsing issues | +| Asterisk | `*` | Wildcard character, causes file system conflicts | +| Opening Bracket | `[` | Reserved for special Excel references | +| Closing Bracket | `]` | Reserved for special Excel references | + +## Why These Characters Cause Corruption + +When worksheets contain these forbidden characters, the following issues occur: + +1. **File Format Issues**: Excel and other spreadsheet applications may fail to parse the workbook correctly +2. **Round-trip Conversion Errors**: Converting between formats (XLSX to XLS and back) may corrupt the data +3. **File System Conflicts**: Path separators (`:`, `\`, `/`) conflict with operating system file naming conventions +4. **External Tool Failures**: Third-party tools and APIs may not be able to read or write the workbook +5. **Sharing Problems**: Files become incompatible when shared across different platforms or applications + +## Best Practices for Worksheet Names + +Follow these guidelines when naming worksheets: + +- **Use alphanumeric characters** (letters A-Z, a-z, numbers 0-9) +- **Use safe special characters** (underscore `_`, hyphen `-`, space ` `) +- **Avoid all seven forbidden characters** listed above +- **Keep names under 31 characters** (Excel's maximum limit) +- **Ensure names are not empty** (at least 1 character required) +- **Make names meaningful** (use clear, descriptive titles like "Sales Data", "Q1_2026", "Report_Jan") \ No newline at end of file From 644a8ffe4b6b9fcc549e5daba0b40d2e4567368d Mon Sep 17 00:00:00 2001 From: VinothSF5015 Date: Thu, 30 Apr 2026 16:50:02 +0530 Subject: [PATCH 2/2] Revise FAQ title and description for worksheet naming Updated the title and description for clarity and conciseness. --- ...h-characters-should-be-avoided-when-naming-worksheets.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Document-Processing/Excel/Excel-Library/NET/faqs/which-characters-should-be-avoided-when-naming-worksheets.md b/Document-Processing/Excel/Excel-Library/NET/faqs/which-characters-should-be-avoided-when-naming-worksheets.md index a39f3de10..9e9f0e46d 100644 --- a/Document-Processing/Excel/Excel-Library/NET/faqs/which-characters-should-be-avoided-when-naming-worksheets.md +++ b/Document-Processing/Excel/Excel-Library/NET/faqs/which-characters-should-be-avoided-when-naming-worksheets.md @@ -1,6 +1,6 @@ --- -title: Which characters should be avoided when naming worksheets? | Syncfusion -description: Worksheet names containing characters like '/' or ':' can corrupt a workbook. This FAQ shows how to validate and replace invalid characters in worksheet names using XlsIO. +title: Invalid characters to avoid in worksheet names | Syncfusion +description: Worksheet names containing '/' or ':' may corrupt workbooks. This FAQ explains the invalid characters to avoid. platform: document-processing control: XlsIO documentation: UG @@ -43,4 +43,4 @@ Follow these guidelines when naming worksheets: - **Avoid all seven forbidden characters** listed above - **Keep names under 31 characters** (Excel's maximum limit) - **Ensure names are not empty** (at least 1 character required) -- **Make names meaningful** (use clear, descriptive titles like "Sales Data", "Q1_2026", "Report_Jan") \ No newline at end of file +- **Make names meaningful** (use clear, descriptive titles like "Sales Data", "Q1_2026", "Report_Jan")