ProcessStartInfo Klasse

Definition

Gibt eine Wertemenge an, die beim Starten eines Prozesses verwendet wird.

public ref class ProcessStartInfo sealed
public sealed class ProcessStartInfo
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class ProcessStartInfo
type ProcessStartInfo = class
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type ProcessStartInfo = class
Public NotInheritable Class ProcessStartInfo
Vererbung
ProcessStartInfo
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Die -Klasse zum Starten von ProcessStartInfo Internet Explorer verwendet wird. Die Ziel-URLs werden als ProcessStartInfo Argumente bereitgestellt.

#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()
{
    // 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");
}

// 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()
            ' 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

Hinweise

ProcessStartInfo wird zusammen mit der Process Komponente verwendet. Wenn Sie einen Prozess mithilfe der Process -Klasse starten, haben Sie zusätzlich zu den beim Anfügen an einen ausgeführten Prozess verfügbaren Zugriff auf Prozessinformationen.

Sie können die ProcessStartInfo -Klasse verwenden, um den prozess, den Sie starten, besser steuern zu können. Sie müssen die FileName Eigenschaft mindestens manuell oder mithilfe des Konstruktors festlegen. Der Dateiname ist eine beliebige Anwendung oder ein Beliebiges Dokument. Hier wird ein Dokument so definiert, dass es sich um einen beliebigen Dateityp handelt, dem 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.

Darüber hinaus können Sie andere Eigenschaften festlegen, die Aktionen definieren, die mit dieser Datei ausgeführt werden sollen. Sie können einen Wert angeben, der für den Typ der FileName Eigenschaft spezifisch ist Verb . Sie können beispielsweise "print" für einen Dokumenttyp angeben. Darüber hinaus können Sie Eigenschaftswerte als Befehlszeilenargumente angeben Arguments , die an die geöffnete Prozedur der Datei übergeben werden sollen. Wenn Sie beispielsweise eine Text-Editor-Anwendung in der FileName -Eigenschaft angeben, können Sie die Arguments -Eigenschaft verwenden, um eine Textdatei anzugeben, die vom Editor geöffnet werden soll.

Standardeingabe ist in der Regel die Tastatur, und Standardausgabe und Standardfehler sind normalerweise der Monitorbildschirm. Sie können jedoch die RedirectStandardInputEigenschaften , RedirectStandardOutputund RedirectStandardError verwenden, um zu bewirken, dass der Prozess Eingaben von einer Datei oder einem anderen Gerät erhält oder eine Ausgabe an ein anderes Gerät zurückgibt. Wenn Sie die StandardInputEigenschaften , StandardOutputoder StandardError für die Process Komponente verwenden, müssen Sie zuerst den entsprechenden Wert für die ProcessStartInfo -Eigenschaft festlegen. Andernfalls löst das System eine Ausnahme aus, wenn Sie den Stream lesen oder schreiben.

Legen Sie die UseShellExecute -Eigenschaft fest, um anzugeben, ob der Prozess mithilfe der Betriebssystemshell gestartet werden soll. Wenn UseShellExecute auf falsefestgelegt ist, erbt der neue Prozess die Standardeingabe-, Standardausgabe- und Standardfehlerströme des aufrufenden Prozesses, es sei denn, die RedirectStandardInputEigenschaften RedirectStandardOutput, oder RedirectStandardError sind auf truefestgelegt.

Sie können den Wert einer beliebigen ProcessStartInfo Eigenschaft bis zum Start des Prozesses ändern. Nachdem Sie den Prozess gestartet haben, hat das Ändern dieser Werte keine Auswirkungen.

Wichtig

Das Verwenden einer Instanz dieses Objekts mit nicht vertrauenswürdigen Daten stellt ein Sicherheitsrisiko dar. Verwenden Sie dieses Objekt nur mit vertrauenswürdigen Daten. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.

Hinweis

Diese Klasse enthält einen Linkbedarf auf Klassenebene, der für alle Member gilt. Ein SecurityException wird ausgelöst, wenn der unmittelbare Aufrufer nicht über die Vollvertrauensberechtigung verfügt. Ausführliche Informationen zu Sicherheitsanforderungen finden Sie unter Linkanforderungen.

Konstruktoren

ProcessStartInfo()

Initialisiert eine neue Instanz der ProcessStartInfo-Klasse, ohne einen Dateinamen anzugeben, mit dem der Prozess gestartet werden soll.

ProcessStartInfo(String)

Initialisiert eine neue Instanz der ProcessStartInfo-Klasse und gibt einen Dateinamen an, mit dem der Prozess gestartet werden soll, z. B. eine Anwendung oder ein Dokument.

ProcessStartInfo(String, IEnumerable<String>)

Gibt eine Wertemenge an, die beim Starten eines Prozesses verwendet wird.

ProcessStartInfo(String, String)

