/// <summary>
/// 设置对象排名。
/// </summary>
/// <param name="ranking">给定的 <see cref="IObjectRanking"/>。</param>
/// <param name="newRankFactory">给定的新对象排名工厂方法。</param>
/// <returns>返回排名（兼容整数、单双精度的排序字段）。</returns>
public static object SetObjectRank(this IObjectRanking ranking,
Func <object, object> newRankFactory)
{
var currentRank = ranking.GetObjectRank();
return(ranking.SetObjectRank(newRankFactory(currentRank)));
}
/// <summary>
/// 异步设置对象排名。
/// </summary>
/// <param name="ranking">给定的 <see cref="IObjectRanking"/>。</param>
/// <param name="newRankFactory">给定的新对象排名工厂方法。</param>
/// <param name="cancellationToken">给定的 <see cref="CancellationToken"/>（可选）。</param>
/// <returns>返回一个包含排名（兼容整数、单双精度的排序字段）的异步操作。</returns>
public static async ValueTask <object> SetObjectRankAsync(this IObjectRanking ranking,
Func <object, object> newRankFactory, CancellationToken cancellationToken = default)
{
var currentRank = await ranking.GetObjectRankAsync(cancellationToken)
.DisableAwaitContext();
return(await ranking.SetObjectRankAsync(newRankFactory(currentRank),
cancellationToken).DisableAwaitContext());
}
public static object SetObjectRank(this IObjectRanking ranking,
Func <object, object> newRankFactory)
{
ranking.NotNull(nameof(ranking));
newRankFactory.NotNull(nameof(newRankFactory));
var newRank = ranking.GetObjectRank();
return(ranking.SetObjectRank(newRankFactory.Invoke(newRank)));
}
public static async ValueTask <object> SetObjectRankAsync(this IObjectRanking ranking,
Func <object, object> newRankFactory, CancellationToken cancellationToken = default)
{
ranking.NotNull(nameof(ranking));
newRankFactory.NotNull(nameof(newRankFactory));
var newRank = await ranking.GetObjectRankAsync(cancellationToken).ConfigureAwait();
return(await ranking.SetObjectRankAsync(newRankFactory.Invoke(newRank), cancellationToken)
.ConfigureAwait());
}
