ProcessStartInfo Clase

Definición

Especifica un conjunto de valores que se usa cuando se inicia un proceso.Specifies a set of values that are used when you start a process.

public ref class ProcessStartInfo sealed
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class ProcessStartInfo
type ProcessStartInfo = class
Public NotInheritable Class ProcessStartInfo
Herencia
ProcessStartInfo
Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la clase ProcessStartInfo para iniciar Internet Explorer, lo que proporciona las direcciones URL de destino como ProcessStartInfo argumentos.The following code example demonstrates how to use the ProcessStartInfo class to start Internet Explorer, providing the destination URLs as ProcessStartInfo arguments.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

// Opens the Internet Explorer application.
void OpenApplication(String^ myFavoritesPath)
{
    // Start Internet Explorer. Defaults to the home page.
    Process::Start("IExplore.exe");

    // Display the contents of the favorites folder in the browser.
    Process::Start(myFavoritesPath);
}

// Opens urls and .html documents using Internet Explorer.
void OpenWithArguments()
{
    // URLs are not considered documents. They can only be opened
    // by passing them as arguments.
    Process::Start("IExplore.exe", "www.northwindtraders.com");

    // Start a Web page using a browser associated with .html and .asp files.
    Process::Start("IExplore.exe", "C:\\myPath\\myFile.htm");
    Process::Start("IExplore.exe", "C:\\myPath\\myFile.asp");
}

// Uses the ProcessStartInfo class to start new processes,
// both in a minimized mode.
void OpenWithStartInfo()
{
    ProcessStartInfo^ startInfo = gcnew ProcessStartInfo("IExplore.exe");
    startInfo->WindowStyle = ProcessWindowStyle::Minimized;
    Process::Start(startInfo);
    startInfo->Arguments = "www.northwindtraders.com";
    Process::Start(startInfo);
}

int main()
{
    // Get the path that stores favorite links.
    String^ myFavoritesPath = Environment::GetFolderPath(Environment::SpecialFolder::Favorites);
    OpenApplication(myFavoritesPath);
    OpenWithArguments();
    OpenWithStartInfo();
}
using System;
using System.Diagnostics;
using System.ComponentModel;

namespace MyProcessSample
{
    class MyProcess
    {
        // Opens the Internet Explorer application.
        void OpenApplication(string myFavoritesPath)
        {
            // Start Internet Explorer. Defaults to the home page.
            Process.Start("IExplore.exe");

            // Display the contents of the favorites folder in the browser.
            Process.Start(myFavoritesPath);
        }

        // Opens urls and .html documents using Internet Explorer.
        void OpenWithArguments()
        {
            // url's are not considered documents. They can only be opened
            // by passing them as arguments.
            Process.Start("IExplore.exe", "www.northwindtraders.com");

            // Start a Web page using a browser associated with .html and .asp files.
            Process.Start("IExplore.exe", "C:\\myPath\\myFile.htm");
            Process.Start("IExplore.exe", "C:\\myPath\\myFile.asp");
        }

        // Uses the ProcessStartInfo class to start new processes,
        // both in a minimized mode.
        void OpenWithStartInfo()
        {
            ProcessStartInfo startInfo = new ProcessStartInfo("IExplore.exe");
            startInfo.WindowStyle = ProcessWindowStyle.Minimized;

            Process.Start(startInfo);

            startInfo.Arguments = "www.northwindtraders.com";

            Process.Start(startInfo);
        }

        static void Main()
        {
            // Get the path that stores favorite links.
            string myFavoritesPath =
                Environment.GetFolderPath(Environment.SpecialFolder.Favorites);

            MyProcess myProcess = new MyProcess();

            myProcess.OpenApplication(myFavoritesPath);
            myProcess.OpenWithArguments();
            myProcess.OpenWithStartInfo();
        }
    }
}
Imports System.Diagnostics
Imports System.ComponentModel

