diff --git a/xml/System.Net/CookieContainer.xml b/xml/System.Net/CookieContainer.xml index b100c661b97..76bf26cfa53 100644 --- a/xml/System.Net/CookieContainer.xml +++ b/xml/System.Net/CookieContainer.xml @@ -77,6 +77,14 @@ The has three properties that govern the volume of the content of the container: , , and . These values have the default settings of 300, 4096, and 20 respectively. When a is added to the container, these properties are used to determine whether a already contained in the should be discarded to make room for the new one. The keeps track of each addition to ensure that neither the nor the limits are exceeded. If one or both are exceeded, then instances held by the are removed. First, any expired is removed. If further capacity must be recaptured, then the least-recently used is purged. +## Thread Safety + + The methods for adding and retrieving instances to and from a are thread-safe and can be used concurrently from multiple threads. + + > [!NOTE] + > Regardless of thread-safety, unanticipated sharing of instances can lead to issues when working with and or , since parts of the application that aren't intended to share cookies with each other might inadvertently do so. + > It is not recommended to use cookies together with . + ]]>