Banned APIs

The SDK enforces modern API usage via BannedApiAnalyzers.

DateTime

Use TimeProvider for testability.

Banned	Use instead
`DateTime.Now`	`TimeProvider.System.GetUtcNow()`
`DateTime.UtcNow`	`TimeProvider.System.GetUtcNow()`
`DateTimeOffset.Now`	`TimeProvider.System.GetUtcNow()`
`DateTimeOffset.UtcNow`	`TimeProvider.System.GetUtcNow()`

Use SDK’s Throw utilities.

Banned	Use instead
`ArgumentNullException.ThrowIfNull()`	`Throw.IfNull()`
`ArgumentException.ThrowIfNullOrEmpty()`	`Throw.IfNullOrEmpty()`
`ArgumentException.ThrowIfNullOrWhiteSpace()`	`Throw.IfNullOrWhiteSpace()`

Use UTC variants to avoid timezone bugs.

Show 15 banned methods

Banned	Use instead
`FileSystemInfo.CreationTime`	`CreationTimeUtc`
`FileSystemInfo.LastAccessTime`	`LastAccessTimeUtc`
`FileSystemInfo.LastWriteTime`	`LastWriteTimeUtc`
`File.GetCreationTime()`	`GetCreationTimeUtc()`
`File.GetLastAccessTime()`	`GetLastAccessTimeUtc()`
`File.GetLastWriteTime()`	`GetLastWriteTimeUtc()`
`File.SetCreationTime()`	`SetCreationTimeUtc()`
`File.SetLastAccessTime()`	`SetLastAccessTimeUtc()`
`File.SetLastWriteTime()`	`SetLastWriteTimeUtc()`
`Directory.GetCreationTime()`	`GetCreationTimeUtc()`
`Directory.GetLastAccessTime()`	`GetLastAccessTimeUtc()`
`Directory.GetLastWriteTime()`	`GetLastWriteTimeUtc()`
`Directory.SetCreationTime()`	`SetCreationTimeUtc()`
`Directory.SetLastAccessTime()`	`SetLastAccessTimeUtc()`
`Directory.SetLastWriteTime()`	`SetLastWriteTimeUtc()`

Use Ordinal for performance; InvariantCulture has overhead.

Banned	Use instead
`StringComparison.InvariantCulture`	`Ordinal`
`StringComparison.InvariantCultureIgnoreCase`	`OrdinalIgnoreCase`
`StringComparer.InvariantCulture`	`Ordinal`
`StringComparer.InvariantCultureIgnoreCase`	`OrdinalIgnoreCase`

Require explicit intent, no implicit defaults.

Banned	Fix
`Enum.TryParse()`	Add `ignoreCase` parameter
`Math.Round()`	Add `MidpointRounding` parameter
`MathF.Round()`	Add `MidpointRounding` parameter
`new CultureInfo(string)`	`CultureInfo.GetCultureInfo()` (cached)

Banned	Use instead
`Tuple<T1, ...>`	Value tuples: `(string, int)`

<PropertyGroup>
  <IncludeDefaultBannedSymbols>false</IncludeDefaultBannedSymbols>
</PropertyGroup>