ProcessStartInfo.FileName Eigenschaft

Definition

Namespace:

System.Diagnostics

Assemblys:

netstandard.dll, System.Diagnostics.Process.dll

Quelle:

ProcessStartInfo.cs

Ruft die anwendung oder das Dokument ab, die gestartet werden soll, oder legt sie fest.

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

Eigenschaftswert

String

Der Name der zu startenden Anwendung oder der Name eines Dokuments eines Dateityps, der einer Anwendung zugeordnet ist und über eine standardmäßige geöffnete Aktion verfügt. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

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

Hinweise

Sie müssen mindestens die FileName Eigenschaft festlegen, bevor Sie den Prozess starten. Der Dateiname ist eine beliebige Anwendung oder ein Beliebiges Dokument. Ein Dokument ist so definiert, dass es sich um einen beliebigen Dateityp handelt, der eine geöffnete oder Standardaktion zugeordnet ist. Sie können registrierte Dateitypen und die zugehörigen Anwendungen für Ihren Computer anzeigen, indem Sie das Dialogfeld "Ordneroptionen " verwenden, das über das Betriebssystem verfügbar ist. Die Schaltfläche "Erweitert " führt zu einem Dialogfeld, in dem angezeigt wird, ob eine geöffnete Aktion einem bestimmten registrierten Dateityp zugeordnet ist.

Die für Sie verfügbaren Dateitypen hängen teilweise vom Wert der UseShellExecute Eigenschaft ab. Wenn UseShellExecute dies der Fall ist true, können Sie ein beliebiges Dokument starten und Vorgänge für die Datei ausführen, z. B. das Drucken, mit der Process Komponente. Wenn UseShellExecute ja false, können Sie nur ausführbare Dateien mit der Process Komponente starten.

Sie können eine ClickOnce-Anwendung starten, indem Sie die FileName Eigenschaft auf den Speicherort (z. B. eine Webadresse) festlegen, von der Sie die Anwendung ursprünglich installiert haben. Starten Sie eine ClickOnce-Anwendung nicht, indem Sie den installierten Speicherort auf der Festplatte angeben.

Von Bedeutung

Die Verwendung einer Instanz dieses Typs mit nicht vertrauenswürdigen Daten ist ein Sicherheitsrisiko. Verwenden Sie dieses Objekt nur mit vertrauenswürdigen Daten. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.