Namespace MyProcessSample
    Class MyProcess
        ' Opens the Internet Explorer application.
        Public Sub OpenApplication(myFavoritesPath As String)
            ' Start Internet Explorer. Defaults to the home page.
            Process.Start("IExplore.exe")

            ' Display the contents of the favorites folder in the browser.
            Process.Start(myFavoritesPath)
        End Sub

        ' Opens URLs and .html documents using Internet Explorer.
        Sub OpenWithArguments()
            ' URLs are not considered documents. They can only be opened
            ' by passing them as arguments.
            Process.Start("IExplore.exe", "www.northwindtraders.com")

            ' Start a Web page using a browser associated with .html and .asp files.
            Process.Start("IExplore.exe", "C:\myPath\myFile.htm")
            Process.Start("IExplore.exe", "C:\myPath\myFile.asp")
        End Sub

        ' Uses the ProcessStartInfo class to start new processes,
        ' both in a minimized mode.
        Sub OpenWithStartInfo()
            Dim startInfo As New ProcessStartInfo("IExplore.exe")
            startInfo.WindowStyle = ProcessWindowStyle.Minimized

            Process.Start(startInfo)

            startInfo.Arguments = "www.northwindtraders.com"

            Process.Start(startInfo)
        End Sub

        Shared Sub Main()
            ' Get the path that stores favorite links.
            Dim myFavoritesPath As String = Environment.GetFolderPath(Environment.SpecialFolder.Favorites)

            Dim myProcess As New MyProcess()

            myProcess.OpenApplication(myFavoritesPath)
            myProcess.OpenWithArguments()
            myProcess.OpenWithStartInfo()
        End Sub
    End Class
End Namespace 'MyProcessSample

Comentarios

ProcessStartInfo se utiliza junto con el componente Process.ProcessStartInfo is used together with the Process component. Al iniciar un proceso con la clase Process, tiene acceso a la información del proceso, además de a la que está disponible al asociarse a un proceso en ejecución.When you start a process using the Process class, you have access to process information in addition to that available when attaching to a running process.

Puede usar la clase ProcessStartInfo para un mejor control sobre el proceso que se inicia.You can use the ProcessStartInfo class for better control over the process you start. Debe establecer al menos la propiedad FileName, ya sea manualmente o mediante el constructor.You must at least set the FileName property, either manually or using the constructor. El nombre de archivo es cualquier aplicación o documento.The file name is any application or document. Aquí se define un documento para que sea cualquier tipo de archivo que tenga asociada una acción abierta o predeterminada.Here a document is defined to be any file type that has an open or default action associated with it. Puede ver los tipos de archivo registrados y sus aplicaciones asociadas para el equipo mediante el cuadro de diálogo Opciones de carpeta , que está disponible a través del sistema operativo.You can view registered file types and their associated applications for your computer by using the Folder Options dialog box, which is available through the operating system. El botón Opciones avanzadas conduce a un cuadro de diálogo que muestra si hay una acción de apertura asociada a un tipo de archivo registrado específico.The Advanced button leads to a dialog box that shows whether there is an open action associated with a specific registered file type.

Además, puede establecer otras propiedades que definen las acciones que deben realizarse con ese archivo.In addition, you can set other properties that define actions to take with that file. Puede especificar un valor específico para el tipo de la propiedad FileName de la propiedad Verb.You can specify a value specific to the type of the FileName property for the Verb property. Por ejemplo, puede especificar "Imprimir" para un tipo de documento.For example, you can specify "print" for a document type. Además, puede especificar Arguments valores de propiedad como argumentos de línea de comandos para pasar al procedimiento abierto del archivo.Additionally, you can specify Arguments property values to be command-line arguments to pass to the file's open procedure. Por ejemplo, si especifica una aplicación de editor de texto en la propiedad FileName, puede usar la propiedad Arguments para especificar un archivo de texto que el editor va a abrir.For example, if you specify a text editor application in the FileName property, you can use the Arguments property to specify a text file to be opened by the editor.

