To combine policies, you build each policy separately, then combine them using PolicyWrap.
To build an overall timeout which applies across all retries as a whole (ie across the entire operation):
var overallTimeoutPolicy = Policy.TimeoutAsync(60);
var waitAndRetryPolicy = Policy
.Handle<WhateverException>()
.WaitAndRetryAsync(/* your wait-and-retry specification*/);
var combinedPolicy = overallTimeoutPolicy.WrapAsync(waitAndRetryPolicy);
await combinedPolicy.ExecuteAsync(cancellationToken => ...)
To impose a timeout on each specific try, wrap the retry and timeout policies in the other order:
var timeoutPerTry = Policy.TimeoutAsync(10);
var waitAndRetryPolicy = Policy
.Handle<WhateverException>()
.WaitAndRetryAsync(/* your wait-and-retry specification*/);
var combinedPolicy = waitAndRetryPolicy.WrapAsync(timeoutPerTry);
await combinedPolicy.ExecuteAsync(cancellationToken => ...);
Or even use both kinds of timeout (per-try, per-overall-operation):
var overallTimeout = Policy.TimeoutAsync(60);
var timeoutPerTry = Policy.TimeoutAsync(10);
var waitAndRetryPolicy = Policy
.Handle<WhateverException>()
.WaitAndRetryAsync(/* your wait-and-retry specification*/);
var combinedPolicy = Policy
.WrapAsync(overallTimeout, waitAndRetryPolicy, timeoutPerTry); // demonstrates alternative PolicyWrap syntax
await combinedPolicy.ExecuteAsync(cancellationToken => ...);
The PolicyWrap wiki gives full syntax details, and advice on the effects of different orderings, when combining policies within a wrap.
To answer:
Does the timeout become a common setting for all my retry policies?
Policies apply wherever you use them (whether used individually, or as part of a PolicyWrap
).
You can thread-safely use any TimeoutPolicy
instance you have configured at multiple call sites. So, to apply that timeout as a common setting for all your retry policies, simply include that same TimeoutPolicy
instance in the PolicyWrap
for each call site. The single TimeoutPolicy
instance can safely be wrapped with different retry policy instances, if desired.
If both your wait-and-retry specification, and timeout specification, are common for all call sites, simply make one PolicyWrap
instance encompassing both (per above code examples), and re-use that PolicyWrap
instance everywhere. Again - thread safe.