Skip to content

Link copying-and-pinning article to existing code examples #52483

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Copilot wants to merge 3 commits into
base: main
Choose a base branch
from
+5 −2
Open

Link copying-and-pinning article to existing code examples #52483

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
0079b20
Initial plan
Copilot Mar 20, 2026
a3f95a3
Add links to pinning examples in copying-and-pinning.md
Copilot Mar 20, 2026
b23c0db
Apply suggestions from code review
BillWagner Mar 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 5 additions & 2 deletions docs/framework/interop/copying-and-pinning.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
---
title: "Copying and Pinning"
description: Review how the interop marshaller can copy or pin data that's being marshalled. Copying data places a copy of data from one memory location into another location.
ms.date: 05/12/2022
ms.date: 03/20/2026
ai-usage: ai-assisted
helpviewer_keywords:
- "pinning, interop marshalling"
- "copying, interop marshalling"
Expand All @@ -19,7 +20,7 @@ Method arguments passed by value are marshalled to unmanaged code as values on t

![Diagram showing reference types passed by value and by reference.](./media/copying-and-pinning/interop-marshal-reference-pin.gif)

Pinning temporarily locks the data in its current memory location, thus keeping it from being relocated by the common language runtime's garbage collector. The marshaller pins data to reduce the overhead of copying and enhance performance. The type of the data determines whether it is copied or pinned during the marshalling process. Pinning is automatically performed during marshalling for objects such as <xref:System.String>, however you can also manually pin memory using the <xref:System.Runtime.InteropServices.GCHandle> class.
Pinning temporarily locks the data in its current memory location, thus keeping it from being relocated by the common language runtime's garbage collector. The marshaller pins data to reduce the overhead of copying and enhance performance. The type of the data determines whether it is copied or pinned during the marshalling process. Pinning is automatically performed during marshalling for objects such as <xref:System.String>. However you can also manually pin memory using the <xref:System.Runtime.InteropServices.GCHandle> class. For examples of manual pinning with `GCHandle`, see [Keeping managed objects alive](../../standard/native-interop/best-practices.md#keeping-managed-objects-alive) in the native interoperability best practices article.

## Formatted Blittable Classes

Expand Down Expand Up @@ -78,3 +79,5 @@ When a <xref:System.Text.StringBuilder?displayProperty=nameWithType> is passed b
- [Default Marshalling Behavior](default-marshalling-behavior.md)
- [Directional Attributes](/previous-versions/dotnet/netframework-4.0/77e6taeh(v=vs.100))
- [Interop Marshaling](interop-marshalling.md)
- [Native interoperability best practices](../../standard/native-interop/best-practices.md)
- [fixed statement (C# reference)](../../csharp/language-reference/statements/fixed.md)
Copy link
Contributor

@gewarren gewarren Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [fixed statement (C# reference)](../../csharp/language-reference/statements/fixed.md)
- [`fixed` statement (C# reference)](../../csharp/language-reference/statements/fixed.md)

Loading