Istruzioni per l'uso dei parametri

Le istruzioni per l'uso dei parametri sono definite dalle regole riportate di seguito.

• Controllare gli argomenti di parametri validi. Eseguire la convalida degli argomenti per ciascun metodo public o protected e per la funzione di accesso set della proprietà. Attivare eccezioni significative per lo sviluppatore per gli argomenti di parametri non validi. Utilizzare la classe System.ArgumentException o una classe derivata da System.ArgumentException. Nell'esempio riportato di seguito vengono controllati gli argomenti di parametri validi e vengono generate eccezioni significative.

  Class SampleClass
     Private countValue As Integer
     Private maxValue As Integer = 100
  
     Public Property Count() As Integer      
        Get
           Return countValue
        End Get
        Set
           ' Check for valid parameter.
           If value < 0 Or value >= maxValue Then
              Throw New ArgumentOutOfRangeException("value", value, 
                 "Value is invalid.")
           End If
           countValue = value
        End Set
     End Property
     Public Sub SelectItem(start As Integer, [end] As Integer)
        ' Check for valid parameter.
        If start < 0 Then
           Throw New ArgumentOutOfRangeException("start", start, "Start 
              is invalid.")
        End If
        ' Check for valid parameter.
        If [end] < start Then
           Throw New ArgumentOutOfRangeException("end", [end], "End is 
                 invalid.")
        End If 
        ' Insert code to do other work here.
        Console.WriteLine("Starting at {0}", start)
        Console.WriteLine("Ending at {0}", [end])
     End Sub 
  End Class
  [C#]
  class SampleClass
  {
     public int Count
     {
        get
        {
           return count;
        }
        set
        {
              // Check for valid parameter.
              if (count < 0 || count >= MaxValue)
                 throw newArgumentOutOfRangeException(
                    Sys.GetString(
                       "InvalidArgument","value",count.ToString()));
        }
     }
  
     public void Select(int start, int end)
     {
        // Check for valid parameter.
        if (start < 0)
           throw new ArgumentException(
                 Sys.GetString("InvalidArgument","start",start.ToString()));
        // Check for valid parameter.
        if (end < start)
           throw new ArgumentException(
                 Sys.GetString("InvalidArgument","end",end.ToString()));
     }
  }
  

  Si noti che il controllo effettivo non deve essere necessariamente eseguito nel metodo public o protected stesso, ma può anche essere effettuato a un livello inferiore nelle routine private. Il punto principale è che la validità degli argomenti deve essere controllata nell'intera area della superficie esposta allo sviluppatore.

• Valutare accuratamente le implicazioni connesse al passaggio di parametri per valore o per riferimento. Passando un parametro per valore, il valore viene copiato e l'operazione non influisce sul valore originale. Nell'esempio di metodo riportato di seguito, i parametri vengono passati per valore.

  public void Add(object value){}
  

  Passando un parametro per riferimento, viene passato il punto di archiviazione del valore. Di conseguenza, possono essere apportate modifiche al valore del parametro. Nell'esempio di metodo riportato di seguito viene passato un parametro per valore.

  public static int Exchange(ref int location, int value){}
  

  Un parametro di output rappresenta lo stesso percorso di archiviazione della variabile specificata come argomento nella chiamata di metodo. Di conseguenza, possono essere apportate modifiche solo al parametro di output. Nell'esempio di metodo riportato di seguito viene passato un parametro out.

  [DllImport("Kernel32.dll"]
  public static extern bool QueryPerformanceCounter(out long value)
  

Vedere anche

Istruzioni di progettazione per gli sviluppatori di librerie di classi | Convenzioni di denominazione per i parametri | Istruzioni per l'uso dei membri di classe