ProcessStartInfo Klasse

Definition

Gibt eine Wertemenge an, die beim Starten eines Prozesses verwendet wird.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
Vererbung
ProcessStartInfo
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der ProcessStartInfo-Klasse Internet Explorer starten und die Ziel-URLs als ProcessStartInfo Argumente bereitstellen.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

Hinweise

ProcessStartInfo wird in Verbindung mit der Process Komponente verwendet.ProcessStartInfo is used together with the Process component. Wenn Sie einen Prozess mit der Process-Klasse starten, können Sie zusätzlich zu den Informationen, die beim Anfügen an einen laufenden Prozess verfügbar sind, auf die Prozessinformationen zugreifen.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.

Sie können die ProcessStartInfo-Klasse verwenden, um eine bessere Kontrolle über den Prozess zu erhalten, den Sie starten.You can use the ProcessStartInfo class for better control over the process you start. Sie müssen mindestens die FileName-Eigenschaft entweder manuell oder mithilfe des-Konstruktors festlegen.You must at least set the FileName property, either manually or using the constructor. Der Dateiname ist eine beliebige Anwendung oder ein Dokument.The file name is any application or document. Hier ist ein Dokument als beliebiger Dateityp definiert, dem eine geöffnete oder eine Standardaktion zugeordnet ist.Here a document is defined to be any file type that has an open or default action associated with it. 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.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. Die Schaltfläche erweitert führt zu einem Dialogfeld, in dem angezeigt wird, ob eine geöffnete Aktion einem bestimmten registrierten Dateityp zugeordnet ist.The Advanced button leads to a dialog box that shows whether there is an open action associated with a specific registered file type.

Außerdem können Sie andere Eigenschaften festlegen, die Aktionen definieren, die mit dieser Datei ausgeführt werden sollen.In addition, you can set other properties that define actions to take with that file. Sie können einen Wert angeben, der für den Typ der FileName-Eigenschaft für die Verb-Eigenschaft spezifisch ist.You can specify a value specific to the type of the FileName property for the Verb property. Beispielsweise können Sie für einen Dokumenttyp "Print" angeben.For example, you can specify "print" for a document type. Darüber hinaus können Sie Arguments Eigenschaftswerte als Befehlszeilenargumente angeben, die an die geöffnete Prozedur der Datei übergeben werden sollen.Additionally, you can specify Arguments property values to be command-line arguments to pass to the file's open procedure. Wenn Sie z. b. 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.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.

Standard Eingaben sind normalerweise die Tastatur, und Standardausgabe und Standardfehler sind normalerweise der Bildschirm Monitor.Standard input is usually the keyboard, and standard output and standard error are usually the monitor screen. Sie können jedoch die Eigenschaften RedirectStandardInput, RedirectStandardOutputund RedirectStandardError verwenden, um zu bewirken, dass der Prozess Eingaben aus einer Datei oder einem anderen Gerät zurückgibt.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. Wenn Sie die Eigenschaften StandardInput, StandardOutputoder StandardError der Process Komponente verwenden, müssen Sie zuerst den entsprechenden Wert für die Eigenschaft ProcessStartInfo festlegen.If you use the StandardInput, StandardOutput, or StandardError properties on the Process component, you must first set the corresponding value on the ProcessStartInfo property. Andernfalls löst das System eine Ausnahme aus, wenn Sie den Stream lesen oder in den Stream schreiben.Otherwise, the system throws an exception when you read or write to the stream.

Legen Sie die UseShellExecute-Eigenschaft fest, um anzugeben, ob der Prozess mit der Betriebssystemshell gestartet werden soll.Set the UseShellExecute property to specify whether to start the process by using the operating system shell. Wenn UseShellExecute auf falsefestgelegt ist, erbt der neue Prozess die Standardeingabe, Standardausgabe und Standardfehlerstreams des aufrufenden Prozesses, es sei denn, die Eigenschaften RedirectStandardInput, RedirectStandardOutputoder RedirectStandardError werden auf truefestgelegt.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.

Sie können den Wert einer beliebigen ProcessStartInfo Eigenschaft bis zu dem Zeitpunkt ändern, zu dem der Prozess gestartet wird.You can change the value of any ProcessStartInfo property up to the time that the process starts. Nachdem Sie den Prozess gestartet haben, hat das Ändern dieser Werte keine Auswirkung.After you start the process, changing these values has no effect.

Hinweis

Diese Klasse enthält einen Link Aufruf auf Klassenebene, der für alle Elemente gilt.This class contains a link demand at the class level that applies to all members. Eine SecurityException wird ausgelöst, wenn der unmittelbare Aufrufer nicht über die Berechtigung für volle Vertrauenswürdigkeit verfügt.A SecurityException is thrown when the immediate caller does not have full-trust permission. Ausführliche Informationen zu Sicherheitsanforderungen finden Sie unter LinkAufrufe.For details about security demands, see Link Demands.

Konstruktoren

ProcessStartInfo()

Initialisiert eine neue Instanz der ProcessStartInfo-Klasse, ohne einen Dateinamen anzugeben, mit dem der Prozess gestartet werden soll.Initializes a new instance of the ProcessStartInfo class without specifying a file name with which to start the process.

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.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)

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.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.

Eigenschaften

ArgumentList

Ruft eine Sammlung von Befehlszeilenargumenten ab, die beim Starten der Anwendung verwendet werden sollen, oder legt diesen fest.Gets a collection of command-line arguments to use when starting the application.

Arguments

