ParameterVariations Class Namespace : CloudNimble.DotNetDocs.Tests.Shared.ParametersAssembly : CloudNimble.DotNetDocs.Tests.Shared.dll
📋 Definition public class ParameterVariations 📝 Summary Demonstrates various parameter patterns including optional, params, ref, out, in, and named parameters.
🎯 Members Standard Parameters
Optional Parameters
Ref/Out Parameters
Params Array
Generic Parameters
SimpleMethod public void SimpleMethod ( string text , int number ) Method with standard value parameters. Parameters :
text (string) - The text parameternumber (int) - The number parameter OptionalParameters public void OptionalParameters ( string required , int optional1 = 10 , bool optional2 = true , string optional3 = "default" ) Method demonstrating optional parameters with default values. Parameters :
required (string) - Required parameteroptional1 (int) - Optional integer, default: 10optional2 (bool) - Optional boolean, default: trueoptional3 (string) - Optional string, default: “default”
// All parameters OptionalParameters ( "test" , 20 , false , "custom" ); // Only required OptionalParameters ( "test" ); // Some optional OptionalParameters ( "test" , 20 ); RefParameter public void RefParameter ( ref int value ) Modifies the passed parameter by reference. Parameters :
value (ref int) - Value to modify OutParameter public bool TryParse ( string input , out int result ) Tries to parse input and outputs result. Parameters :
input (string) - Input to parseresult (out int) - Parsed result Returns : true if successful, false otherwiseInParameter public void ProcessLargeStruct ( in LargeStruct data ) Processes large struct without copying. Parameters :
data (in LargeStruct) - Read-only reference to data ParamsMethod public int Sum ( params int [] numbers ) Accepts variable number of integer arguments. Parameters :
numbers (params int[]) - Variable number of integers Returns : Sum of all numbers
// No arguments var sum1 = Sum (); // Single argument var sum2 = Sum ( 5 ); // Multiple arguments var sum3 = Sum ( 1 , 2 , 3 , 4 , 5 ); // Array var sum4 = Sum ( new [] { 1 , 2 , 3 }); GenericMethod<T> public T GenericMethod ` < T > `( T input ) where T : class Generic method with type constraint. Type Parameters :
T - Must be a reference type Parameters :
input (T) - Input of type T Returns : The input valueMultipleGenerics<TKey, TValue> public Dictionary ` < TKey , TValue > ` CreateDictionary ` < TKey , TValue > `() where TKey : notnull where TValue : new () Method with multiple generic parameters. Type Parameters :
TKey - Dictionary key type (non-nullable)TValue - Dictionary value type (must have default constructor) 💡 Complete Examples Ref/Out Usage
Params Usage
Named Arguments
var variations = new ParameterVariations (); // Ref parameter - must be initialized int refValue = 10 ; variations . RefParameter ( ref refValue ); Console . WriteLine ( refValue ); // Modified value // Out parameter - initialized in method if ( variations . TryParse ( "123" , out int result )) { Console . WriteLine ( $"Parsed: { result }" ); }
⚠️ Important Notes When using ref parameters, the variable must be initialized before passing. With out parameters, the method must assign a value before returning.
Use named arguments to improve code readability, especially when calling methods with multiple parameters or when skipping optional parameters.
The params keyword must be used on the last parameter only, and there can be only one params parameter per method.
