ProcessStartInfo Classe

Définition

Espace de noms:

System.Diagnostics

Assemblys:

netstandard.dll, System.Diagnostics.Process.dll

Source:

ProcessStartInfo.cs

Spécifie un ensemble de valeurs utilisées lors du démarrage d’un processus.

public ref class ProcessStartInfo sealed

public sealed class ProcessStartInfo

type ProcessStartInfo = class

Public NotInheritable Class ProcessStartInfo

Héritage

Object

ProcessStartInfo

Exemples

L’exemple de code suivant montre comment utiliser la ProcessStartInfo classe pour démarrer Internet Explorer. Les URL de destination sont fournies en tant qu’arguments ProcessStartInfo .

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

Remarques

ProcessStartInfo est utilisé avec le Process composant. Lorsque vous démarrez un processus à l’aide de la Process classe, vous avez accès aux informations de traitement en plus de cela disponibles lors de l’attachement à un processus en cours d’exécution.

Vous pouvez utiliser la ProcessStartInfo classe pour mieux contrôler le processus que vous démarrez. Vous devez au moins définir la FileName propriété, manuellement ou à l’aide du constructeur. Le nom de fichier est n’importe quelle application ou document. Ici, un document est défini comme n’importe quel type de fichier qui a une action ouverte ou par défaut associée. Vous pouvez afficher les types de fichiers inscrits et leurs applications associées pour votre ordinateur à l’aide de la boîte de dialogue Options du dossier , disponible via le système d’exploitation. Le bouton Avancé mène à une boîte de dialogue qui indique s’il existe une action ouverte associée à un type de fichier inscrit spécifique.

En outre, vous pouvez définir d’autres propriétés qui définissent des actions à entreprendre avec ce fichier. Vous pouvez spécifier une valeur spécifique au type de la FileName propriété pour la Verb propriété. Par exemple, vous pouvez spécifier « imprimer » pour un type de document. En outre, vous pouvez spécifier des Arguments valeurs de propriété pour qu’elles soient des arguments de ligne de commande à passer à la procédure ouverte du fichier. Par exemple, si vous spécifiez une application d’éditeur de texte dans la FileName propriété, vous pouvez utiliser la Arguments propriété pour spécifier un fichier texte à ouvrir par l’éditeur.

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. Toutefois, vous pouvez utiliser les propriétés et RedirectStandardOutputRedirectStandardError les RedirectStandardInputpropriétés pour faire en sorte que le processus obtienne une entrée à partir ou retourne une sortie vers un fichier ou un autre appareil. Si vous utilisez les propriétés ou StandardOutputStandardError les StandardInputpropriétés du Process composant, vous devez d’abord définir la valeur correspondante sur la ProcessStartInfo propriété. Sinon, le système lève une exception lorsque vous lisez ou écrivez dans le flux.

Définissez la UseShellExecute propriété pour spécifier s’il faut démarrer le processus à l’aide de l’interpréteur de commandes du système d’exploitation. Si UseShellExecute la valeur est définie false, le nouveau processus hérite des flux d’entrée standard, de sortie standard et d’erreur standard du processus appelant, sauf si les RedirectStandardInputpropriétés, RedirectStandardOutputrespectivement RedirectStandardError , sont définies truesur .

Vous pouvez modifier la valeur de n’importe quelle ProcessStartInfo propriété jusqu’au moment où le processus démarre. Une fois le processus démarré, la modification de ces valeurs n’a aucun effet.

Important

L’utilisation d’une instance de ce type avec des données non approuvées est un risque de sécurité. Utilisez cet objet uniquement avec des données approuvées. Pour plus d’informations, consultez Valider toutes les entrées.

Note

Cette classe contient une demande de liaison au niveau de la classe qui s’applique à tous les membres. A SecurityException est levée lorsque l’appelant immédiat n’a pas d’autorisation de confiance totale. Pour plus d’informations sur les demandes de sécurité, consultez Demandes de liaison.

Constructeurs

