ProgressBar.PerformStep Método

Definición

Avanza la posición actual de la barra de progreso en la cantidad especificada por la propiedad Step.Advances the current position of the progress bar by the amount of the Step property.

public:
 void PerformStep();
public void PerformStep ();
member this.PerformStep : unit -> unit
Public Sub PerformStep ()

Excepciones

El valor de Style está establecido en Marquee.Style is set to Marquee.

Ejemplos

En el ejemplo de código siguiente ProgressBar se usa un control para mostrar el progreso de una operación de copia de archivos.The following code example uses a ProgressBar control to display the progress of a file copy operation. En el ejemplo se usan las Minimum Maximum propiedades y para especificar un intervalo para ProgressBar que sea equivalente al número de archivos que se van a copiar.The example uses the Minimum and Maximum properties to specify a range for the ProgressBar that is equivalent to the number of files to copy. El código también utiliza la Step propiedad con el PerformStep método para incrementar el valor de ProgressBar cuando se copia un archivo.The code also uses the Step property with the PerformStep method to increment the value of the ProgressBar as a file is copied. Este ejemplo requiere que se haya ProgressBar creado un control llamado pBar1 que se crea en Form y que se ha creado un método denominado CopyFile (que devuelve un valor booleano que indica que la operación de copia de archivos se completó correctamente) que realiza la operación de copia de archivos.This example requires that you have a ProgressBar control created called pBar1 that is created within a Form, and that there is a method created called CopyFile (that returns a Boolean value indicating the file copy operation was completed successfully) that performs the file copy operation. El código también requiere que se cree una matriz de cadenas que contenga los archivos que se van a copiar y que se pase al CopyWithProgress método definido en el ejemplo, y que se llame al método desde otro método o evento de Form .The code also requires that an array of strings containing the files to copy is created and passed to the CopyWithProgress method defined in the example, and that the method is called from another method or event in the Form.

private:
   void CopyWithProgress( array<String^>^filenames )
   {
      // Display the ProgressBar control.
      pBar1->Visible = true;

      // Set Minimum to 1 to represent the first file being copied.
      pBar1->Minimum = 1;

      // Set Maximum to the total number of files to copy.
      pBar1->Maximum = filenames->Length;

      // Set the initial value of the ProgressBar.
      pBar1->Value = 1;

      // Set the Step property to a value of 1 to represent each file being copied.
      pBar1->Step = 1;

      // Loop through all files to copy.
      for ( int x = 1; x <= filenames->Length; x++ )
      {
         // Copy the file and increment the ProgressBar if successful.
         if ( CopyFile( filenames[ x - 1 ] ) == true )
         {
            // Perform the increment on the ProgressBar.
            pBar1->PerformStep();
         }
      }
   }
private void CopyWithProgress(string[] filenames)
{
    // Display the ProgressBar control.
    pBar1.Visible = true;
    // Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1;
    // Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length;
    // Set the initial value of the ProgressBar.
    pBar1.Value = 1;
    // Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1;
    
    // Loop through all files to copy.
    for (int x = 1; x <= filenames.Length; x++)
    {
        // Copy the file and increment the ProgressBar if successful.
        if(CopyFile(filenames[x-1]) == true)
        {
            // Perform the increment on the ProgressBar.
            pBar1.PerformStep();
        }
    }
}
Private Sub CopyWithProgress(ByVal ParamArray filenames As String())
    ' Display the ProgressBar control.
    pBar1.Visible = True
    ' Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1
    ' Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length
    ' Set the initial value of the ProgressBar.
    pBar1.Value = 1
    ' Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1

    ' Loop through all files to copy.
    Dim x As Integer
    for x = 1 To filenames.Length - 1
        ' Copy the file and increment the ProgressBar if successful.
        If CopyFile(filenames(x - 1)) = True Then
            ' Perform the increment on the ProgressBar.
            pBar1.PerformStep()
        End If
    Next x
End Sub

Comentarios

El PerformStep método incrementa el valor de la barra de progreso en la cantidad especificada por la Step propiedad.The PerformStep method increments the value of the progress bar by the amount specified by the Step property. Puede usar la Step propiedad para especificar la cantidad que cada tarea completada en una operación cambia el valor de la barra de progreso.You can use the Step property to specify the amount that each completed task in an operation changes the value of the progress bar. Por ejemplo, si está copiando un grupo de archivos, es posible que desee establecer el valor de la Step propiedad en 1 y el valor de la Maximum propiedad en el número total de archivos que se van a copiar.For example, if you are copying a group of files, you might want to set the value of the Step property to 1 and the value of the Maximum property to the total number of files to copy. Cuando se copia cada archivo, puede llamar al PerformStep método para incrementar la barra de progreso según el valor de la Step propiedad.When each file is copied, you can call the PerformStep method to increment the progress bar by the value of the Step property. Si desea tener un control más flexible del valor de la barra de progreso, puede usar el Increment método o establecer el valor de la Value propiedad directamente.If you want to have more flexible control of the value of the progress bar, you can use the Increment method or set the value of the Value property directly.

La Value propiedad especifica la posición actual del ProgressBar .The Value property specifies the current position of the ProgressBar. Si, después de llamar al PerformStep método, la Value propiedad es mayor que el valor de la Maximum propiedad, la Value propiedad permanece en el valor de la Maximum propiedad.If, after calling the PerformStep method, the Value property is greater than the value of the Maximum property, the Value property remains at the value of the Maximum property. Si, después de llamar al PerformStep método con un valor negativo especificado en Step , la Value propiedad es menor que el valor de la Minimum propiedad, la Value propiedad permanece en el valor de la Minimum propiedad.If, after calling the PerformStep method with a negative value specified in Step, the Value property is less than the value of the Minimum property, the Value property remains at the value of the Minimum property.

Dado ProgressBar que un objeto cuyo estilo se establece en Marquee muestra una barra de desplazamiento continuamente en lugar de su Value , PerformStep no es necesario llamar a y generará una InvalidOperationException .Because a ProgressBar object whose style is set to Marquee displays a continuously scrolling bar instead of its Value, calling PerformStep is unnecessary and will raise an InvalidOperationException.

Se aplica a

Consulte también