ProcessStartInfo Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt eine Gruppe von Werten an, die beim Starten eines Prozesses verwendet werden.
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 die Verwendung der ProcessStartInfo Klasse zum Starten von Internet Explorer veranschaulicht. Die Ziel-URLs werden als ProcessStartInfo Argumente bereitgestellt.
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 mit der Process Klasse starten, haben Sie zusätzlich zu diesen Verfügbaren Zugriff auf Prozessinformationen, die beim Anfügen an einen ausgeführten Prozess verfügbar sind.
Sie können die ProcessStartInfo Klasse verwenden, um den Prozess, den Sie beginnen, besser zu steuern. Sie müssen die FileName Eigenschaft mindestens manuell oder mit dem Konstruktor festlegen. Der Dateiname ist eine beliebige Anwendung oder ein Beliebiges Dokument. Hier ist ein Dokument 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.
Darüber hinaus können Sie andere Eigenschaften festlegen, die Aktionen definieren, die mit dieser Datei ausgeführt werden sollen. Sie können einen bestimmten Wert für den Typ der FileName Eigenschaft für die Verb Eigenschaft angeben. Sie können z. B. "drucken" 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 Eigenschaft angeben, können Sie mit der FileNameArguments Eigenschaft eine Textdatei angeben, die vom Editor geöffnet werden soll.
Die Standardeingabe ist in der Regel die Tastatur, und Standardausgabe und Standardfehler sind in der Regel der Monitorbildschirm. Sie können jedoch die RedirectStandardInput, RedirectStandardOutputund RedirectStandardError Eigenschaften verwenden, um dazu zu führen, dass der Prozess Eingaben von einer Datei oder einem anderen Gerät erhält oder die Ausgabe zurückgibt. Wenn Sie die StandardInputKomponenten StandardOutputStandardError oder Eigenschaften Process verwenden, müssen Sie zuerst den entsprechenden Wert für die ProcessStartInfo Eigenschaft festlegen. Andernfalls löst das System beim Lesen oder Schreiben in den Datenstrom eine Ausnahme aus.
Legen Sie die UseShellExecute Eigenschaft fest, um anzugeben, ob der Prozess mithilfe der Betriebssystemshell gestartet werden soll. Wenn dieser auf UseShellExecute festgelegt falseist, erbt der neue Prozess die Standardeingabe-, Standardausgabe- und Standardfehlerströme des aufrufenden Prozesses, es sei denn, die RedirectStandardInput, RedirectStandardOutputbzw RedirectStandardError . die Eigenschaften sind auf truefestgelegt.
Sie können den Wert einer beliebigen ProcessStartInfo Eigenschaft bis zu dem Zeitpunkt ändern, zu dem der Prozess gestartet wird. Nachdem Sie den Prozess gestartet haben, hat das Ändern dieser Werte keine Auswirkung.
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.
Hinweis
Diese Klasse enthält eine Linknachfrage auf Klassenebene, die für alle Member gilt. Ein SecurityException Fehler wird ausgelöst, wenn der sofortige Aufrufer nicht über voll vertrauenswürdige Berechtigungen verfügt. Ausführliche Informationen zu Sicherheitsanforderungen finden Sie unter Linkanforderungen.
Konstruktoren
| Name | Beschreibung |
|---|---|
| ProcessStartInfo() |
Initialisiert eine neue Instanz der ProcessStartInfo Klasse, ohne einen Dateinamen anzugeben, mit dem der Prozess gestartet werden soll. |
| ProcessStartInfo(String, IEnumerable<String>) |
Initialisiert eine neue Instanz der ProcessStartInfo Klasse und gibt den Namen der anwendung an, die gestartet werden soll, und eine Reihe von Befehlszeilenargumenten, die an die Anwendung übergeben werden sollen. |
| ProcessStartInfo(String, String) |
Initialisiert eine neue Instanz der ProcessStartInfo Klasse, gibt einen Anwendungsdateinamen an, mit dem der Prozess gestartet werden soll, und gibt eine Reihe von Befehlszeilenargumenten an, die an die Anwendung übergeben werden sollen. |
| ProcessStartInfo(String) |
Initialisiert eine neue Instanz der ProcessStartInfo Klasse und gibt einen Dateinamen wie eine Anwendung oder ein Dokument an, mit der der Prozess gestartet werden soll. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| ArgumentList |
Ruft eine Auflistung von Befehlszeilenargumenten ab, die beim Starten der Anwendung verwendet werden sollen. Zeichenfolgen, die der Liste hinzugefügt wurden, müssen zuvor nicht escaped sein. |
| Arguments |
Ruft den Satz von Befehlszeilenargumenten ab, die beim Starten der Anwendung verwendet werden sollen, oder legt diesen fest. |
| CreateNewProcessGroup |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Prozess in einer neuen Prozessgruppe gestartet werden soll. |
| CreateNoWindow |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Prozess in einem neuen Fenster gestartet werden soll. |
| Domain |
Dient zum Abrufen oder Festlegen eines Werts, der die Domäne identifiziert, die beim Starten des Prozesses verwendet werden soll. Wenn dieser Wert lautet |
| 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 |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dem Benutzer ein Fehlerdialogfeld angezeigt wird, wenn der Prozess nicht gestartet werden kann. |
| ErrorDialogParentHandle |
Ruft ab oder legt das Fensterhandle fest, das verwendet werden soll, wenn ein Fehlerdialogfeld für einen Prozess angezeigt wird, der nicht gestartet werden kann. |
| FileName |
Ruft die anwendung oder das Dokument ab, die gestartet werden soll, oder legt sie fest. |
| LoadUserProfile |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Windows-Benutzerprofil aus der Registrierung geladen werden soll. |
| Password |
Dient zum Abrufen oder Festlegen einer sicheren Zeichenfolge, die das Benutzerkennwort enthält, das beim Starten des Prozesses verwendet werden soll. |
| PasswordInClearText |
Ruft das Benutzerkennwort im Klartext ab, das beim Starten des Prozesses verwendet werden soll, oder legt dieses fest. |
| RedirectStandardError |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Fehlerausgabe einer Anwendung in den StandardError Datenstrom geschrieben wird. |
| RedirectStandardInput |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Eingabe für eine Anwendung aus dem StandardInput Datenstrom gelesen wird. |
| RedirectStandardOutput |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Textausgabe einer Anwendung in den StandardOutput Datenstrom geschrieben wird. |
| StandardErrorEncoding |
Ruft die bevorzugte Codierung für die Fehlerausgabe ab oder legt sie fest. |
| StandardInputEncoding |
Ruft die bevorzugte Codierung für Standardeingaben ab oder legt sie fest. |
| StandardOutputEncoding |
Ruft die bevorzugte Codierung für die Standardausgabe ab oder legt sie fest. |
| UseCredentialsForNetworkingOnly |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Benutzeranmeldeinformationen nur für Netzwerkressourcen verwendet werden. |
| UserName |
Ruft den Benutzernamen ab, der beim Starten des Prozesses verwendet werden soll, oder legt diesen fest. Wenn Sie das UPN-Format verwenden, |
| UseShellExecute |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Betriebssystemshell zum Starten des Prozesses verwendet werden soll. |
| Verb |
Ruft das Verb ab, das beim Öffnen der anwendung oder des Dokuments verwendet werden soll, das von der FileName Eigenschaft angegeben wird, oder legt dieses fest. |
| Verbs |
Ruft den Satz von Verben ab, die dem Dateityp zugeordnet sind, der durch die FileName Eigenschaft angegeben wird. |
| WindowStyle |
Ruft den Fensterstatus ab, der beim Starten des Prozesses verwendet werden soll, oder legt diesen fest. |
| WorkingDirectory |
Wenn die UseShellExecute Eigenschaft lautet |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |