add offline packages

This commit is contained in:
master
2025-11-20 23:11:44 +02:00
parent 2e276d6676
commit 8ac994ed37
1396 changed files with 2047427 additions and 0 deletions

View File

@@ -0,0 +1,5 @@
{
"version": 2,
"contentHash": "hpRMeUOqEz+I5HKu8WXnYr2HYqu2neBX+bgAwQqVLj/UnQxys8JhC6ep4Sp+rPj0mRDxSOiCFASMLxACu0jeRQ==",
"source": "/mnt/e/dev/git.stella-ops.org/local-nugets"
}

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

View File

@@ -0,0 +1,29 @@
<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
<metadata>
<id>Microsoft.Extensions.TimeProvider.Testing</id>
<version>9.10.0</version>
<authors>Microsoft</authors>
<requireLicenseAcceptance>true</requireLicenseAcceptance>
<license type="expression">MIT</license>
<licenseUrl>https://licenses.nuget.org/MIT</licenseUrl>
<icon>Icon.png</icon>
<readme>README.md</readme>
<projectUrl>https://dot.net/</projectUrl>
<description>Hand-crafted fakes to make time-related testing easier.
FakeTimeProvider implements the abstract TimeProvider class and is
specifically designed to be used for testing.</description>
<copyright>© Microsoft Corporation. All rights reserved.</copyright>
<tags>Testing TimeProvider FakeTimeProvider</tags>
<serviceable>true</serviceable>
<repository type="git" url="https://github.com/dotnet/extensions" commit="f8f779a6ea004bb1f26649719ca77d63a9d9417c" />
<dependencies>
<group targetFramework=".NETFramework4.6.2">
<dependency id="Microsoft.Bcl.TimeProvider" version="8.0.1" exclude="Build,Analyzers" />
</group>
<group targetFramework="net8.0" />
<group targetFramework="net9.0" />
</dependencies>
</metadata>
</package>

View File

