diff --git a/README.md b/README.md
index 1415cc4..23b5103 100644
--- a/README.md
+++ b/README.md
@@ -519,11 +519,67 @@ 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:
+
+```csharp
+using (Py.GIL())
+{
+ PythonEngine.Exec("doStuff()");
+}
+```
+
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.
+## Passing C# Objects to the Python Engine
+
+This section demonstrates how to pass a C# object to the Python runtime.
+The example uses the following `Person` class:
+
+```csharp
+public class Person
+{
+ public Person(string firstName, string lastName)
+ {
+ FirstName = firstName;
+ LastName = lastName;
+ }
+
+ public string FirstName { get; set; }
+ public string LastName { get; set; }
+}
+```
+
+In order to pass a C# object to the Python runtime, it must be converted to a
+`PyObject`. This is done using the `ToPython()` extension method. The `PyObject`
+may then be set as a variable in a `PyScope`. Code executed from the scope
+will have access to the variable:
+
+```csharp
+// create a person object
+Person person = new Person("John", "Smith");
+
+// acquire the GIL before using the Python interpreter
+using (Py.GIL())
+{
+ // create a Python scope
+ using (PyScope scope = Py.CreateScope())
+ {
+ // convert the Person object to a PyObject
+ PyObject pyPerson = person.ToPython();
+
+ // create a Python variable "person"
+ scope.Set("person", pyPerson);
+
+ // the person object may now be used in Python
+ string code = "fullName = person.FirstName + ' ' + person.LastName";
+ scope.Exec(code);
+ }
+}
+```
+
## License
Python for .NET is released under the open source MIT License.
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