Procedura: impostare il valore visualizzato da un controllo ProgressBar Windows Form

Importante
Benché il controllo ToolStripProgressBar sostituisca il controllo ProgressBar aggiungendovi funzionalità, il controllo ProgressBar viene mantenuto per compatibilità con le versioni precedenti e per un eventuale utilizzo futuro.

In .NET Framework sono disponibili vari modi per visualizzare un determinato valore all'interno del controllo ProgressBar. La scelta dell'approccio da utilizzare dipende dall'attività da eseguire o dal problema che si intende risolvere. Nella tabella che segue sono elencati gli approcci utilizzabili.

Il modo più diretto per impostare il valore visualizzato da un indicatore di stato consiste nell'impostare la proprietà Value. Questa operazione può essere eseguita in fase di progettazione o in fase di esecuzione.

Per impostare direttamente il valore di ProgressBar

1. Impostare i valori Minimum e Maximum del controllo ProgressBar.

2. Nel codice impostare la proprietà Value del controllo su un valore integer compreso tra i valori minimo e massimo stabiliti.

   Nota

   Se si imposta la proprietà Value su un valore non incluso nell'intervallo compreso tra i valori stabiliti per le proprietà Minimum e Maximum, verrà generata un'eccezione ArgumentException.

   Nell'esempio di codice seguente viene illustrata l'impostazione diretta del valore ProgressBar. Nel codice vengono letti i record da un'origine dati, l'indicatore di stato viene aggiornato e viene applicata un'etichetta per ogni lettura di record di dati. Per l'esempio è necessario che sul form siano presenti un controllo Label, un controllo ProgressBar e una tabella di dati con una riga denominata CustomerRow con campi FirstName e Last Name .

   Public Sub CreateNewRecords()
      ' Sets the progress bar's Maximum property to
      ' the total number of records to be created.
      ProgressBar1.Maximum = 20
   
      ' Creates a new record in the dataset.
      ' NOTE: The code below will not compile, it merely
      ' illustrates how the progress bar would be used.
      Dim anyRow As CustomerRow = DatasetName.ExistingTable.NewRow
      anyRow.FirstName = "Stephen"
      anyRow.LastName = "James"
      ExistingTable.Rows.Add(anyRow)
   
      ' Increases the value displayed by the progress bar.
      ProgressBar1.Value += 1
      ' Updates the label to show that a record was read.
      Label1.Text = "Records Read = " & ProgressBar1.Value.ToString()
   End Sub
   

   public void createNewRecords()
   {
      // Sets the progress bar's Maximum property to
      // the total number of records to be created.
      progressBar1.Maximum = 20;
   
      // Creates a new record in the dataset.
      // NOTE: The code below will not compile, it merely
      // illustrates how the progress bar would be used.
      CustomerRow anyRow = DatasetName.ExistingTable.NewRow();
      anyRow.FirstName = "Stephen";
      anyRow.LastName = "James";
      ExistingTable.Rows.Add(anyRow);
   
      // Increases the value displayed by the progress bar.
      progressBar1.Value += 1;
      // Updates the label to show that a record was read.
      label1.Text = "Records Read = " + progressBar1.Value.ToString();
   }
   

   Per visualizzare uno stato che progredisce in base a un intervallo fisso, è possibile impostare il valore e chiamare un metodo che aumenta il valore del controllo ProgressBar in base a tale intervallo. Questa soluzione è utile per i timer e per altri scenari in cui il progresso non viene misurato come percentuale del totale.

Per aumentare il valore dell'indicatore di stato in base a un valore fisso

1. Impostare i valori Minimum e Maximum del controllo ProgressBar.

2. Impostare la proprietà Step del controllo su un intero che rappresenta la quantità in base alla quale aumentare il valore visualizzato dell'indicatore di stato.