@@ -0,0 +1,214 @@
# Microsoft.Extensions.TimeProvider.Testing
Provides a `FakeTimeProvider` for testing components that depend on `System.TimeProvider`.
## Install the package
From the command-line:
```console
dotnet add package Microsoft.Extensions.TimeProvider.Testing
```
Or directly in the C# project file:
```xml
<ItemGroup>
<PackageReference Include="Microsoft.Extensions.TimeProvider.Testing" Version="[CURRENTVERSION]" />
</ItemGroup>
```
## Usage Example
`FakeTimeProvider` can be used to manually adjust time to test time dependent components in a deterministic way.
`FakeTimeProvider` derives from [TimeProvider](https://learn.microsoft.com/dotnet/api/system.timeprovider) and adds the following APIs:
```csharp
public FakeTimeProvider(DateTimeOffset startDateTime)
public DateTimeOffset Start { get; }
public TimeSpan AutoAdvanceAmount { get; set; }
public void SetUtcNow(DateTimeOffset value)
public void Advance(TimeSpan delta)
public void SetLocalTimeZone(TimeZoneInfo localTimeZone)
```
### `ExpiryCache` with `TimeProvider`
The example below demonstrates the `ExpiryCache` class and how it can be tested using `FakeTimeProvider` in `ExpiryCacheTests`.
The `TimeProvider` abstraction is injected into the `ExpiryCache` class, allowing the cache to rely on `GetUtcNow()` to determine whether cache entries should be evicted based on the current time. This abstraction provides flexibility by enabling different time-related behaviors in test environments.
By using `FakeTimeProvider` in testing, we can simulate the passage of time with methods like `Advance()` and `SetUtcNow()`. This makes it possible to emulate the system's time in a controlled and predictable way during tests, ensuring that cache eviction works as expected.
```csharp
public class ExpiryCache<TKey, TValue>
{
private readonly TimeProvider _timeProvider;
private readonly ConcurrentDictionary<TKey, CacheItem> _cache = new();
private readonly TimeSpan _expirationDuration;
public ExpiryCache(TimeProvider timeProvider, TimeSpan expirationDuration)
{
_timeProvider = timeProvider ?? throw new ArgumentNullException(nameof(timeProvider));
_expirationDuration = expirationDuration;
}
public void Add(TKey key, TValue value)
{
var expirationTime = _timeProvider.GetUtcNow() + _expirationDuration;
var cacheItem = new CacheItem(value, expirationTime);
_cache[key] = cacheItem;
}
public bool TryGetValue(TKey key, out TValue value)
{
value = default;
if (_cache.TryGetValue(key, out TValue cacheItem))
{
if (cacheItem.ExpirationTime > _timeProvider.GetUtcNow())
{
value = cacheItem.Value;
return true;
}
// Remove expired item
_cache.TryRemove(key, out _);
}
return false;
}
private class CacheItem
{
public TValue Value { get; }
public DateTimeOffset ExpirationTime { get; }
public CacheItem(TValue value, DateTimeOffset expirationTime)
{
Value = value;
ExpirationTime = expirationTime;
}
}
}
using Microsoft.Extensions.Time.Testing;
public class ExpiryCacheTests
{
[Fact]
public void ExpiryCache_ShouldRemoveExpiredItems()
{
var timeProvider = new FakeTimeProvider();
var cache = new ExpiryCache<string, string>(timeProvider, TimeSpan.FromSeconds(3));
cache.Add("key1", "value1");
// Simulate time passing
timeProvider.SetUtcNow(timeProvider.GetUtcNow() + TimeSpan.FromSeconds(2));
// The item should still be in the cache
bool found = cache.TryGetValue("key1", out string value);
Assert.True(found);
Assert.Equal("value1", value);
// Simulate further time passing to be after expiration time
timeProvider.SetUtcNow(timeProvider.GetUtcNow() + TimeSpan.FromSeconds(2));
// The item should now be expired
found = cache.TryGetValue("key1", out value);
Assert.False(found);
}
}
```
## `SynchronizationContext` in xUnit Tests
### xUnit v2
Some testing libraries such as xUnit v2 provide custom `SynchronizationContext` for running tests. xUnit v2, for instance, provides `AsyncTestSyncContext` that allows to properly manage asynchronous operations within the test execution. However, it brings an issue when we test asynchronous code that uses `ConfigureAwait(false)` in combination with class like `FakeTimeProvider`. In such cases, the xUnit context may lose track of the continuation, causing the test to become unresponsive, whether the test itself is asynchronous or not.
To prevent this issue, remove the xUnit context for tests dependent on `FakeTimeProvider` by setting the synchronization context to `null`:
```csharp
SynchronizationContext.SetSynchronizationContext(null)
```
The `Advance` method is used to simulate the passage of time. Below is an example how to create a test for a code that uses `ConfigureAwait(false)` that ensures that the continuation of the awaited task (i.e., the code that comes after the await statement) works correctly. For a more realistic example, consider the following test using Polly:
```csharp
using Polly;
using Polly.Retry;
public class SomeService(TimeProvider timeProvider)
{
// Don't do this in real life, not thread safe
public int Tries { get; private set; }
private readonly ResiliencePipeline _retryPipeline = new ResiliencePipelineBuilder { TimeProvider = timeProvider }
.AddRetry(
new RetryStrategyOptions
{
ShouldHandle = new PredicateBuilder().Handle<InvalidOperationException>(),
Delay = TimeSpan.FromSeconds(1),
MaxRetryAttempts = 2,
BackoffType = DelayBackoffType.Linear,
})
.Build();
public async Task<int> PollyRetry(double taskDelay, double cancellationSeconds)
{
Tries = 0;
return await _retryPipeline.ExecuteAsync(
async _ =>
{
Tries++;
// Simulate a task that takes some time to complete
// With xUnit Context this would fail.
await timeProvider.Delay(TimeSpan.FromSeconds(taskDelay)).ConfigureAwait(false);
if (Tries < 2)
{
throw new InvalidOperationException();
}
return Tries;
},
CancellationToken.None);
}
}
using Microsoft.Extensions.Time.Testing;
public class SomeServiceTests
{
[Fact]
public void PollyRetry_ShouldHave2Tries()
{
// Arrange
// Remove xUnit Context for this test
SynchronizationContext.SetSynchronizationContext(null);
var timeProvider = new FakeTimeProvider();
var someService = new SomeService(timeProvider);
// Act
var result = someService.PollyRetry(taskDelay: 1, cancellationSeconds: 6);
// Advancing the time more than one second should resolves the first execution delay.
timeProvider.Advance(TimeSpan.FromMilliseconds(1001));
// Advancing the time more than the retry delay time of 1s,
// and less then the task execution delay should start the second try
timeProvider.Advance(TimeSpan.FromMilliseconds(1050));
// Assert
result.IsCompleted.Should().BeFalse();
someService.Tries.Should().Be(2);
}
}
```
### xUnit v3
`AsyncTestSyncContext` has been removed, more info [here](https://xunit.net/docs/getting-started/v3/migration), so above issue is no longer a problem.
## Feedback & Contributing
We welcome feedback and contributions in [our GitHub repo](https://github.com/dotnet/extensions).

View File

@@ -0,0 +1,7 @@
<Project InitialTargets="NETStandardCompatError_Microsoft_Extensions_TimeProvider_Testing_net8_0">
<Target Name="NETStandardCompatError_Microsoft_Extensions_TimeProvider_Testing_net8_0"
Condition="'$(SuppressTfmSupportBuildWarnings)' == ''">
<Warning Text="Microsoft.Extensions.TimeProvider.Testing 9.10.0 doesn't support $(TargetFramework) and has not been tested with it. Consider upgrading your TargetFramework to net8.0 or later. You may also set &lt;SuppressTfmSupportBuildWarnings&gt;true&lt;/SuppressTfmSupportBuildWarnings&gt; in the project file to ignore this warning and attempt to run in this unsupported configuration at your own risk." />
</Target>
</Project>

View File

@@ -0,0 +1,562 @@
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.Extensions.TimeProvider.Testing</name>
</assembly>
<members>
<member name="T:Microsoft.Shared.DiagnosticIds.DiagnosticIds">
<summary>
Various diagnostic IDs reported by this repo.
</summary>
<remarks>
When adding a new diagnostic ID, add a corresponding suppression to the root <c>Directory.Build.targets</c> file,
and add a documentation entry to <c>docs/list-of-diagnostics.md</c>.
</remarks>
</member>
<member name="T:Microsoft.Shared.DiagnosticIds.DiagnosticIds.Experiments">
<summary>
Experiments supported by this repo.
</summary>
</member>
<member name="T:Microsoft.Shared.Diagnostics.Throw">
<summary>
Defines static methods used to throw exceptions.
</summary>
<remarks>
The main purpose is to reduce code size, improve performance, and standardize exception
messages.
</remarks>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNull``1(``0,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/> if the specified argument is <see langword="null"/>.
</summary>
<typeparam name="T">Argument type to be checked for <see langword="null"/>.</typeparam>
<param name="argument">Object to be checked for <see langword="null"/>.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNullOrMemberNull``2(``0,``1,System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/> if the specified argument is <see langword="null"/>,
or <see cref="T:System.ArgumentException" /> if the specified member is <see langword="null"/>.
</summary>
<typeparam name="TParameter">Argument type to be checked for <see langword="null"/>.</typeparam>
<typeparam name="TMember">Member type to be checked for <see langword="null"/>.</typeparam>
<param name="argument">Argument to be checked for <see langword="null"/>.</param>
<param name="member">Object member to be checked for <see langword="null"/>.</param>
<param name="paramName">The name of the parameter being checked.</param>
<param name="memberName">The name of the member.</param>
<returns>The original value of <paramref name="member"/>.</returns>
<example>
<code language="csharp">
Throws.IfNullOrMemberNull(myObject, myObject?.MyProperty)
</code>
</example>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfMemberNull``2(``0,``1,System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentException" /> if the specified member is <see langword="null"/>.
</summary>
<typeparam name="TParameter">Argument type.</typeparam>
<typeparam name="TMember">Member type to be checked for <see langword="null"/>.</typeparam>
<param name="argument">Argument to which member belongs.</param>
<param name="member">Object member to be checked for <see langword="null"/>.</param>
<param name="paramName">The name of the parameter being checked.</param>
<param name="memberName">The name of the member.</param>
<returns>The original value of <paramref name="member"/>.</returns>
<example>
<code language="csharp">
Throws.IfMemberNull(myObject, myObject.MyProperty)
</code>
</example>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNullOrWhitespace(System.String,System.String)">
<summary>
Throws either an <see cref="T:System.ArgumentNullException"/> or an <see cref="T:System.ArgumentException"/>
if the specified string is <see langword="null"/> or whitespace respectively.
</summary>
<param name="argument">String to be checked for <see langword="null"/> or whitespace.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNullOrEmpty(System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/> if the string is <see langword="null"/>,
or <see cref="T:System.ArgumentException"/> if it is empty.
</summary>
<param name="argument">String to be checked for <see langword="null"/> or empty.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfBufferTooSmall(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentException"/> if the argument's buffer size is less than the required buffer size.
</summary>
<param name="bufferSize">The actual buffer size.</param>
<param name="requiredSize">The required buffer size.</param>
<param name="paramName">The name of the parameter to be checked.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange``1(``0,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the enum value is not valid.
</summary>
<param name="argument">The argument to evaluate.</param>
<param name="paramName">The name of the parameter being checked.</param>
<typeparam name="T">The type of the enumeration.</typeparam>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNullOrEmpty``1(System.Collections.Generic.IEnumerable{``0},System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/> if the collection is <see langword="null"/>,
or <see cref="T:System.ArgumentException"/> if it is empty.
</summary>
<param name="argument">The collection to evaluate.</param>
<param name="paramName">The name of the parameter being checked.</param>
<typeparam name="T">The type of objects in the collection.</typeparam>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentNullException(System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentNullException(System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentOutOfRangeException(System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentOutOfRangeException(System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentOutOfRangeException(System.String,System.Object,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="actualValue">The value of the argument that caused this exception.</param>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentException(System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentException(System.String,System.String,System.Exception)">
<summary>
Throws an <see cref="T:System.ArgumentException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="message">A message that describes the error.</param>
<param name="innerException">The exception that is the cause of the current exception.</param>
<remarks>
If the <paramref name="innerException"/> is not a <see langword="null"/>, the current exception is raised in a catch
block that handles the inner exception.
</remarks>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.InvalidOperationException(System.String)">
<summary>
Throws an <see cref="T:System.InvalidOperationException"/>.
</summary>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.InvalidOperationException(System.String,System.Exception)">
<summary>
Throws an <see cref="T:System.InvalidOperationException"/>.
</summary>
<param name="message">A message that describes the error.</param>
<param name="innerException">The exception that is the cause of the current exception.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.Int32,System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.UInt32,System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.Int64,System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.UInt64,System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.Double,System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="T:Microsoft.Extensions.Time.Testing.FakeTimeProvider">
<summary>
Represents a synthetic time provider that can be used to enable deterministic behavior in tests.
</summary>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.#ctor">
<summary>
Initializes a new instance of the <see cref="T:Microsoft.Extensions.Time.Testing.FakeTimeProvider"/> class.
</summary>
<remarks>
This creates a provider whose time is initially set to midnight January 1st 2000.
The provider is set to not automatically advance time each time it is read.
</remarks>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.#ctor(System.DateTimeOffset)">
<summary>
Initializes a new instance of the <see cref="T:Microsoft.Extensions.Time.Testing.FakeTimeProvider"/> class.
</summary>
<param name="startDateTime">The initial time and date reported by the provider.</param>
<remarks>
The provider is set to not automatically advance time each time it is read.
</remarks>
</member>
<member name="P:Microsoft.Extensions.Time.Testing.FakeTimeProvider.Start">
<summary>
Gets the starting date and time for this provider.
</summary>
</member>
<member name="P:Microsoft.Extensions.Time.Testing.FakeTimeProvider.AutoAdvanceAmount">
<summary>
Gets or sets the amount of time by which time advances whenever the clock is read.
</summary>
<remarks>
This defaults to <see cref="F:System.TimeSpan.Zero"/>.
</remarks>
<exception cref="T:System.ArgumentOutOfRangeException">The time value is less than <see cref="F:System.TimeSpan.Zero"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.GetUtcNow">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.SetUtcNow(System.DateTimeOffset)">
<summary>
Advances the date and time in the UTC time zone.
</summary>
<param name="value">The date and time in the UTC time zone.</param>
<exception cref="T:System.ArgumentOutOfRangeException">The supplied time value is before the current time.</exception>
<remarks>
This method simply advances time. If the time is set forward beyond the
trigger point of any outstanding timers, those timers will immediately trigger.
This is unlike the <see cref="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.AdjustTime(System.DateTimeOffset)" /> method, which has no impact
on timers.
</remarks>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.Advance(System.TimeSpan)">
<summary>
Advances time by a specific amount.
</summary>
<param name="delta">The amount of time to advance the clock by.</param>
<remarks>
Advancing time affects the timers created from this provider, and all other operations that are directly or
indirectly using this provider as a time source. Whereas when using <see cref="P:System.TimeProvider.System"/>, time
marches forward automatically in hardware, for the fake time provider the application is responsible for
doing this explicitly by calling this method.
</remarks>
<exception cref="T:System.ArgumentOutOfRangeException">The time value is less than <see cref="F:System.TimeSpan.Zero"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.AdjustTime(System.DateTimeOffset)">
<summary>
Sets the date and time in the UTC time zone.
</summary>
<param name="value">The date and time in the UTC time zone.</param>
<remarks>
This method updates the current time, and has no impact on outstanding
timers. This is similar to what happens in a real system when the system's
time is changed.
</remarks>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.GetTimestamp">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.Time.Testing.FakeTimeProvider.LocalTimeZone">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.SetLocalTimeZone(System.TimeZoneInfo)">
<summary>
Sets the local time zone.
</summary>
<param name="localTimeZone">The local time zone.</param>
</member>
<member name="P:Microsoft.Extensions.Time.Testing.FakeTimeProvider.TimestampFrequency">
<summary>
Gets the amount by which the value from <see cref="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.GetTimestamp"/> increments per second.
</summary>
<remarks>
This is fixed to the value of <see cref="F:System.TimeSpan.TicksPerSecond"/>.
</remarks>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.ToString">
<summary>
Returns a string representation this provider's idea of current time.
</summary>
<returns>A string representing the provider's current time.</returns>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.CreateTimer(System.Threading.TimerCallback,System.Object,System.TimeSpan,System.TimeSpan)">
<inheritdoc />
</member>
</members>
</doc>

View File

@@ -0,0 +1,562 @@
<?xml version="1.0"?>
<doc>
<assembly>
<name>Microsoft.Extensions.TimeProvider.Testing</name>
</assembly>
<members>
<member name="T:Microsoft.Shared.DiagnosticIds.DiagnosticIds">
<summary>
Various diagnostic IDs reported by this repo.
</summary>
<remarks>
When adding a new diagnostic ID, add a corresponding suppression to the root <c>Directory.Build.targets</c> file,
and add a documentation entry to <c>docs/list-of-diagnostics.md</c>.
</remarks>
</member>
<member name="T:Microsoft.Shared.DiagnosticIds.DiagnosticIds.Experiments">
<summary>
Experiments supported by this repo.
</summary>
</member>
<member name="T:Microsoft.Shared.Diagnostics.Throw">
<summary>
Defines static methods used to throw exceptions.
</summary>
<remarks>
The main purpose is to reduce code size, improve performance, and standardize exception
messages.
</remarks>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNull``1(``0,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/> if the specified argument is <see langword="null"/>.
</summary>
<typeparam name="T">Argument type to be checked for <see langword="null"/>.</typeparam>
<param name="argument">Object to be checked for <see langword="null"/>.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNullOrMemberNull``2(``0,``1,System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/> if the specified argument is <see langword="null"/>,
or <see cref="T:System.ArgumentException" /> if the specified member is <see langword="null"/>.
</summary>
<typeparam name="TParameter">Argument type to be checked for <see langword="null"/>.</typeparam>
<typeparam name="TMember">Member type to be checked for <see langword="null"/>.</typeparam>
<param name="argument">Argument to be checked for <see langword="null"/>.</param>
<param name="member">Object member to be checked for <see langword="null"/>.</param>
<param name="paramName">The name of the parameter being checked.</param>
<param name="memberName">The name of the member.</param>
<returns>The original value of <paramref name="member"/>.</returns>
<example>
<code language="csharp">
Throws.IfNullOrMemberNull(myObject, myObject?.MyProperty)
</code>
</example>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfMemberNull``2(``0,``1,System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentException" /> if the specified member is <see langword="null"/>.
</summary>
<typeparam name="TParameter">Argument type.</typeparam>
<typeparam name="TMember">Member type to be checked for <see langword="null"/>.</typeparam>
<param name="argument">Argument to which member belongs.</param>
<param name="member">Object member to be checked for <see langword="null"/>.</param>
<param name="paramName">The name of the parameter being checked.</param>
<param name="memberName">The name of the member.</param>
<returns>The original value of <paramref name="member"/>.</returns>
<example>
<code language="csharp">
Throws.IfMemberNull(myObject, myObject.MyProperty)
</code>
</example>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNullOrWhitespace(System.String,System.String)">
<summary>
Throws either an <see cref="T:System.ArgumentNullException"/> or an <see cref="T:System.ArgumentException"/>
if the specified string is <see langword="null"/> or whitespace respectively.
</summary>
<param name="argument">String to be checked for <see langword="null"/> or whitespace.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNullOrEmpty(System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/> if the string is <see langword="null"/>,
or <see cref="T:System.ArgumentException"/> if it is empty.
</summary>
<param name="argument">String to be checked for <see langword="null"/> or empty.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfBufferTooSmall(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentException"/> if the argument's buffer size is less than the required buffer size.
</summary>
<param name="bufferSize">The actual buffer size.</param>
<param name="requiredSize">The required buffer size.</param>
<param name="paramName">The name of the parameter to be checked.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange``1(``0,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the enum value is not valid.
</summary>
<param name="argument">The argument to evaluate.</param>
<param name="paramName">The name of the parameter being checked.</param>
<typeparam name="T">The type of the enumeration.</typeparam>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfNullOrEmpty``1(System.Collections.Generic.IEnumerable{``0},System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/> if the collection is <see langword="null"/>,
or <see cref="T:System.ArgumentException"/> if it is empty.
</summary>
<param name="argument">The collection to evaluate.</param>
<param name="paramName">The name of the parameter being checked.</param>
<typeparam name="T">The type of objects in the collection.</typeparam>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentNullException(System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentNullException(System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentNullException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentOutOfRangeException(System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentOutOfRangeException(System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentOutOfRangeException(System.String,System.Object,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="actualValue">The value of the argument that caused this exception.</param>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentException(System.String,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.ArgumentException(System.String,System.String,System.Exception)">
<summary>
Throws an <see cref="T:System.ArgumentException"/>.
</summary>
<param name="paramName">The name of the parameter that caused the exception.</param>
<param name="message">A message that describes the error.</param>
<param name="innerException">The exception that is the cause of the current exception.</param>
<remarks>
If the <paramref name="innerException"/> is not a <see langword="null"/>, the current exception is raised in a catch
block that handles the inner exception.
</remarks>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.InvalidOperationException(System.String)">
<summary>
Throws an <see cref="T:System.InvalidOperationException"/>.
</summary>
<param name="message">A message that describes the error.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.InvalidOperationException(System.String,System.Exception)">
<summary>
Throws an <see cref="T:System.InvalidOperationException"/>.
</summary>
<param name="message">A message that describes the error.</param>
<param name="innerException">The exception that is the cause of the current exception.</param>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.Int32,System.Int32,System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.Int32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.UInt32,System.UInt32,System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.UInt32,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.Int64,System.Int64,System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.Int64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.UInt64,System.UInt64,System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.UInt64,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThan(System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less than min.
</summary>
<param name="argument">Number to be expected being less than min.</param>
<param name="min">The number that must be less than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThan(System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater than max.
</summary>
<param name="argument">Number to be expected being greater than max.</param>
<param name="max">The number that must be greater than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfLessThanOrEqual(System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is less or equal than min.
</summary>
<param name="argument">Number to be expected being less or equal than min.</param>
<param name="min">The number that must be less or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfGreaterThanOrEqual(System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is greater or equal than max.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="max">The number that must be greater or equal than the argument.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfOutOfRange(System.Double,System.Double,System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is not in the specified range.
</summary>
<param name="argument">Number to be expected being greater or equal than max.</param>
<param name="min">The lower bound of the allowed range of argument values.</param>
<param name="max">The upper bound of the allowed range of argument values.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="M:Microsoft.Shared.Diagnostics.Throw.IfZero(System.Double,System.String)">
<summary>
Throws an <see cref="T:System.ArgumentOutOfRangeException"/> if the specified number is equal to 0.
</summary>
<param name="argument">Number to be expected being not equal to zero.</param>
<param name="paramName">The name of the parameter being checked.</param>
<returns>The original value of <paramref name="argument"/>.</returns>
</member>
<member name="T:Microsoft.Extensions.Time.Testing.FakeTimeProvider">
<summary>
Represents a synthetic time provider that can be used to enable deterministic behavior in tests.
</summary>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.#ctor">
<summary>
Initializes a new instance of the <see cref="T:Microsoft.Extensions.Time.Testing.FakeTimeProvider"/> class.
</summary>
<remarks>
This creates a provider whose time is initially set to midnight January 1st 2000.
The provider is set to not automatically advance time each time it is read.
</remarks>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.#ctor(System.DateTimeOffset)">
<summary>
Initializes a new instance of the <see cref="T:Microsoft.Extensions.Time.Testing.FakeTimeProvider"/> class.
</summary>
<param name="startDateTime">The initial time and date reported by the provider.</param>
<remarks>
The provider is set to not automatically advance time each time it is read.
</remarks>
</member>
<member name="P:Microsoft.Extensions.Time.Testing.FakeTimeProvider.Start">
<summary>
Gets the starting date and time for this provider.
</summary>
</member>
<member name="P:Microsoft.Extensions.Time.Testing.FakeTimeProvider.AutoAdvanceAmount">
<summary>
Gets or sets the amount of time by which time advances whenever the clock is read.
</summary>
<remarks>
This defaults to <see cref="F:System.TimeSpan.Zero"/>.
</remarks>
<exception cref="T:System.ArgumentOutOfRangeException">The time value is less than <see cref="F:System.TimeSpan.Zero"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.GetUtcNow">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.SetUtcNow(System.DateTimeOffset)">
<summary>
Advances the date and time in the UTC time zone.
</summary>
<param name="value">The date and time in the UTC time zone.</param>
<exception cref="T:System.ArgumentOutOfRangeException">The supplied time value is before the current time.</exception>
<remarks>
This method simply advances time. If the time is set forward beyond the
trigger point of any outstanding timers, those timers will immediately trigger.
This is unlike the <see cref="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.AdjustTime(System.DateTimeOffset)" /> method, which has no impact
on timers.
</remarks>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.Advance(System.TimeSpan)">
<summary>
Advances time by a specific amount.
</summary>
<param name="delta">The amount of time to advance the clock by.</param>
<remarks>
Advancing time affects the timers created from this provider, and all other operations that are directly or
indirectly using this provider as a time source. Whereas when using <see cref="P:System.TimeProvider.System"/>, time
marches forward automatically in hardware, for the fake time provider the application is responsible for
doing this explicitly by calling this method.
</remarks>
<exception cref="T:System.ArgumentOutOfRangeException">The time value is less than <see cref="F:System.TimeSpan.Zero"/>.</exception>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.AdjustTime(System.DateTimeOffset)">
<summary>
Sets the date and time in the UTC time zone.
</summary>
<param name="value">The date and time in the UTC time zone.</param>
<remarks>
This method updates the current time, and has no impact on outstanding
timers. This is similar to what happens in a real system when the system's
time is changed.
</remarks>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.GetTimestamp">
<inheritdoc />
</member>
<member name="P:Microsoft.Extensions.Time.Testing.FakeTimeProvider.LocalTimeZone">
<inheritdoc />
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.SetLocalTimeZone(System.TimeZoneInfo)">
<summary>
Sets the local time zone.
</summary>
<param name="localTimeZone">The local time zone.</param>
</member>
<member name="P:Microsoft.Extensions.Time.Testing.FakeTimeProvider.TimestampFrequency">
<summary>
Gets the amount by which the value from <see cref="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.GetTimestamp"/> increments per second.
</summary>
<remarks>
This is fixed to the value of <see cref="F:System.TimeSpan.TicksPerSecond"/>.
</remarks>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.ToString">
<summary>
Returns a string representation this provider's idea of current time.
</summary>
<returns>A string representing the provider's current time.</returns>
</member>
<member name="M:Microsoft.Extensions.Time.Testing.FakeTimeProvider.CreateTimer(System.Threading.TimerCallback,System.Object,System.TimeSpan,System.TimeSpan)">
<inheritdoc />
</member>
</members>
</doc>

View File

@@ -0,0 +1 @@
GCkN+qw/b+vqGCdJflGlgb2+z00H9ARxpaDeYw+M6YMEVSYNvJcuWHFlEkV0doxm8ZNQwJ1PGfYko9me8Kqs+g==