Ruft den Satz von Befehlszeilenargumenten ab, die beim Starten der Anwendung verwendet werden sollen, oder legt diesen fest.Gets or sets the set of command-line arguments to use when starting the application.

CreateNoWindow

Ruft einen Wert ab, der angibt, ob der Prozess in einem neuen Fenster gestartet werden soll, oder legt diesen fest.Gets or sets a value indicating whether to start the process in a new window.

Domain

Ruft einen Wert ab, der die Domäne kennzeichnet, die beim Starten des Prozesses verwendet werden soll, oder legt diesen fest.Gets or sets a value that identifies the domain to use when starting the process. Wenn dieser Wert null ist, muss die UserName-Eigenschaft im UPN-Format angegeben werden.If this value is null, the UserName property must be specified in UPN format.

Environment

Ruft die Umgebungsvariablen ab, die für diesen Prozess und seine untergeordneten Prozesse gelten.Gets the environment variables that apply to this process and its child processes.

EnvironmentVariables

Ruft Suchpfade für Dateien, Verzeichnisse für temporäre Dateien, anwendungsspezifische Optionen und andere ähnliche Informationen ab.Gets search paths for files, directories for temporary files, application-specific options, and other similar information.

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.Gets or sets a value indicating whether an error dialog box is displayed to the user if the process cannot be started.

ErrorDialogParentHandle

Ruft das Fensterhandle ab, das beim Anzeigen eines Fehlerdialogfelds für einen fehlgeschlagenen Prozessstart verwendet wird, oder legt dieses fest.Gets or sets the window handle to use when an error dialog box is shown for a process that cannot be started.

FileName

Ruft die zu startende Anwendung oder das zu startende Dokument ab oder legt die Anwendung bzw. das Dokument fest.Gets or sets the application or document to start.

LoadUserProfile

Ruft einen Wert ab, der angibt, ob das Windows-Benutzerprofil aus der Registrierung geladen werden soll, oder legt diesen fest.Gets or sets a value that indicates whether the Windows user profile is to be loaded from the registry.

Password

Ruft eine sichere Zeichenfolge ab, die das Benutzerkennwort enthält, das beim Starten des Prozesses verwendet werden soll, oder legt diese fest.Gets or sets a secure string that contains the user password to use when starting the process.

PasswordInClearText

Dient zum Abrufen oder Festlegen des unverschlüsselten Benutzerkennworts, das beim Starten des Prozesses verwendet werden soll.Gets or sets the user password in clear text to use when starting the process.

RedirectStandardError

Ruft einen Wert ab, der angibt, ob die Fehlerausgabe einer Anwendung in den StandardError-Datenstrom geschrieben wird, oder legt diesen fest.Gets or sets a value that indicates whether the error output of an application is written to the StandardError stream.

RedirectStandardInput

Ruft einen Wert ab, der angibt, ob die Eingabe für eine Anwendung aus dem StandardInput-Datenstrom gelesen wird, oder legt diesen fest.Gets or sets a value indicating whether the input for an application is read from the StandardInput stream.

RedirectStandardOutput

Ruft einen Wert ab, der angibt, ob die Textausgabe einer Anwendung in den StandardOutput-Datenstrom geschrieben wird, oder legt diesen fest.Gets or sets a value that indicates whether the textual output of an application is written to the StandardOutput stream.

StandardErrorEncoding

Ruft die bevorzugte Codierung für die Fehlerausgabe ab oder legt diese fest.Gets or sets the preferred encoding for error output.

StandardInputEncoding

Ruft die bevorzugte Codierung für die Standardeingabe ab oder legt diese fest.Gets or sets the preferred encoding for standard input.

StandardOutputEncoding

Ruft die bevorzugte Codierung für die Standardausgabe ab oder legt diese fest.Gets or sets the preferred encoding for standard output.

UserName

Ruft den beim Starten des Prozesses zu verwendenden Benutzernamen ab oder legt diesen fest.Gets or sets the user name to use when starting the process. Wenn Sie das UPN-Format (user@DNS_domain_name) verwenden, muss die Domain-Eigenschaft null sein.If you use the UPN format, user@DNS_domain_name, the Domain property must be null.

UseShellExecute

Ruft einen Wert ab, der angibt, ob zum Starten des Prozesses die Betriebssystemshell verwendet werden soll, oder legt diesen fest.Gets or sets a value indicating whether to use the operating system shell to start the process.

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.Gets or sets the verb to use when opening the application or document specified by the FileName property.

Verbs

Ruft den Satz der Verben ab, der dem durch die FileName-Eigenschaft angegebenen Dateityp zugeordnet ist.Gets the set of verbs associated with the type of file specified by the FileName property.

WindowStyle

Ruft den Fensterzustand ab, der beim Starten des Prozesses verwendet werden soll, oder legt diesen fest.Gets or sets the window state to use when the process is started.

WorkingDirectory

Ruft das Arbeitsverzeichnis für den zu startenden Prozess ab oder legt es fest, wenn die UseShellExecute Eigenschaft false ist.When the UseShellExecute property is false, gets or sets the working directory for the process to be started. Ruft das Verzeichnis ab, das den zu startenden Prozess enthält, oder legt es fest, wenn UseShellExecutetrue ist.When UseShellExecute is true, gets or sets the directory that contains the process to be started.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Sicherheit

SecurityPermission
zum Aufrufen von Membern von ProcessStartInfo.for calling members of ProcessStartInfo. Demand-Wert: LinkDemand; Benannte Berechtigungs Sätze: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Gilt für:

Siehe auch