Merge pull request #41758 from dotnet/main

Merge main into live
dotnet · Jul 15, 2024 · 2989762 · 2989762
2 parents cddcb28 + 28c0d30
commit 2989762
Showing 1 changed file with 2 additions and 0 deletions.
diff --git a/docs/standard/native-interop/best-practices.md b/docs/standard/native-interop/best-practices.md
@@ -23,6 +23,8 @@ The guidance in this section applies to all interop scenarios.
 - ✔️ CONSIDER using <xref:System.Buffers.ArrayPool%601?displayProperty=nameWithType> to pool your native array buffers.
 - ✔️ CONSIDER wrapping your P/Invoke declarations in a class with the same name and capitalization as your native library.
   - This allows your `[LibraryImport]` or `[DllImport]` attributes to use the C# `nameof` language feature to pass in the name of the native library and ensure that you didn't misspell the name of the native library.
+- ✔️ DO use `SafeHandle` handles to manage lifetime of objects that encapsulate unmanaged resources. For more information, see [Cleaning up unmanaged resources](../garbage-collection/unmanaged.md).
+- ❌ AVOID finalizers to manage lifetime of objects that encapsulate unmanaged resources. For more information, see [Implement a Dispose method](../garbage-collection/implementing-dispose.md).
 
 ## LibraryImport attribute settings