Normalmente, la entrada estándar es el teclado, y la salida estándar y el error estándar suelen ser la pantalla de supervisión.Standard input is usually the keyboard, and standard output and standard error are usually the monitor screen. Sin embargo, puede usar las propiedades RedirectStandardInput, RedirectStandardOutputy RedirectStandardError para que el proceso obtenga la entrada de o devuelva la salida a un archivo o a otro dispositivo.However, you can use the RedirectStandardInput, RedirectStandardOutput, and RedirectStandardError properties to cause the process to get input from or return output to a file or other device. Si usa las propiedades StandardInput, StandardOutputo StandardError en el componente Process, primero debe establecer el valor correspondiente en la propiedad ProcessStartInfo.If you use the StandardInput, StandardOutput, or StandardError properties on the Process component, you must first set the corresponding value on the ProcessStartInfo property. De lo contrario, el sistema produce una excepción al leer o escribir en la secuencia.Otherwise, the system throws an exception when you read or write to the stream.

Establezca la propiedad UseShellExecute para especificar si se debe iniciar el proceso mediante el Shell del sistema operativo.Set the UseShellExecute property to specify whether to start the process by using the operating system shell. Si UseShellExecute se establece en false, el nuevo proceso hereda la entrada estándar, la salida estándar y los flujos de error estándar del proceso de llamada, a menos que las propiedades RedirectStandardInput, RedirectStandardOutputo RedirectStandardError, respectivamente, se establezcan en true.If UseShellExecute is set to false, the new process inherits the standard input, standard output, and standard error streams of the calling process, unless the RedirectStandardInput, RedirectStandardOutput, or RedirectStandardError properties, respectively, are set to true.

Puede cambiar el valor de cualquier propiedad de ProcessStartInfo hasta el momento en que se inicia el proceso.You can change the value of any ProcessStartInfo property up to the time that the process starts. Una vez iniciado el proceso, el cambio de estos valores no tiene ningún efecto.After you start the process, changing these values has no effect.

Nota

Esta clase contiene una petición de vínculo en el nivel de clase que se aplica a todos los miembros.This class contains a link demand at the class level that applies to all members. Se produce una SecurityException cuando el llamador inmediato no tiene permiso de plena confianza.A SecurityException is thrown when the immediate caller does not have full-trust permission. Para más información sobre las demandas de seguridad, consulte peticiones de vínculo.For details about security demands, see Link Demands.

Constructores

ProcessStartInfo()

Inicializa una nueva instancia de la clase ProcessStartInfo sin especificar un nombre de archivo con el que iniciar el proceso.Initializes a new instance of the ProcessStartInfo class without specifying a file name with which to start the process.

ProcessStartInfo(String)

Inicializa una nueva instancia de la clase ProcessStartInfo y especifica un nombre de archivo, como una aplicación o un documento, con el que se inicia el proceso.Initializes a new instance of the ProcessStartInfo class and specifies a file name such as an application or document with which to start the process.

ProcessStartInfo(String, String)

Inicializa una nueva instancia de la clase ProcessStartInfo y especifica un nombre de archivo de aplicación con el que se iniciará el proceso, así como un conjunto de argumentos de línea de comandos que se pasarán a la aplicación.Initializes a new instance of the ProcessStartInfo class, specifies an application file name with which to start the process, and specifies a set of command-line arguments to pass to the application.

Propiedades

ArgumentList

Obtiene una colección de argumentos de línea de comandos que se van a usar al iniciar la aplicación.Gets a collection of command-line arguments to use when starting the application.

Arguments

Obtiene o establece el conjunto de argumentos de línea de comandos que se van a usar al iniciar la aplicación.Gets or sets the set of command-line arguments to use when starting the application.

CreateNoWindow

Obtiene o establece un valor que indica si el proceso se va a iniciar en una nueva ventana.Gets or sets a value indicating whether to start the process in a new window.

Domain

Obtiene o establece un valor que identifica el dominio que se va a usar al iniciarse el proceso.Gets or sets a value that identifies the domain to use when starting the process. Si este valor es null, la propiedad UserName debe especificarse en formato UPN.If this value is null, the UserName property must be specified in UPN format.

Environment

Obtiene las variables de entorno que se aplican a este proceso y a sus procesos secundarios.Gets the environment variables that apply to this process and its child processes.

