Update [Alg].Create() samples for 3DES/RC2.

[bartonjs]

This updates TripleDES/3DES and RC2 to match the changes done for DES in #8227, namely:

• Removes the samples from the Create(string) overload
  • The method is being marked as Obsolete in .NET 7
  • It had a different sample than Create() for C#, but reused the Create() sample in VB and C++/CLI
• Fixes the bug in the sample that assumed CryptoStream.Read aggressively fills the destination.
• Adds using statements (or the language-specific equivalent) for all IDisposable values.
• Uses names for parameters and locals that are consistent with .NET guidelines and best practices.
• Changes C++/CLI to use function prototypes so the functions are presented in the same order across all three languages.
• Changes the method declarations in VB to a more canonical style.

The samples were all copied from their DES versions, but with the following transformations:

3DES:

• s/des/tripleDes/g
• s/DES/TripleDES/g

RC2:

• s/des/rc2/g
• s/a DES/an RC2/g
• s/DES/RC2/g

Fixes #8140.

[ghost]

Tagging subscribers to this area: @dotnet/area-system-security, @vcsjones
See info in area-owners.md if you want to be subscribed.

Issue Details

---

This updates TripleDES/3DES and RC2 to match the changes done for DES in #8227, namely:

• Removes the samples from the Create(string) overload
  • The method is being marked as Obsolete in .NET 7
  • It had a different sample than Create() for C#, but reused the Create() sample in VB and C++/CLI
• Fixes the bug in the sample that assumed CryptoStream.Read aggressively fills the destination.
• Adds using statements (or the language-specific equivalent) for all IDisposable values.
• Uses names for parameters and locals that are consistent with .NET guidelines and best practices.
• Changes C++/CLI to use function prototypes so the functions are presented in the same order across all three languages.
• Changes the method declarations in VB to a more canonical style.

The samples were all copied from their DES versions, but with the following transformations:

3DES:

• s/des/tripleDes/g
• s/DES/TripleDES/g

RC2:

• s/des/rc2/g
• s/a DES/an RC2/g
• s/DES/RC2/g

Fixes #8140.

Author:	bartonjs
Assignees:	bartonjs
Labels:	area-System.Security
Milestone:	-

[opbld30]

Docs Build status updates of commit c10a30a:

✅ Validation status: passed

File	Status	Preview URL	Details
snippets/cpp/VS_Snippets_CLR/Cryptography.3DES.Create.File/CPP/fileexample.cpp	✅Succeeded	View
snippets/cpp/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/CPP/memoryexample.cpp	✅Succeeded	View
snippets/cpp/VS_Snippets_CLR/Cryptography.RC2.Create.File/CPP/fileexample.cpp	✅Succeeded	View
snippets/cpp/VS_Snippets_CLR/Cryptography.RC2.Create.Memory/CPP/memoryexample.cpp	✅Succeeded	View
snippets/csharp/System.Security.Cryptography/RC2/Create/fileexample.cs	✅Succeeded	View
snippets/csharp/System.Security.Cryptography/RC2/Create/fileexample1.cs	✅Succeeded	n/a (file deleted)
snippets/csharp/System.Security.Cryptography/RC2/Create/memoryexample.cs	✅Succeeded	View
snippets/csharp/System.Security.Cryptography/RC2/Create/memoryexample1.cs	✅Succeeded	n/a (file deleted)
snippets/csharp/System.Security.Cryptography/RC2/Create/project.csproj	✅Succeeded
snippets/csharp/System.Security.Cryptography/TripleDES/Create/fileexample.cs	✅Succeeded	View
snippets/csharp/System.Security.Cryptography/TripleDES/Create/fileexample1.cs	✅Succeeded	n/a (file deleted)
snippets/csharp/System.Security.Cryptography/TripleDES/Create/memoryexample.cs	✅Succeeded
snippets/csharp/System.Security.Cryptography/TripleDES/Create/project.csproj	✅Succeeded
snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.File/VB/fileexample.vb	✅Succeeded	View
snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.File/VB/project.csproj	✅Succeeded
snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/project.csproj	✅Succeeded
snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/VB/memoryexample.vb	✅Succeeded	View
snippets/visualbasic/VS_Snippets_CLR/Cryptography.RC2.Create.File/VB/fileexample.vb	✅Succeeded	View
snippets/visualbasic/VS_Snippets_CLR/Cryptography.RC2.Create.File/VB/project.csproj	✅Succeeded
snippets/visualbasic/VS_Snippets_CLR/Cryptography.RC2.Create.Memory/project.csproj	✅Succeeded
snippets/visualbasic/VS_Snippets_CLR/Cryptography.RC2.Create.Memory/VB/memoryexample.vb	✅Succeeded	View
xml/System.Security.Cryptography/RC2.xml	✅Succeeded	View
xml/System.Security.Cryptography/TripleDES.xml	✅Succeeded	View

For more details, please refer to the build report.

Note: Broken links written as relative paths are included in the above build report. For broken links written as absolute paths or external URLs, see the broken link report.

For any questions, please:

• Try searching the docs.microsoft.com contributor guides
• Post your question in the Docs support channel

[bartonjs]

@gewarren https://learn.microsoft.com/en-us/dotnet/api/system.security.cryptography.tripledescryptoserviceprovider?view=net-7.0 is still showing examples from before this change. Would you happen to know why? 😄

[gewarren]

@gewarren https://learn.microsoft.com/en-us/dotnet/api/system.security.cryptography.tripledescryptoserviceprovider?view=net-7.0 is still showing examples from before this change. Would you happen to know why? 😄

@bartonjs It doesn't look like you updated those examples:

snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/CPP/fileexample.cpp
snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/fileexample.cs
snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/VB/fileexample.vb

snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/CPP/memoryexample.cpp
snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/memoryexample.cs
snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/VB/memoryexample.vb

[bartonjs]

Ah. That would, of course, do it.