Initialisiert eine neue Instanz der ProcessStartInfo-Klasse und gibt einen Anwendungsdateinamen an, mit dem der Prozess gestartet wird, sowie einen Satz von Befehlszeilenargumenten, die an die Anwendung übergeben werden.

Eigenschaften

ArgumentList

Ruft eine Sammlung von Befehlszeilenargumenten ab, die beim Starten der Anwendung verwendet werden sollen, oder legt diesen fest. Der Liste hinzugefügte Zeichenfolgen müssen nicht zuvor mit Escapezeichen versehen werden.

Arguments

Ruft den Satz von Befehlszeilenargumenten ab, die beim Starten der Anwendung verwendet werden sollen, oder legt diesen fest.

CreateNoWindow

Ruft einen Wert ab, der angibt, ob der Prozess in einem neuen Fenster gestartet werden soll, oder legt diesen fest.

Domain

Ruft einen Wert ab, der die Domäne kennzeichnet, die beim Starten des Prozesses verwendet werden soll, oder legt diesen fest. Wenn dieser Wert null ist, muss die UserName-Eigenschaft im UPN-Format angegeben werden.

Environment

Ruft die Umgebungsvariablen ab, die für diesen Prozess und seine untergeordneten Prozesse gelten.

EnvironmentVariables

Ruft Suchpfade für Dateien, Verzeichnisse für temporäre Dateien, anwendungsspezifische Optionen und andere ähnliche Informationen ab.

ErrorDialog

Ruft einen Wert ab, der angibt, ob dem Benutzer ein Fehlerdialogfeld angezeigt wird, wenn der Prozess nicht gestartet werden kann, oder legt diesen fest.

ErrorDialogParentHandle

Ruft das Fensterhandle ab, das beim Anzeigen eines Fehlerdialogfelds für einen fehlgeschlagenen Prozessstart verwendet wird, oder legt dieses fest.

FileName

Ruft die zu startende Anwendung oder das zu startende Dokument ab oder legt die Anwendung bzw. das Dokument fest.

LoadUserProfile

Ruft einen Wert ab, der angibt, ob das Windows-Benutzerprofil aus der Registrierung geladen werden soll, oder legt diesen fest.

Password

Ruft eine sichere Zeichenfolge ab, die das Benutzerkennwort enthält, das beim Starten des Prozesses verwendet werden soll, oder legt diese fest.

PasswordInClearText

Dient zum Abrufen oder Festlegen des unverschlüsselten Benutzerkennworts, das beim Starten des Prozesses verwendet werden soll.

RedirectStandardError

Ruft einen Wert ab, der angibt, ob die Fehlerausgabe einer Anwendung in den StandardError -Datenstrom geschrieben wird, oder legt diesen fest.

RedirectStandardInput

Ruft einen Wert ab, der angibt, ob die Eingabe für eine Anwendung aus dem StandardInput-Datenstrom gelesen wird, oder legt diesen fest.

RedirectStandardOutput

Ruft einen Wert ab, der angibt, ob die Textausgabe einer Anwendung in den StandardOutput-Datenstrom geschrieben wird, oder legt diesen fest.

StandardErrorEncoding

Ruft die bevorzugte Codierung für die Fehlerausgabe ab oder legt diese fest.

StandardInputEncoding

Ruft die bevorzugte Codierung für die Standardeingabe ab oder legt diese fest.

StandardOutputEncoding

Ruft die bevorzugte Codierung für die Standardausgabe ab oder legt diese fest.

UseCredentialsForNetworkingOnly

Gibt eine Wertemenge an, die beim Starten eines Prozesses verwendet wird.

UserName

Ruft den beim Starten des Prozesses zu verwendenden Benutzernamen ab oder legt diesen fest. Wenn Sie das UPN-Format (user@DNS_domain_name) verwenden, muss die Domain-Eigenschaft null sein.

UseShellExecute

Ruft einen Wert ab, der angibt, ob zum Starten des Prozesses die Betriebssystemshell verwendet werden soll, oder legt diesen fest.

Verb

Ruft das Verb ab, das beim Öffnen der in der FileName-Eigenschaft angegebenen Anwendung oder des in dieser Eigenschaft angegebenen Dokuments verwendet wird, oder legt dieses fest.

Verbs

Ruft den Satz der Verben ab, der dem durch die FileName-Eigenschaft angegebenen Dateityp zugeordnet ist.

WindowStyle

Ruft den Fensterzustand ab, der beim Starten des Prozesses verwendet werden soll, oder legt diesen fest.

WorkingDirectory

Wenn die UseShellExecute Eigenschaft false ist, ruft das Arbeitsverzeichnis für den zu startenden Prozess ab oder legt ihn fest,. Wenn UseShellExecutetrue ist, ruft das Verzeichnis ab, das den zu startenden Prozess enthält oder legt ihn fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen