ProcessStartInfo ProcessStartInfo ProcessStartInfo ProcessStartInfo Class

Définition

Spécifie un jeu de valeurs utilisé lors du démarrage d'un processus.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
Héritage
ProcessStartInfoProcessStartInfoProcessStartInfoProcessStartInfo
Attributs

Exemples

L’exemple de code suivant montre comment utiliser la ProcessStartInfo classe pour démarrer Internet Explorer, en fournissant les URL de ProcessStartInfo destination en tant qu’arguments.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 'MyProcess
End Namespace 'MyProcessSample

Remarques

ProcessStartInfoest utilisé conjointement avec le Process composant.ProcessStartInfo is used together with the Process component. Quand vous démarrez un processus à l' Process aide de la classe, vous avez accès aux informations de traitement en plus de celles qui sont disponibles lors de l’attachement à un processus en cours d’exécution.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.

Vous pouvez utiliser la ProcessStartInfo classe pour mieux contrôler le processus que vous démarrez.You can use the ProcessStartInfo class for better control over the process you start. Vous devez au moins définir la FileName propriété, soit manuellement, soit à l’aide du constructeur.You must at least set the FileName property, either manually or using the constructor. Le nom de fichier est une application ou un document.The file name is any application or document. Ici, un document est défini comme n’importe quel type de fichier auquel est associée une action d’ouverture ou par défaut.Here a document is defined to be any file type that has an open or default action associated with it. Vous pouvez afficher les types de fichiers enregistrés et leurs applications associées pour votre ordinateur à l’aide de la boîte de dialogue Options des dossiers , disponible via le système d’exploitation.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. Le bouton avancé ouvre une boîte de dialogue qui indique s’il existe une action ouverte associée à un type de fichier inscrit spécifique.The Advanced button leads to a dialog box that shows whether there is an open action associated with a specific registered file type.

En outre, vous pouvez définir d’autres propriétés qui définissent les actions à effectuer avec ce fichier.In addition, you can set other properties that define actions to take with that file. Vous pouvez spécifier une valeur spécifique au type de la FileName propriété pour la Verb propriété.You can specify a value specific to the type of the FileName property for the Verb property. Par exemple, vous pouvez spécifier «imprimer» pour un type de document.For example, you can specify "print" for a document type. En outre, vous pouvez spécifier Arguments des valeurs de propriété à utiliser comme arguments de ligne de commande à passer à la procédure d’ouverture du fichier.Additionally, you can specify Arguments property values to be command-line arguments to pass to the file's open procedure. Par exemple, si vous spécifiez une application d’éditeur de FileName texte dans la propriété, vous Arguments pouvez utiliser la propriété pour spécifier un fichier texte à ouvrir par l’éditeur.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’entrée standard est généralement le clavier, et la sortie standard et l’erreur standard sont généralement l’écran du moniteur.Standard input is usually the keyboard, and standard output and standard error are usually the monitor screen. Toutefois, vous pouvez utiliser les RedirectStandardInputpropriétés RedirectStandardOutput, et RedirectStandardError pour forcer le processus à obtenir une entrée ou à retourner la sortie à un fichier ou à un autre périphérique.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 vous utilisez les StandardInputpropriétés StandardOutput, ou StandardError sur le Process composant, vous devez d’abord définir la valeur correspondante sur la ProcessStartInfo propriété.If you use the StandardInput, StandardOutput, or StandardError properties on the Process component, you must first set the corresponding value on the ProcessStartInfo property. Dans le cas contraire, le système lève une exception lors de la lecture ou de l’écriture dans le flux.Otherwise, the system throws an exception when you read or write to the stream.

Définissez la UseShellExecute propriété pour spécifier si le processus doit être démarré à l’aide de l’interpréteur de commandes du système d’exploitation.Set the UseShellExecute property to specify whether to start the process by using the operating system shell. Si UseShellExecute a la falsevaleur, le nouveau processus hérite de l’entrée standard, de la sortie standard et des flux d’erreurs standard du processus appelant RedirectStandardInput, sauf si RedirectStandardError les propriétés, RedirectStandardOutput, ou, respectivement, ont la valeur 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.