Nom	Description
ProcessStartInfo()	Initialise une nouvelle instance de la ProcessStartInfo classe sans spécifier de nom de fichier avec lequel démarrer le processus.
ProcessStartInfo(String, IEnumerable<String>)	Initialise une nouvelle instance de la ProcessStartInfo classe et spécifie le nom de l’application à démarrer et un ensemble d’arguments de ligne de commande à passer à l’application.
ProcessStartInfo(String, String)	Initialise une nouvelle instance de la ProcessStartInfo classe, spécifie un nom de fichier d’application avec lequel démarrer le processus et spécifie un ensemble d’arguments de ligne de commande à passer à l’application.
ProcessStartInfo(String)	Initialise une nouvelle instance de la ProcessStartInfo classe et spécifie un nom de fichier tel qu’une application ou un document avec lequel démarrer le processus.

Propriétés

Nom	Description
ArgumentList	Obtient une collection d’arguments de ligne de commande à utiliser lors du démarrage de l’application. Les chaînes ajoutées à la liste n’ont pas besoin d’être précédemment échappées.
Arguments	Obtient ou définit l’ensemble d’arguments de ligne de commande à utiliser lors du démarrage de l’application.
CreateNewProcessGroup	Obtient ou définit une valeur indiquant s’il faut démarrer le processus dans un nouveau groupe de processus.
CreateNoWindow	Obtient ou définit une valeur indiquant s’il faut démarrer le processus dans une nouvelle fenêtre.
Domain	Obtient ou définit une valeur qui identifie le domaine à utiliser lors du démarrage du processus. Si cette valeur est null, la UserName propriété doit être spécifiée au format UPN.
Environment	Obtient les variables d’environnement qui s’appliquent à ce processus et à ses processus enfants.
EnvironmentVariables	Obtient les chemins de recherche des fichiers, des répertoires pour les fichiers temporaires, des options spécifiques à l’application et d’autres informations similaires.
ErrorDialog	Obtient ou définit une valeur indiquant si une boîte de dialogue d’erreur s’affiche à l’utilisateur si le processus ne peut pas être démarré.
ErrorDialogParentHandle	Obtient ou définit le handle de fenêtre à utiliser lorsqu’une boîte de dialogue d’erreur est affichée pour un processus qui ne peut pas être démarré.
FileName	Obtient ou définit l’application ou le document à démarrer.
LoadUserProfile	Obtient ou définit une valeur qui indique si le profil utilisateur Windows doit être chargé à partir du Registre.
Password	Obtient ou définit une chaîne sécurisée qui contient le mot de passe utilisateur à utiliser lors du démarrage du processus.
PasswordInClearText	Obtient ou définit le mot de passe utilisateur en texte clair à utiliser lors du démarrage du processus.
RedirectStandardError	Obtient ou définit une valeur qui indique si la sortie d’erreur d’une application est écrite dans le StandardError flux.
RedirectStandardInput	Obtient ou définit une valeur indiquant si l’entrée d’une application est lue à partir du StandardInput flux.
RedirectStandardOutput	Obtient ou définit une valeur qui indique si la sortie textuelle d’une application est écrite dans le StandardOutput flux.
StandardErrorEncoding	Obtient ou définit l’encodage préféré pour la sortie d’erreur.
StandardInputEncoding	Obtient ou définit l’encodage préféré pour l’entrée standard.
StandardOutputEncoding	Obtient ou définit l’encodage préféré pour la sortie standard.
UseCredentialsForNetworkingOnly	Obtient ou définit une valeur qui indique si les informations d’identification de l’utilisateur sont utilisées uniquement pour les ressources réseau.
UserName	Obtient ou définit le nom d’utilisateur à utiliser lors du démarrage du processus. Si vous utilisez le format UPN, user@DNS_domain_namela Domain propriété doit être null.
UseShellExecute	Obtient ou définit une valeur indiquant s’il faut utiliser l’interpréteur de commandes du système d’exploitation pour démarrer le processus.
Verb	Obtient ou définit le verbe à utiliser lors de l’ouverture de l’application ou du document spécifié par la FileName propriété.
Verbs	Obtient l’ensemble de verbes associés au type de fichier spécifié par la FileName propriété.
WindowStyle	Obtient ou définit l’état de la fenêtre à utiliser lorsque le processus est démarré.
WorkingDirectory	Lorsque la UseShellExecute propriété est false, obtient ou définit le répertoire de travail pour que le processus soit démarré. Quand UseShellExecute est true, obtient ou définit le répertoire qui contient le processus à démarrer.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• Process