ProcessStartInfo Classe

Définition

Spécifie un jeu de valeurs utilisées 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
ProcessStartInfo
Attributs

Exemples

L’exemple de code suivant montre comment utiliser la classe ProcessStartInfo pour démarrer Internet Explorer, en fournissant les URL de destination en tant qu' ProcessStartInfo 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();
}
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

Remarques

ProcessStartInfo est utilisé conjointement avec le composant Process.ProcessStartInfo is used together with the Process component. Quand vous démarrez un processus à l’aide de la classe Process, vous avez accès aux informations sur les processus 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 classe ProcessStartInfo 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 propriété FileName, 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 propriété FileName pour la propriété Verb.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 valeurs de propriété 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 texte dans la propriété FileName, vous pouvez utiliser la propriété Arguments 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 propriétés RedirectStandardInput, RedirectStandardOutputet RedirectStandardError pour obliger le processus à obtenir une entrée ou à retourner la sortie vers 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 propriétés StandardInput, StandardOutputou StandardError sur le composant Process, vous devez d’abord définir la valeur correspondante sur la propriété 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. 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 propriété UseShellExecute 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 valeur false, le nouveau processus hérite de l’entrée standard, de la sortie standard et des flux d’erreurs standard du processus appelant, sauf si les propriétés RedirectStandardInput, RedirectStandardOutputou RedirectStandardError, 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’importe quelle ProcessStartInfo 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 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()

Initialise une nouvelle instance de la classe ProcessStartInfo sans spécifier le nom de fichier avec lequel 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)

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)

Initialise une nouvelle instance de la classe ProcessStartInfo et spécifie un nom de fichier d’application avec lequel démarrer le processus, ainsi qu’un jeu d’arguments de 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

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

Obtient ou définit le jeu d’arguments de 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

StandardInputEncoding

Obtient ou définit l'encodage recommandé pour l’entrée standard.Gets or sets the preferred encoding for standard input.

StandardOutputEncoding

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

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

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

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

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

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

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)

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

(Hérité de Object)
GetHashCode()

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

(Hérité de Object)
GetType()

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

(Hérité de Object)
MemberwiseClone()

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

(Hérité de Object)
ToString()

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

(Hérité de Object)

Sécurité

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

S’applique à

Voir aussi