Vous pouvez modifier la valeur de n' ProcessStartInfo importe quelle propriété jusqu’à l’heure de démarrage du processus.You can change the value of any ProcessStartInfo property up to the time that the process starts. Une fois que vous avez démarré le processus, la modification de ces valeurs n’a aucun effet.After you start the process, changing these values has no effect.

Notes

Cette classe contient une demande de liaison au niveau de la classe qui s’applique à tous les membres.This class contains a link demand at the class level that applies to all members. Une SecurityException exception est levée lorsque l’appelant immédiat n’a pas d’autorisation de confiance totale.A SecurityException is thrown when the immediate caller does not have full-trust permission. Pour plus d’informations sur les demandes de sécurité, consultez demandes de liaison.For details about security demands, see Link Demands.

Constructeurs

ProcessStartInfo() ProcessStartInfo() ProcessStartInfo() ProcessStartInfo()

Initialise une nouvelle instance de la classe ProcessStartInfo sans spécifier le nom de fichier à l'aide duquel démarrer le processus.Initializes a new instance of the ProcessStartInfo class without specifying a file name with which to start the process.

ProcessStartInfo(String) ProcessStartInfo(String) ProcessStartInfo(String) ProcessStartInfo(String)

Initialise une nouvelle instance de la classe ProcessStartInfo et spécifie un nom de fichier (d'une application ou d'un document par exemple) avec lequel démarrer le processus.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) ProcessStartInfo(String, String) ProcessStartInfo(String, String) ProcessStartInfo(String, String)

Initialise une nouvelle instance de la classe ProcessStartInfo et spécifie un nom de fichier d'application à l'aide duquel démarrer le processus, ainsi qu'un jeu d'arguments de la ligne de commande à passer à l'application.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.

Propriétés

ArgumentList ArgumentList ArgumentList ArgumentList

Obtient une collection d'arguments de ligne de commande à utiliser lors du démarrage de l'application.Gets a collection of command-line arguments to use when starting the application.

Arguments Arguments Arguments Arguments

Obtient ou définit le jeu d'arguments de la ligne de commande à utiliser lors du démarrage de l'application.Gets or sets the set of command-line arguments to use when starting the application.

CreateNoWindow CreateNoWindow CreateNoWindow CreateNoWindow

Obtient ou définit une valeur indiquant si le processus doit démarrer dans une nouvelle fenêtre.Gets or sets a value indicating whether to start the process in a new window.

Domain Domain Domain Domain

Obtient ou définit une valeur qui identifie le domaine à utiliser lors du démarrage du processus.Gets or sets a value that identifies the domain to use when starting the process. Si cette valeur est null, la propriété UserName doit être spécifiée au format UPN.If this value is null, the UserName property must be specified in UPN format.

Environment Environment Environment Environment

Obtient les variables d’environnement qui s’appliquent à ce processus et à ses processus enfants.Gets the environment variables that apply to this process and its child processes.

EnvironmentVariables EnvironmentVariables EnvironmentVariables EnvironmentVariables

Obtient les chemins de recherche de fichiers, les répertoires de fichiers temporaires, les options propres à l'application et d'autres informations similaires.Gets search paths for files, directories for temporary files, application-specific options, and other similar information.

ErrorDialog ErrorDialog ErrorDialog ErrorDialog

Obtient ou définit une valeur indiquant si une boîte de dialogue d'erreur est affichée pour l'utilisateur si le processus ne peut pas démarrer.Gets or sets a value indicating whether an error dialog box is displayed to the user if the process cannot be started.

ErrorDialogParentHandle ErrorDialogParentHandle ErrorDialogParentHandle ErrorDialogParentHandle

Obtient ou définit le handle de fenêtre à utiliser lorsqu'une boîte de dialogue d'erreur s'affiche pour un processus qui ne peut pas démarrer.Gets or sets the window handle to use when an error dialog box is shown for a process that cannot be started.

FileName FileName FileName FileName