3. Chiamare il metodo PerformStep per modificare il valore visualizzato in base alla quantità impostata nella proprietà Step.

   Nell'esempio di codice seguente viene illustrato in che modo mantenere il conteggio dei file in un'operazione di copia mediante un indicatore di stato.

   Nell'esempio, man mano che ogni file viene letto in memoria, l'indicatore di stato e l'etichetta vengono aggiornati per riflettere il numero totale di file letti. Per l'esempio è necessario che sul form siano presenti un controllo Label e un controllo ProgressBar.

   Public Sub LoadFiles()
      ' Sets the progress bar's minimum value to a number representing
      ' no operations complete -- in this case, no files read.
      ProgressBar1.Minimum = 0
      ' Sets the progress bar's maximum value to a number representing
      ' all operations complete -- in this case, all five files read.
      ProgressBar1.Maximum = 5
      ' Sets the Step property to amount to increase with each iteration.
      ' In this case, it will increase by one with every file read.
      ProgressBar1.Step = 1
   
      ' Dimensions a counter variable.
      Dim i As Integer
      ' Uses a For...Next loop to iterate through the operations to be
      ' completed. In this case, five files are to be copied into memory,
      ' so the loop will execute 5 times.
      For i = 0 To 4
         ' Insert code to copy a file
         ProgressBar1.PerformStep()
         ' Update the label to show that a file was read.
         Label1.Text = "# of Files Read = " & ProgressBar1.Value.ToString
      Next i
   End Sub
   

   public void loadFiles()
   {
      // Sets the progress bar's minimum value to a number representing
      // no operations complete -- in this case, no files read.
      progressBar1.Minimum = 0;
      // Sets the progress bar's maximum value to a number representing
      // all operations complete -- in this case, all five files read.
      progressBar1.Maximum = 5;
      // Sets the Step property to amount to increase with each iteration.
      // In this case, it will increase by one with every file read.
      progressBar1.Step = 1;
   
      // Uses a for loop to iterate through the operations to be
      // completed. In this case, five files are to be copied into memory,
      // so the loop will execute 5 times.
      for (int i = 0; i <= 4; i++)
      {
         // Inserts code to copy a file
         progressBar1.PerformStep();
         // Updates the label to show that a file was read.
         label1.Text = "# of Files Read = " + progressBar1.Value.ToString();
      }
   }
   

   È infine possibile aumentare il valore visualizzato da un indicatore di stato in modo che ogni aumento corrisponda a una quantità univoca. Questo approccio è utile per tenere traccia di una serie di operazioni univoche, come la scrittura di file di dimensioni diverse su un disco rigido, o per misurare il progresso come percentuale del totale.

Per aumentare il valore dell'indicatore di stato in base a un valore dinamico

1. Impostare i valori Minimum e Maximum del controllo ProgressBar.

2. Chiamare il metodo Increment per modificare il valore visualizzato in base a un intero specificato.

   Nell'esempio di codice seguente viene illustrato come calcolare lo spazio su disco utilizzato durante un'operazione di copia mediante un indicatore di stato.

   Nell'esempio, man mano che ogni file viene scritto sul disco rigido, l'indicatore di stato e l'etichetta vengono aggiornati per riflettere la quantità di spazio su disco disponibile. Per l'esempio è necessario che sul form siano presenti un controllo Label e un controllo ProgressBar.

   Public Sub ReadFiles()
      ' Sets the progress bar's minimum value to a number 
      ' representing the hard disk space before the files are read in.
      ' You will most likely have to set this using a system call.
      ' NOTE: The code below is meant to be an example and
      ' will not compile.
      ProgressBar1.Minimum = AvailableDiskSpace()
      ' Sets the progress bar's maximum value to a number 
      ' representing the total hard disk space.
      ' You will most likely have to set this using a system call.
      ' NOTE: The code below is meant to be an example 
      ' and will not compile.
      ProgressBar1.Maximum = TotalDiskSpace()
   
      ' Dimension a counter variable.
      Dim i As Integer
      ' Uses a For...Next loop to iterate through the operations to be
      ' completed. In this case, five files are to be written to the disk,
      ' so it will execute the loop 5 times.
      For i = 1 To 5
         ' Insert code to read a file into memory and update file size.
         ' Increases the progress bar's value based on the size of 
         ' the file currently being written.
         ProgressBar1.Increment(FileSize)
         ' Updates the label to show available drive space.
         Label1.Text = "Current Disk Space Used = " &_ 
         ProgressBar1.Value.ToString()
      Next i
   End Sub
   

   public void readFiles()
   {
      // Sets the progress bar's minimum value to a number 
      // representing the hard disk space before the files are read in.
      // You will most likely have to set this using a system call.
      // NOTE: The code below is meant to be an example and 
      // will not compile.
      progressBar1.Minimum = AvailableDiskSpace();
      // Sets the progress bar's maximum value to a number 
      // representing the total hard disk space.
      // You will most likely have to set this using a system call.
      // NOTE: The code below is meant to be an example 
      // and will not compile.
      progressBar1.Maximum = TotalDiskSpace();
   
      // Uses a for loop to iterate through the operations to be
      // completed. In this case, five files are to be written
      // to the disk, so it will execute the loop 5 times.
      for (int i = 1; i<= 5; i++)
      {
         // Insert code to read a file into memory and update file size.
         // Increases the progress bar's value based on the size of 
         // the file currently being written.
         progressBar1.Increment(FileSize);
         // Updates the label to show available drive space.
         label1.Text = "Current Disk Space Used = " + progressBar1.Value.ToString();
      }
   }
   

Vedere anche

Riferimenti

Cenni preliminari sul controllo ProgressBar (Windows Form)

ProgressBar

ToolStripProgressBar

Altre risorse

Controllo ProgressBar (Windows Form)