dotnet / dotnet/dotnet-api-docs

update GC.TryStartNoGCRegion doc

Aperta
#8,366 2 commenti 0 reazioni 1 assegnatario Rivendicata da @cshung Vedi su GitHub
area-System.Runtime doc-enhancement Pri1 untriaged
Lingua principale
C#
Stelle
949
Fork
1.7k
Merge medio
2g 19h
PR unite (30g)
52

Descrizione

**Issue description**

the [doc](https://docs.microsoft.com/en-us/dotnet/api/system.gc.trystartnogcregion?view=net-6.0) requires some updates after our 7.0 work. an important update should be the ephemeral segment size limit for specifying the size which is no longer the case for 7.0.

also in general I noticed we didn't specify enough details for the API behavior such as

+ what happens to the latency mode when an exception is thrown
+ if you have allocated more than the size you specified what is the behavior (ie, a GC will happen and we will exit the NoGCRegion mode and revert back to the previous latency mode)

since customers can check the latency mode before they decide whether they want to call the API it's important to spell out the behavior wrt latency mode.

**Target framework**

- [x] .NET Core
- [ ] .NET Framework
- [ ] .NET Standard

Guida per i contributori

Apri la guida per i contributori

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.