Merge pull request #11768 from dotnet/main

dotnet-policy-service[bot] · web-flow · commit b9d406f2ce63 · 2025-09-04T09:31:50.000Z
Merge main into live
diff --git a/includes/remarks/System.IO.Compression/ZipArchiveEntry/Name.md b/includes/remarks/System.IO.Compression/ZipArchiveEntry/Name.md
@@ -1,4 +1,5 @@
 The <xref:System.IO.Compression.ZipArchiveEntry.Name%2A> property contains the portion of the <xref:System.IO.Compression.ZipArchiveEntry.FullName%2A> property that follows the final directory separator character (\\), and does not include the subdirectory hierarchy. For example, if you create two entries in a zip archive by using the <xref:System.IO.Compression.ZipFileExtensions.CreateEntryFromFile%2A> method and provide `NewEntry.txt` as the name for the first entry and `AddedFolder\\NewEntry.txt` for the second entry, both entries will have `NewEntry.txt` in the <xref:System.IO.Compression.ZipArchiveEntry.Name%2A> property. The first entry will also have `NewEntry.txt` in the <xref:System.IO.Compression.ZipArchiveEntry.FullName%2A> property, but the second entry will have `AddedFolder\\NewEntry.txt` in the <xref:System.IO.Compression.ZipArchiveEntry.FullName%2A> property.
+On Windows, colons (`:`) are also treated as separators due to NTFS rules, which can cause <xref:System.IO.Compression.ZipArchiveEntry.Name%2A> to differ across platforms. For platform-independent behavior, you can use <xref:System.IO.Compression.ZipArchiveEntry.FullName%2A>, which always reflects the complete entry name as stored in the archive.
 
 ## Examples
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,5 @@`
`1`	`1`	The <xref:System.IO.Compression.ZipArchiveEntry.Name%2A> property contains the portion of the <xref:System.IO.Compression.ZipArchiveEntry.FullName%2A> property that follows the final directory separator character (\\), and does not include the subdirectory hierarchy. For example, if you create two entries in a zip archive by using the <xref:System.IO.Compression.ZipFileExtensions.CreateEntryFromFile%2A> method and provide `NewEntry.txt` as the name for the first entry and `AddedFolder\\NewEntry.txt` for the second entry, both entries will have `NewEntry.txt` in the <xref:System.IO.Compression.ZipArchiveEntry.Name%2A> property. The first entry will also have `NewEntry.txt` in the <xref:System.IO.Compression.ZipArchiveEntry.FullName%2A> property, but the second entry will have `AddedFolder\\NewEntry.txt` in the <xref:System.IO.Compression.ZipArchiveEntry.FullName%2A> property.
	`2`	+On Windows, colons (`:`) are also treated as separators due to NTFS rules, which can cause <xref:System.IO.Compression.ZipArchiveEntry.Name%2A> to differ across platforms. For platform-independent behavior, you can use <xref:System.IO.Compression.ZipArchiveEntry.FullName%2A>, which always reflects the complete entry name as stored in the archive.
`2`	`3`
`3`	`4`	`## Examples`
`4`	`5`