/// <summary>
/// 附加年份与周数后缀（如：_2051）。
/// </summary>
/// <param name="table">给定的 <see cref="TableDescriptor"/>。</param>
/// <param name="timestamp">给定的 <see cref="DateTimeOffset"/>。</param>
/// <param name="formatName">给定的格式化名称（可选）。</param>
/// <returns>返回 <see cref="TableDescriptor"/>。</returns>
public static TableDescriptor AppendYearAndWeekSuffix(this TableDescriptor table, DateTimeOffset timestamp,
Func <string, string> formatName = null)
{
var suffix = timestamp.ToString(DefaultYearFormat, CultureInfo.InvariantCulture);
return(table.AppendSuffix(suffix + timestamp.AsWeekOfYear().FormatString(2), formatName));
}
/// <summary>
/// 附加时间戳后缀（通常用于生成含有日期与时间的表名；如：_200410）。
/// </summary>
/// <param name="table">给定的 <see cref="TableDescriptor"/>。</param>
/// <param name="timestamp">给定的 <see cref="DateTimeOffset"/>。</param>
/// <param name="format">给定的格式化方式（可选；默认为 <see cref="DefaultTimestampFormat"/>）。</param>
/// <param name="formatName">给定的格式化名称（可选）。</param>
/// <returns>返回 <see cref="TableDescriptor"/>。</returns>
public static TableDescriptor AppendTimestampSuffix(this TableDescriptor table, DateTimeOffset timestamp, string format = null,
Func <string, string> formatName = null)
{
var suffix = timestamp.ToString(format.NotEmptyOrDefault(DefaultTimestampFormat, throwIfDefaultInvalid: false),
CultureInfo.InvariantCulture);
return(table.AppendSuffix(suffix, formatName));
}
/// <summary>
/// 插入前缀。
/// </summary>
/// <param name="table">给定的 <see cref="TableDescriptor"/>。</param>
/// <param name="prefix">给定的前缀。</param>
/// <param name="formatName">给定的格式化名称（可选）。</param>
/// <returns>返回 <see cref="TableDescriptor"/>。</returns>
public static TableDescriptor InsertPrefix(this TableDescriptor table, string prefix,
Func <string, string> formatName = null)
=> table?.ChangeName(name => $"{prefix.NotEmpty(nameof(prefix))}{table.NameConnector}{formatName?.Invoke(name) ?? name}");
=> table.InsertPrefix(DataPrefix, name => name.TrimStart(DataPrefix)); // 清除默认实体名称的前缀
/// <summary>
/// 插入私有标记前缀（如：__）。
/// </summary>
/// <param name="table">给定的 <see cref="TableDescriptor"/>。</param>
/// <param name="formatName">给定的格式化名称（可选）。</param>
/// <returns>返回 <see cref="TableDescriptor"/>。</returns>
public static TableDescriptor InsertPrivatePrefix(this TableDescriptor table,
Func <string, string> formatName = null)
=> table.InsertPrefix(TableDescriptor.DefautlNameConnector, formatName);
/// <summary> /// 插入数据标记前缀（如：Data_）。 /// </summary> /// <param name="table">给定的 <see cref="TableDescriptor"/>。</param> /// <returns>返回 <see cref="TableDescriptor"/>。</returns> public static TableDescriptor InsertDataPrefix(this TableDescriptor table) => table.InsertPrefix(DataPrefix, name => name.TrimStart(DataPrefix)); // 清除默认实体名称的前缀
/// <summary>
/// 附加后缀。
/// </summary>
/// <param name="table">给定的 <see cref="TableDescriptor"/>。</param>
/// <param name="suffix">给定的后缀。</param>
/// <param name="formatName">给定的格式化名称（可选）。</param>
/// <returns>返回 <see cref="TableDescriptor"/>。</returns>
public static TableDescriptor AppendSuffix(this TableDescriptor table, string suffix,
Func <string, string> formatName = null)
=> table?.ChangeName(name => $"{formatName?.Invoke(name) ?? name}{table.NameConnector}{suffix.NotEmpty(nameof(suffix))}");
/// <summary>
/// 附加年份与月份后缀（如：_2009）。
/// </summary>
/// <param name="table">给定的 <see cref="TableDescriptor"/>。</param>
/// <param name="timestamp">给定的 <see cref="DateTimeOffset"/>。</param>
/// <param name="formatName">给定的格式化名称（可选）。</param>
/// <returns>返回 <see cref="TableDescriptor"/>。</returns>
public static TableDescriptor AppendYearAndMonthSuffix(this TableDescriptor table, DateTimeOffset timestamp,
Func <string, string> formatName = null)
=> table.AppendTimestampSuffix(timestamp, DefaultYearAndMonthFormat, formatName);
