ProcessStartInfo Classe

Definizione

Specifica un insieme di valori usati all'avvio di un processo.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
Ereditarietà
ProcessStartInfo
Attributi

Esempi

Nell'esempio di codice seguente viene illustrato come utilizzare la classe ProcessStartInfo per avviare Internet Explorer, fornendo gli URL di destinazione come argomenti ProcessStartInfo.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()
{
    // 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 = 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()
            ' 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")
        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

Commenti

ProcessStartInfo viene utilizzato insieme al componente Process.ProcessStartInfo is used together with the Process component. Quando si avvia un processo usando la classe Process, è possibile accedere alle informazioni di elaborazione in aggiunta a quelle disponibili quando ci si connette a un processo in esecuzione.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.

È possibile usare la classe ProcessStartInfo per un migliore controllo sul processo avviato.You can use the ProcessStartInfo class for better control over the process you start. È necessario impostare almeno la proprietà FileName, manualmente o tramite il costruttore.You must at least set the FileName property, either manually or using the constructor. Il nome del file è qualsiasi applicazione o documento.The file name is any application or document. Qui viene definito un documento come qualsiasi tipo di file a cui è associata un'azione aperta o predefinita.Here a document is defined to be any file type that has an open or default action associated with it. È possibile visualizzare i tipi di file registrati e le applicazioni associate per il computer utilizzando la finestra di dialogo Opzioni cartella , disponibile tramite il 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. Il pulsante Avanzate conduce a una finestra di dialogo che indica se è presente un'azione aperta associata a un tipo di file registrato specifico.The Advanced button leads to a dialog box that shows whether there is an open action associated with a specific registered file type.

Inoltre, è possibile impostare altre proprietà che definiscono le azioni da intraprendere con tale file.In addition, you can set other properties that define actions to take with that file. È possibile specificare un valore specifico per il tipo della proprietà FileName per la proprietà Verb.You can specify a value specific to the type of the FileName property for the Verb property. Ad esempio, è possibile specificare "Print" per un tipo di documento.For example, you can specify "print" for a document type. Inoltre, è possibile specificare i valori delle proprietà Arguments come argomenti della riga di comando da passare alla procedura di apertura del file.Additionally, you can specify Arguments property values to be command-line arguments to pass to the file's open procedure. Se ad esempio si specifica un'applicazione editor di testo nella proprietà FileName, è possibile utilizzare la proprietà Arguments per specificare un file di testo che deve essere aperto dall'editor.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.

L'input standard è in genere la tastiera, mentre l'output standard e l'errore standard sono in genere la schermata di monitoraggio.Standard input is usually the keyboard, and standard output and standard error are usually the monitor screen. Tuttavia, è possibile usare le proprietà RedirectStandardInput, RedirectStandardOutput e RedirectStandardError per fare in modo che il processo ottenga l'input o restituisca l'output a un file o a un altro 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. Se si utilizzano le proprietà StandardInput, StandardOutput o StandardError sul componente Process, è innanzitutto necessario impostare il valore corrispondente nella proprietà 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. In caso contrario, il sistema genera un'eccezione durante la lettura o la scrittura nel flusso.Otherwise, the system throws an exception when you read or write to the stream.

Impostare la proprietà UseShellExecute per specificare se avviare il processo utilizzando la shell del sistema operativo.Set the UseShellExecute property to specify whether to start the process by using the operating system shell. Se UseShellExecute è impostato su false, il nuovo processo eredita l'input standard, l'output standard e i flussi di errore standard del processo chiamante, a meno che le proprietà RedirectStandardInput, RedirectStandardOutput o RedirectStandardError siano impostate rispettivamente su 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.

È possibile modificare il valore di qualsiasi proprietà ProcessStartInfo fino al momento in cui viene avviato il processo.You can change the value of any ProcessStartInfo property up to the time that the process starts. Dopo aver avviato il processo, la modifica di questi valori non ha alcun effetto.After you start the process, changing these values has no effect.

Nota

Questa classe contiene una richiesta di collegamento a livello di classe che si applica a tutti i membri.This class contains a link demand at the class level that applies to all members. Quando il chiamante immediato non dispone dell'autorizzazione di attendibilità totale, viene generata un'SecurityException.A SecurityException is thrown when the immediate caller does not have full-trust permission. Per informazioni dettagliate sulle richieste di sicurezza, vedere richieste di collegamento.For details about security demands, see Link Demands.

Costruttori

ProcessStartInfo()

Inizializza una nuova istanza della classe ProcessStartInfo senza specificare un nome file con il quale avviare il processo.Initializes a new instance of the ProcessStartInfo class without specifying a file name with which to start the process.

ProcessStartInfo(String)

Inizializza una nuova istanza della classe ProcessStartInfo e specifica un nome file, ad esempio un'applicazione o un documento, con il quale avviare il processo.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)

Inizializza una nuova istanza della classe ProcessStartInfo, specifica il nome file di un'applicazione con cui avviare il processo e determina un insieme di argomenti della riga di comando da passare all'applicazione.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.

Proprietà

ArgumentList

Ottiene una raccolta di argomenti della riga di comando da usare all'avvio dell'applicazione.Gets a collection of command-line arguments to use when starting the application.

Arguments

Ottiene o imposta l'insieme di argomenti della riga di comando da usare all'avvio dell'applicazione.Gets or sets the set of command-line arguments to use when starting the application.

CreateNoWindow

Ottiene o imposta un valore che indica se avviare il processo in una nuova finestra.Gets or sets a value indicating whether to start the process in a new window.

Domain

Ottiene o imposta un valore che identifica il dominio da usare all'avvio del processo.Gets or sets a value that identifies the domain to use when starting the process. Se questo valore è null, la proprietà UserName deve essere specificata in formato UPN.If this value is null, the UserName property must be specified in UPN format.

Environment

Ottiene le variabili di ambiente applicabili a questo processo e ai processi figlio.Gets the environment variables that apply to this process and its child processes.

EnvironmentVariables

Ottiene i percorsi di ricerca dei file, le directory dei file temporanei, le opzioni specifiche delle applicazioni e altre informazioni simili.Gets search paths for files, directories for temporary files, application-specific options, and other similar information.

ErrorDialog

Ottiene o imposta un valore che indica se viene visualizzata una finestra di dialogo di errore all'utente quando il processo non può essere avviato.Gets or sets a value indicating whether an error dialog box is displayed to the user if the process cannot be started.

ErrorDialogParentHandle

Ottiene o imposta l'handle della finestra da usare quando viene visualizzata una finestra di dialogo di errore per un processo che non può essere avviato.Gets or sets the window handle to use when an error dialog box is shown for a process that cannot be started.

FileName

Ottiene o imposta l'applicazione o il documento da avviare.Gets or sets the application or document to start.

LoadUserProfile

Ottiene o imposta un valore che indica se deve essere caricato il profilo utente di Windows dal Registro di sistema.Gets or sets a value that indicates whether the Windows user profile is to be loaded from the registry.

Password

Ottiene o imposta una stringa sicura che contiene la password utente da usare all'avvio del processo.Gets or sets a secure string that contains the user password to use when starting the process.

PasswordInClearText

Ottiene o imposta la password utente in testo non crittografato da usare all'avvio del processo.Gets or sets the user password in clear text to use when starting the process.

RedirectStandardError

Ottiene o imposta un valore che indica se l'output di errore di un'applicazione viene scritto nel flusso StandardError.Gets or sets a value that indicates whether the error output of an application is written to the StandardError stream.

RedirectStandardInput

Ottiene o imposta un valore che indica se l'input per un'applicazione viene letto dal flusso StandardInput.Gets or sets a value indicating whether the input for an application is read from the StandardInput stream.

RedirectStandardOutput

Ottiene o imposta un valore che indica se l'output testuale di un'applicazione viene scritto nel flusso StandardOutput.Gets or sets a value that indicates whether the textual output of an application is written to the StandardOutput stream.

StandardErrorEncoding

Ottiene o imposta la codifica preferita per l'output di errore.Gets or sets the preferred encoding for error output.

StandardInputEncoding

Ottiene o imposta la codifica preferita per l'input standard.Gets or sets the preferred encoding for standard input.

StandardOutputEncoding

Ottiene o imposta la codifica preferita per l'output standard.Gets or sets the preferred encoding for standard output.

UserName

Ottiene o imposta il nome utente da usare all'avvio del processo.Gets or sets the user name to use when starting the process. Se si usa il formato UPN, user@DNS_domain_name, la proprietà Domain deve essere null.If you use the UPN format, user@DNS_domain_name, the Domain property must be null.

UseShellExecute

Ottiene o imposta un valore che indica se usare la shell del sistema operativo per avviare il processo.Gets or sets a value indicating whether to use the operating system shell to start the process.

Verb

Ottiene o imposta il verbo da utilizzare nell'apertura dell'applicazione o del documento specificato dalla proprietà FileName.Gets or sets the verb to use when opening the application or document specified by the FileName property.

Verbs

Ottiene o imposta i verbi associati al tipo di file specificato dalla proprietà FileName.Gets the set of verbs associated with the type of file specified by the FileName property.

WindowStyle

Ottiene o imposta lo stato della finestra da usare una volta avviato il processo.Gets or sets the window state to use when the process is started.

WorkingDirectory

Quando la proprietà UseShellExecute è false, ottiene o imposta la directory di lavoro per il processo da avviare.When the UseShellExecute property is false, gets or sets the working directory for the process to be started. Quando la proprietà UseShellExecute è true, ottiene o imposta la directory che contiene il processo da avviare.When UseShellExecute is true, gets or sets the directory that contains the process to be started.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Sicurezza

SecurityPermission
per chiamare i membri di ProcessStartInfo.for calling members of ProcessStartInfo. Valore della richiesta: LinkDemand; Set di autorizzazioni denominati: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Si applica a

Vedi anche