EnvironmentVariables

Obtiene rutas de acceso para búsqueda de archivos, directorios para archivos temporales, opciones específicas de la aplicación y otra información similar.Gets search paths for files, directories for temporary files, application-specific options, and other similar information.

ErrorDialog

Obtiene o establece un valor que indica si se va a mostrar un cuadro de diálogo de error al usuario si el proceso no se puede iniciar.Gets or sets a value indicating whether an error dialog box is displayed to the user if the process cannot be started.

ErrorDialogParentHandle

Obtiene o establece el identificador de ventana que se usará cuando se muestre un cuadro de diálogo para un proceso que no se puede iniciar.Gets or sets the window handle to use when an error dialog box is shown for a process that cannot be started.

FileName

Obtiene o establece la aplicación o el documento que se va a iniciar.Gets or sets the application or document to start.

LoadUserProfile

Obtiene o establece un valor que indica si el perfil de usuario de Windows se va a cargar desde el registro.Gets or sets a value that indicates whether the Windows user profile is to be loaded from the registry.

Password

Obtiene o establece una cadena segura que contiene la contraseña del usuario que se va a usar al iniciar el proceso.Gets or sets a secure string that contains the user password to use when starting the process.

PasswordInClearText

Obtiene o establece la contraseña de usuario no cifrada que se va a usar al iniciar el proceso.Gets or sets the user password in clear text to use when starting the process.

RedirectStandardError

Obtiene o establece un valor que indica si la salida de errores de una aplicación se escribe en la secuencia de StandardError.Gets or sets a value that indicates whether the error output of an application is written to the StandardError stream.

RedirectStandardInput

Obtiene o establece un valor que indica si la entrada para una aplicación se lee de la secuencia de StandardInput.Gets or sets a value indicating whether the input for an application is read from the StandardInput stream.

RedirectStandardOutput

Obtiene o establece un valor que indica si la salida de una aplicación se escribe en la secuencia de StandardOutput.Gets or sets a value that indicates whether the textual output of an application is written to the StandardOutput stream.

StandardErrorEncoding

Obtiene o establece la codificación preferente para la salida de errores.Gets or sets the preferred encoding for error output.

StandardInputEncoding

Obtiene o establece la codificación preferente para la entrada estándar.Gets or sets the preferred encoding for standard input.

StandardOutputEncoding

Obtiene o establece la codificación preferente para la salida estándar.Gets or sets the preferred encoding for standard output.

UserName

Obtiene o establece el nombre de usuario que se va a usar al iniciar el proceso.Gets or sets the user name to use when starting the process. Si usa el formato UPN, user@DNS_domain_name, la propiedad Domain debe ser null.If you use the UPN format, user@DNS_domain_name, the Domain property must be null.

UseShellExecute

Obtiene o establece un valor que indica si se va a usar el shell del sistema operativo para iniciar el proceso.Gets or sets a value indicating whether to use the operating system shell to start the process.

Verb

Obtiene o establece el verbo que se usará al abrir la aplicación o el documento que especifique la propiedad FileName.Gets or sets the verb to use when opening the application or document specified by the FileName property.

Verbs

Obtiene el conjunto de verbos asociado al tipo de archivo especificado en la propiedad FileName.Gets the set of verbs associated with the type of file specified by the FileName property.

WindowStyle

Obtiene o establece el estado de ventana que se usará cuando se inicie el proceso.Gets or sets the window state to use when the process is started.

WorkingDirectory

Cuando la propiedad de UseShellExecute es false, obtiene o establece el directorio de trabajo para que el proceso se inicie.When the UseShellExecute property is false, gets or sets the working directory for the process to be started. Cuando UseShellExecute es true, obtiene o establece el directorio que contiene el proceso que se iniciará.When UseShellExecute is true, gets or sets the directory that contains the process to be started.

Métodos

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Seguridad

SecurityPermission
para llamar a los miembros de ProcessStartInfo.for calling members of ProcessStartInfo. Valor de petición: LinkDemand; Conjuntos de permisos con nombre: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Se aplica a

Consulte también: