Leggere in inglese

Condividi tramite


NumericUpDown.Value Proprietà

Definizione

Ottiene o imposta il valore assegnato alla casella di selezione, anche denominata controllo di scorrimento.

C#
[System.ComponentModel.Bindable(true)]
public decimal Value { get; set; }

Valore della proprietà

Valore numerico del controllo NumericUpDown.

Attributi

Eccezioni

Il valore assegnato è minore del valore della proprietà Minimum.

-oppure-

Il valore assegnato è maggiore del valore della proprietà Maximum.

Esempio

L'esempio di codice seguente crea e inizializza un NumericUpDown controllo, imposta alcune delle relative proprietà comuni e consente all'utente di modificare alcune di queste proprietà in fase di esecuzione. Questo codice presuppone che siano stati inseriti tre CheckBox controlli in un form e gestori per Click gli eventi di cui è stata creata un'istanza. Le DecimalPlacesproprietà , ThousandsSeparatore Hexadecimal vengono impostate sull'evento Click di ogni casella di controllo.

C#
public void InstantiateMyNumericUpDown()
{
   // Create and initialize a NumericUpDown control.
   numericUpDown1 = new NumericUpDown();

   // Dock the control to the top of the form.
   numericUpDown1.Dock = System.Windows.Forms.DockStyle.Top;

   // Set the Minimum, Maximum, and initial Value.
   numericUpDown1.Value = 5;
   numericUpDown1.Maximum = 2500;
   numericUpDown1.Minimum = -100;
   
   // Add the NumericUpDown to the Form.
   Controls.Add(numericUpDown1);
}

// Check box to toggle decimal places to be displayed.
private void checkBox1_Click(Object sender,
                             EventArgs e)
{
   /* If DecimalPlaces is greater than 0, set them to 0 and round the 
      current Value; otherwise, set DecimalPlaces to 2 and change the 
      Increment to 0.25. */
   if (numericUpDown1.DecimalPlaces > 0)
   {
      numericUpDown1.DecimalPlaces = 0;
      numericUpDown1.Value = Decimal.Round(numericUpDown1.Value, 0);
   }
   else
   {
      numericUpDown1.DecimalPlaces = 2;
      numericUpDown1.Increment = 0.25M;
   }
}

// Check box to toggle thousands separators to be displayed.
private void checkBox2_Click(Object sender,
                             EventArgs e)
{   
   /* If ThousandsSeparator is true, set it to false; 
      otherwise, set it to true. */
   if (numericUpDown1.ThousandsSeparator)
   {
      numericUpDown1.ThousandsSeparator = false;
   }
   else
   {
      numericUpDown1.ThousandsSeparator = true;
   }
}

// Check box to toggle hexadecimal to be displayed.
private void checkBox3_Click(Object sender, 
                             EventArgs e)
{
   /* If Hexadecimal is true, set it to false; 
      otherwise, set it to true. */    
   if (numericUpDown1.Hexadecimal)
   {
      numericUpDown1.Hexadecimal = false;
   }
   else
   {
      numericUpDown1.Hexadecimal = true;
   }
}

Commenti

Quando la Value proprietà è impostata, il nuovo valore viene convalidato in modo che sia compreso tra i Minimum valori e Maximum . In seguito, viene chiamato il UpdateEditText metodo per aggiornare la visualizzazione della casella di selezione con il nuovo valore nel formato appropriato.

Si applica a

Prodotto Versioni
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10

Vedi anche