Replace inline code with snippet reference to eliminate duplication

Co-authored-by: BillWagner <[email protected]>

Author: Copilot

docs/visual-basic/misc/bc42328.md

@@ -30,39 +30,9 @@ This warning appears when Visual Basic can handle the assignment through relaxed
 
 The following example shows one scenario that produces BC42328:
 
-```vb
-Public Class FileProcessor
-    ' Define an event using the standard EventHandler delegate
-    ' EventHandler expects: Sub(sender As Object, e As EventArgs)
-    Public Event ProcessingComplete As EventHandler
-    
-    ' Method with exact signature - no warning
-    Private Sub OnProcessingComplete(sender As Object, e As EventArgs)
-        Console.WriteLine($"Processing completed by {sender}")
-    End Sub
-    
-    ' Method with simplified signature - this causes BC42328 warning
-    Private Sub OnSimpleComplete()
-        Console.WriteLine("Processing is done!")
-    End Sub
-    
-    Public Sub StartProcessing()
-        ' This works fine - exact signature match
-        AddHandler ProcessingComplete, AddressOf OnProcessingComplete
-        
-        ' This generates BC42328 warning:
-        ' "The 'AddressOf' expression has no effect in this context because 
-        '  the method argument to 'AddressOf' requires a relaxed conversion 
-        '  to the delegate type of the event"
-        AddHandler ProcessingComplete, AddressOf OnSimpleComplete
-        
-        ' Simulate completion
-        RaiseEvent ProcessingComplete(Me, EventArgs.Empty)
-    End Sub
-End Class
-```
+:::code language="vb" source="snippets/bc42328/AddressOfExample.vb" id="DocumentProcessor":::
 
-When you compile this code, Visual Basic shows the BC42328 warning for the second `AddHandler` statement because `OnSimpleComplete` doesn't match the `EventHandler` signature exactly.
+When you compile this code, Visual Basic shows the BC42328 warning for the `AddHandler` statements that use relaxed delegate conversion.
 
 ## Why AddressOf appears to have "no effect"
 
@@ -74,70 +44,70 @@ However, `AddressOf` is still syntactically required in `AddHandler` and `Remove
 
 ## To correct this error
 
-You have several options depending on your needs. Using the `FileProcessor` example from previously, here are the different ways to resolve the BC42328 warning:
+You have several options depending on your needs. Using the `DocumentProcessor` example from previously, here are the different ways to resolve the BC42328 warning:
 
 ### Option 1: Assign to a variable first (preserves exact semantics)
 
 ```vb
-Public Sub StartProcessing()
+Public Sub DemonstrateHandler()
     ' Create delegate variable first - this eliminates the warning
-    Dim handler As EventHandler = AddressOf OnSimpleComplete
-    AddHandler ProcessingComplete, handler
+    Dim handler As EventHandler = AddressOf OnDocumentProcessed_Simple
+    AddHandler DocumentProcessed, handler
 End Sub
 ```
 
 ### Option 2: Match the delegate signature exactly
 
 ```vb
 ' Change the method signature to match EventHandler exactly
-Private Sub OnSimpleComplete(sender As Object, e As EventArgs)
+Private Sub OnDocumentProcessed_Simple(sender As Object, e As EventArgs)
     ' You can ignore the parameters if you don't need them
-    Console.WriteLine("Processing is done!")
+    Console.WriteLine("Document processed (simple)")
 End Sub
 
-Public Sub StartProcessing()
+Public Sub DemonstrateHandler()
     ' Now this works without warning
-    AddHandler ProcessingComplete, AddressOf OnSimpleComplete
+    AddHandler DocumentProcessed, AddressOf OnDocumentProcessed_Simple
 End Sub
 ```
 
 ### Option 3: Use a lambda expression
 
 ```vb
-Public Sub StartProcessing()
+Public Sub DemonstrateHandler()
     ' Wrap the method call in a lambda that matches the signature
-    AddHandler ProcessingComplete, Sub(sender, e) OnSimpleComplete()
+    AddHandler DocumentProcessed, Sub(sender, e) OnDocumentProcessed_Simple()
 
     ' Or create a more complex lambda inline
-    AddHandler ProcessingComplete, 
+    AddHandler DocumentProcessed, 
         Sub(sender, e) 
             Console.WriteLine($"Event from {sender}")
-            OnSimpleComplete()
+            OnDocumentProcessed_Simple()
         End Sub
 End Sub
 ```
 
 ### Option 4: Use the `Handles` clause (if appropriate)
 
 ```vb
-Public Class FileProcessor
+Public Class DocumentHandler
     ' Declare the event source with WithEvents
-    Private WithEvents processor As FileProcessor
+    Private WithEvents processor As DocumentProcessor
 
     ' Use Handles clause - no AddHandler needed
-    Private Sub OnSimpleComplete() Handles processor.ProcessingComplete
-        Console.WriteLine("Processing is done!")
+    Private Sub OnDocumentComplete() Handles processor.DocumentProcessed
+        Console.WriteLine("Document processing is done!")
     End Sub
 End Class
 ```
 
 ### Option 5: Direct assignment to delegate variable
 
 ```vb
-Public Sub StartProcessing()
+Public Sub DemonstrateHandler()
     ' Assign to delegate variable then use with AddHandler
-    Dim handler As EventHandler = AddressOf OnSimpleComplete
-    AddHandler ProcessingComplete, handler
+    Dim handler As EventHandler = AddressOf OnDocumentProcessed_Simple
+    AddHandler DocumentProcessed, handler
 End Sub
 ```
 

docs/visual-basic/misc/snippets/bc42328/AddressOfExample.vb

@@ -1,5 +1,6 @@
 Imports System
 
+' <DocumentProcessor>
 Public Class DocumentProcessor
     ' Standard .NET event using EventHandler
     Public Event DocumentProcessed As EventHandler
@@ -64,6 +65,7 @@ Public Class DocumentProcessor
         RaiseEvent StatusChanged("All solutions work")
     End Sub
 End Class
+' </DocumentProcessor>
 
 Module Program
     Sub Main()