Document InvalidOperationException for AsyncReaderWriterLock acquisition methods

[Copilot]

This PR adds XML documentation for the InvalidOperationException that is thrown by lock acquisition methods (ReadLockAsync, UpgradeableReadLockAsync, WriteLockAsync) when Complete() has been called on the AsyncReaderWriterLock.

Changes Made

• Added /// <exception cref="InvalidOperationException"> documentation to all five lock acquisition method overloads
• Fixed incorrect summary documentation for UpgradeableReadLockAsync(LockFlags) method (was incorrectly described as "Obtains a read lock" instead of "Obtains an upgradeable read lock")

Background

When AsyncReaderWriterLock.Complete() is called, the lock is marked for completion and any subsequent new top-level lock requests throw an InvalidOperationException with the message:

"This lock has already been marked for completion. No new top-level locks can be serviced."

This behavior was already implemented and tested (see CompleteBlocksNewTopLevelLocksSTA and CompleteBlocksNewTopLevelLocksMTA tests), but the public API methods lacked documentation about this exception.

Example

var asyncLock = new AsyncReaderWriterLock();
asyncLock.Complete();

// This will now throw InvalidOperationException as documented
using (await asyncLock.ReadLockAsync()) 
{
    // This code won't execute
}

The changes are minimal and only add documentation without modifying any functionality.

Fixes #1128.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

• 1elvsblobprodwus2177.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• 2wrvsblobprodwus2180.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• 31bvsblobprodwus2143.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• 5o1vsblobprodwus2115.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• 78kvsblobprodwus2152.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• 8wdvsblobprodwus2137.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• 9yyvsblobprodwus2157.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• abcvsblobprodwus2161.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• an0vsblobprodwus2146.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• b15vsblobprodwus2164.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• b53vsblobprodwus2154.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• cffvsblobprodwus218.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• d94vsblobprodwus2119.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• dyrvsblobprodwus2173.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• fcwvsblobprodwus2113.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• h8evsblobprodwus2120.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• i01vsblobprodwus216.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• isovsblobprodwus211.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• jk4vsblobprodwus2186.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• jlovsblobprodwus2163.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• km4vsblobprodwus2183.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• mdcvsblobprodwus2159.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• nypvsblobprodwus2178.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• pkwvsblobprodwus2126.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• s0ivsblobprodwus2134.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• s8nvsblobprodwus2158.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• v41vsblobprodwus2175.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• vd2vsblobprodwus2150.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• vipvsblobprodwus2139.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• wztvsblobprodwus2155.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• x0dvsblobprodwus2111.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• x1mvsblobprodwus2181.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• xktvsblobprodwus2141.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• xofvsblobprodwus2114.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• y1mvsblobprodwus2138.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
• z2bvsblobprodwus2185.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)
  • Triggering command: dotnet build src/Microsoft.VisualStudio.Threading/Microsoft.VisualStudio.Threading.csproj --nologo (dns block)
• zaxvsblobprodwus215.vsblob.vsassets.io
  • Triggering command: dotnet build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to my firewall allow list

[AArnott]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).