Obtient ou définit l'application ou le document à démarrer.Gets or sets the application or document to start.

LoadUserProfile LoadUserProfile LoadUserProfile LoadUserProfile

Obtient ou définit une valeur qui indique si le profil utilisateur Windows doit être chargé à partir du Registre.Gets or sets a value that indicates whether the Windows user profile is to be loaded from the registry.

Password Password Password Password

Obtient ou définit une chaîne sécurisée contenant le mot de passe de l'utilisateur à utiliser lors du démarrage du processus.Gets or sets a secure string that contains the user password to use when starting the process.

PasswordInClearText PasswordInClearText PasswordInClearText PasswordInClearText

Obtient ou définit le mot de passe utilisateur en texte clair à utiliser lors du démarrage du processus.Gets or sets the user password in clear text to use when starting the process.

RedirectStandardError RedirectStandardError RedirectStandardError RedirectStandardError

Obtient ou définit une valeur qui indique si la sortie d'erreur d'une application est écrite dans le flux StandardError.Gets or sets a value that indicates whether the error output of an application is written to the StandardError stream.

RedirectStandardInput RedirectStandardInput RedirectStandardInput RedirectStandardInput

Obtient ou définit une valeur qui indique si l'entrée pour une application est lue à partir du flux StandardInput.Gets or sets a value indicating whether the input for an application is read from the StandardInput stream.

RedirectStandardOutput RedirectStandardOutput RedirectStandardOutput RedirectStandardOutput

Obtient ou définit une valeur qui indique si la sortie textuelle d’une application est écrite dans le flux StandardOutput.Gets or sets a value that indicates whether the textual output of an application is written to the StandardOutput stream.

StandardErrorEncoding StandardErrorEncoding StandardErrorEncoding StandardErrorEncoding

Obtient ou définit l'encodage recommandé pour la sortie d'erreur.Gets or sets the preferred encoding for error output.

StandardInputEncoding StandardInputEncoding StandardInputEncoding StandardInputEncoding
StandardOutputEncoding StandardOutputEncoding StandardOutputEncoding StandardOutputEncoding

Obtient ou définit l'encodage recommandé pour la sortie standard.Gets or sets the preferred encoding for standard output.

UserName UserName UserName UserName

Obtient ou définit le nom d’utilisateur à utiliser au démarrage du processus.Gets or sets the user name to use when starting the process. Si vous utilisez le format UPN, user@DNS_domain_name, la propriété Domain doit avoir pour valeur null.If you use the UPN format, user@DNS_domain_name, the Domain property must be null.

UseShellExecute UseShellExecute UseShellExecute UseShellExecute

Obtient ou définit une valeur indiquant si le shell du système d'exploitation doit être utilisé pour démarrer le processus.Gets or sets a value indicating whether to use the operating system shell to start the process.

Verb Verb Verb Verb

Obtient ou définit le verbe à utiliser lors de l'ouverture de l'application ou du document spécifié par la propriété FileName.Gets or sets the verb to use when opening the application or document specified by the FileName property.

Verbs Verbs Verbs Verbs

Obtient l'ensemble de verbes associé au type de fichier spécifié par la propriété FileName.Gets the set of verbs associated with the type of file specified by the FileName property.

WindowStyle WindowStyle WindowStyle WindowStyle

Obtient ou définit l'état de la fenêtre à utiliser lors du démarrage du processus.Gets or sets the window state to use when the process is started.

WorkingDirectory WorkingDirectory WorkingDirectory WorkingDirectory

Lorsque la propriété UseShellExecute est false, obtient ou définit le répertoire de travail du processus à démarrer.When the UseShellExecute property is false, gets or sets the working directory for the process to be started. Lorsque UseShellExecute est true, obtient ou définit le répertoire qui contient le processus à démarrer.When UseShellExecute is true, gets or sets the directory that contains the process to be started.

Méthodes

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Sécurité

SecurityPermission
pour appeler des membres ProcessStartInfode.for calling members of ProcessStartInfo. Valeur de la LinkDemanddemande:; Jeux d’autorisations nommés: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

S’applique à

Voir aussi