ProcessStartInfo.FileName Propriété

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Source:

ProcessStartInfo.cs

Obtient ou définit l'application ou le document à démarrer.

public:
 property System::String ^ FileName { System::String ^ get(); void set(System::String ^ value); };

public string FileName { get; set; }

member this.FileName : string with get, set

Public Property FileName As String

Valeur de propriété

String

Nom de l'application à démarrer, ou nom d'un document d'un type de fichier associé à une application et disposant d'une action d'ouverture par défaut. La valeur par défaut est une chaîne vide ("").

Exemples

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

int main()
{
    Process^ myProcess = gcnew Process;

    try
    {
        myProcess->StartInfo->UseShellExecute = false;
        // You can start any process, HelloWorld is a do-nothing example.
        myProcess->StartInfo->FileName = "C:\\HelloWorld.exe";
        myProcess->StartInfo->CreateNoWindow = true;
        myProcess->Start();
        // This code assumes the process you are starting will terminate itself. 
        // Given that it is started without a window so you cannot terminate it 
        // on the desktop, it must terminate itself or you can do it programmatically
        // from this application using the Kill method.
    }
    catch ( Exception^ e ) 
    {
        Console::WriteLine( e->Message );
    }
}

using System;
using System.Diagnostics;
using System.ComponentModel;

namespace MyProcessSample
{
    class MyProcess
    {
        public static void Main()
        {
            try
            {
                using (Process myProcess = new Process())
                {
                    myProcess.StartInfo.UseShellExecute = false;
                    // You can start any process, HelloWorld is a do-nothing example.
                    myProcess.StartInfo.FileName = "C:\\HelloWorld.exe";
                    myProcess.StartInfo.CreateNoWindow = true;
                    myProcess.Start();
                    // This code assumes the process you are starting will terminate itself.
                    // Given that it is started without a window so you cannot terminate it
                    // on the desktop, it must terminate itself or you can do it programmatically
                    // from this application using the Kill method.
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}

Imports System.Diagnostics
Imports System.ComponentModel

Namespace MyProcessSample
    Class MyProcess
        Public Shared Sub Main()
            Try
                Using myProcess As New Process()

                    myProcess.StartInfo.UseShellExecute = False
                    ' You can start any process, HelloWorld is a do-nothing example.
                    myProcess.StartInfo.FileName = "C:\\HelloWorld.exe"
                    myProcess.StartInfo.CreateNoWindow = True
                    myProcess.Start()
                    ' This code assumes the process you are starting will terminate itself. 
                    ' Given that it is started without a window so you cannot terminate it 
                    ' on the desktop, it must terminate itself or you can do it programmatically
                    ' from this application using the Kill method.
                End Using
            Catch e As Exception
                Console.WriteLine((e.Message))
            End Try
        End Sub
    End Class
End Namespace

Remarques

Vous devez définir au moins la FileName propriété avant de commencer le processus. Le nom de fichier est n’importe quelle application ou document. Un document est défini comme étant n’importe quel type de fichier auquel est associée une action ouverte ou par défaut. 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 des dossiers , qui est disponible via le système d’exploitation. Le bouton Avancé mène à une boîte de dialogue qui indique si une action ouverte est associée à un type de fichier inscrit spécifique.

L’ensemble de types de fichiers disponibles dépend en partie de la valeur de la UseShellExecute propriété . Si UseShellExecute est true, vous pouvez démarrer n’importe quel document et effectuer des opérations sur le fichier, telles que l’impression, avec le Process composant. Quand UseShellExecute est false, vous pouvez démarrer uniquement les exécutables avec le Process composant.

Vous pouvez démarrer une application ClickOnce en définissant la FileName propriété sur l’emplacement (par exemple, une adresse Web) à partir duquel vous avez initialement installé l’application. Ne démarrez pas une application ClickOnce en spécifiant son emplacement installé sur votre disque dur.

Important

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