From c85c071fcbd9d3397b986ac1a73234ec22d96cc2 Mon Sep 17 00:00:00 2001
From: kurnakovv <maksk210@gmail.com>
Date: Mon, 13 Oct 2025 16:15:55 +0900
Subject: [PATCH] Add code example for CA2256 rule (#49105)

---
 .../code-analysis/quality-rules/ca2256.md     |  7 ++++
 .../snippets/csharp/all-rules/ca2256.cs       | 36 +++++++++++++++++++
 2 files changed, 43 insertions(+)
 create mode 100644 docs/fundamentals/code-analysis/quality-rules/snippets/csharp/all-rules/ca2256.cs

diff --git a/docs/fundamentals/code-analysis/quality-rules/ca2256.md b/docs/fundamentals/code-analysis/quality-rules/ca2256.md
index 141b1597ee659..d6b2ec326839a 100644
--- a/docs/fundamentals/code-analysis/quality-rules/ca2256.md
+++ b/docs/fundamentals/code-analysis/quality-rules/ca2256.md
@@ -9,6 +9,8 @@ helpviewer_keywords:
 - DynamicInterfaceCastableImplementationAnalyzer
 - CA2256
 author: Youssef1313
+dev_langs:
+- CSharp
 ---
 # CA2256: All members declared in parent interfaces must have an implementation in a DynamicInterfaceCastableImplementation-attributed interface
 
@@ -32,6 +34,10 @@ Types attributed with <xref:System.Runtime.InteropServices.DynamicInterfaceCasta
 
 Implement the missing interface members.
 
+## Example
+
+:::code language="csharp" source="snippets/csharp/all-rules/ca2256.cs" id="snippet1" highlight="30":::
+
 ## When to suppress errors
 
 Do not suppress a warning from this rule.
@@ -39,3 +45,4 @@ Do not suppress a warning from this rule.
 ## See also
 
 - [Usage warnings](usage-warnings.md)
+- [CA2257: Members defined on an interface with the 'DynamicInterfaceCastableImplementationAttribute' should be 'static'](ca2257.md)
diff --git a/docs/fundamentals/code-analysis/quality-rules/snippets/csharp/all-rules/ca2256.cs b/docs/fundamentals/code-analysis/quality-rules/snippets/csharp/all-rules/ca2256.cs
new file mode 100644
index 0000000000000..8c59cb6794dd1
--- /dev/null
+++ b/docs/fundamentals/code-analysis/quality-rules/snippets/csharp/all-rules/ca2256.cs
@@ -0,0 +1,36 @@
+using System.Runtime.InteropServices;
+
+namespace ca2256
+{
+    //<snippet1>
+    interface IParent
+    {
+        void ParentMethod();
+    }
+
+    // This interface violates the rule.
+    [DynamicInterfaceCastableImplementation]
+    interface IBadChild : IParent
+    {
+        static void ChildMethod()
+        {
+            // ...
+        }
+    }
+
+    // This interface satisfies the rule.
+    [DynamicInterfaceCastableImplementation]
+    interface IGoodChild : IParent
+    {
+        static void ChildMethod()
+        {
+            // ...
+        }
+
+        void IParent.ParentMethod()
+        {
+            // ...
+        }
+    }
+    //</snippet1>
+}