diff --git a/doc/source/dotnet.rst b/doc/source/dotnet.rst
index d02a6f0cb..03d729ee5 100644
--- a/doc/source/dotnet.rst
+++ b/doc/source/dotnet.rst
@@ -42,16 +42,10 @@ application.
Before interacting with any of the objects or APIs provided by the
``Python.Runtime`` namespace, calling code must have acquired the Python
-global interpreter lock by calling the ``PythonEngine.AcquireLock``
-method. The only exception to this rule is the
-``PythonEngine.Initialize`` method, which may be called at startup
-without having acquired the GIL.
-
-When finished using Python APIs, managed code must call a corresponding
-``PythonEngine.ReleaseLock`` to release the GIL and allow other threads
-to use Python.
-
-A ``using`` statement may be used to acquire and release the GIL:
+global interpreter lock by ``using'' ``Py.GIL()``. The only exception to
+this rule is the ``PythonEngine.Initialize`` method, which may be called
+at startup without having acquired the GIL. The GIL is released again
+by disposing the return value of `Py.GIL()`:
.. code:: csharp
@@ -59,11 +53,28 @@ A ``using`` statement may be used to acquire and release the GIL:
{
PythonEngine.Exec("doStuff()");
}
+
+ // or
+ {
+ using var _ = Py.GIL()
+ PythonEngine.Exec("doStuff()");
+ }
+
+ // or
+ var gil = Py.GIL();
+ try
+ {
+ PythonEngine.Exec("doStuff()");
+ }
+ finally
+ {
+ gil.Dispose();
+ }
-The AcquireLock and ReleaseLock methods are thin wrappers over the
-unmanaged ``PyGILState_Ensure`` and ``PyGILState_Release`` functions
-from the Python API, and the documentation for those APIs applies to the
-managed versions.
+The ``Py.GIL()'' object is a thin wrapper over the unmanaged
+``PyGILState_Ensure`` (on construction) and ``PyGILState_Release`` (on
+disposal) functions from the Python API, and the documentation for those
+APIs applies to the managed versions.
Passing C# Objects to the Python Engine
---------------------------------------
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy