Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
0 von 1 fanden dies hilfreich - Dieses Thema bewerten.

ProcessStartInfo-Klasse

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

System.Object
  System.Diagnostics.ProcessStartInfo

Namespace:  System.Diagnostics
Assembly:  System (in System.dll)
[TypeConverterAttribute(typeof(ExpandableObjectConverter))]
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true, SelfAffectingProcessMgmt = true)]
[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
public sealed class ProcessStartInfo

Der ProcessStartInfo-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode ProcessStartInfo() Initialisiert eine neue Instanz der ProcessStartInfo-Klasse, ohne einen Dateinamen anzugeben, mit dem der Prozess gestartet werden soll.
Öffentliche Methode 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.
Öffentliche Methode 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.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Eigenschaft Arguments Ruft den Satz von Befehlszeilenargumenten ab, die beim Starten der Anwendung verwendet werden sollen, oder legt diesen fest.
Öffentliche Eigenschaft CreateNoWindow Ruft einen Wert ab, der angibt, ob der Prozess in einem neuen Fenster gestartet werden soll, oder legt diesen fest.
Öffentliche Eigenschaft Domain Ruft einen Wert ab, der die Domäne kennzeichnet, die beim Starten des Prozesses verwendet werden soll, oder legt diesen fest.
Öffentliche Eigenschaft EnvironmentVariables Ruft Suchpfade für Dateien, Verzeichnisse für temporäre Dateien, anwendungsspezifische Optionen und andere ähnliche Informationen ab.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft ErrorDialogParentHandle Ruft das Fensterhandle ab, das beim Anzeigen eines Fehlerdialogfelds für einen fehlgeschlagenen Prozessstart verwendet wird, oder legt dieses fest.
Öffentliche Eigenschaft FileName Ruft die zu startende Anwendung oder das zu startende Dokument ab oder legt die Anwendung bzw. das Dokument fest.
Öffentliche Eigenschaft LoadUserProfile Ruft einen Wert ab, der angibt, ob das Windows-Benutzerprofil aus der Registrierung geladen werden soll, oder legt diesen fest.
Öffentliche Eigenschaft Password Ruft eine sichere Zeichenfolge ab, die das Benutzerkennwort enthält, das beim Starten des Prozesses verwendet werden soll, oder legt diese fest.
Öffentliche Eigenschaft RedirectStandardError Ruft einen Wert ab, der angibt, ob die Fehlerausgabe einer Anwendung in den Process.StandardError-Stream geschrieben wird, oder legt diesen fest.
Öffentliche Eigenschaft RedirectStandardInput Ruft einen Wert ab, der angibt, ob die Eingabe für eine Anwendung aus dem Process.StandardInput-Stream gelesen wird, oder legt diesen fest.
Öffentliche Eigenschaft RedirectStandardOutput Ruft einen Wert ab, der angibt, ob die Ausgabe einer Anwendung in den Process.StandardOutput-Stream geschrieben wird, oder legt diesen fest.
Öffentliche Eigenschaft StandardErrorEncoding Ruft die bevorzugte Codierung für die Fehlerausgabe ab oder legt diese fest.
Öffentliche Eigenschaft StandardOutputEncoding Ruft die bevorzugte Codierung für die Standardausgabe ab oder legt diese fest.
Öffentliche Eigenschaft UserName Ruft den beim Starten des Prozesses zu verwendenden Benutzernamen ab oder legt diesen fest.
Öffentliche Eigenschaft UseShellExecute Ruft einen Wert ab, der angibt, ob zum Starten des Prozesses die Betriebssystemshell verwendet werden soll, oder legt diesen fest.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft Verbs Ruft den Satz der Verben ab, der dem durch die FileName-Eigenschaft angegebenen Dateityp zugeordnet ist.
Öffentliche Eigenschaft WindowStyle Ruft den Fensterzustand ab, der beim Starten des Prozesses verwendet werden soll, oder legt diesen fest.
Öffentliche Eigenschaft WorkingDirectory Ruft das Ausgangsverzeichnis für den zu startenden Prozess ab oder legt dieses fest.
Zum Seitenanfang
  Name Beschreibung
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

ProcessStartInfo wird zusammen mit der Process-Komponente verwendet. Wenn Sie einen Prozess mithilfe der Process-Klasse starten, können Sie auf zusätzliche Prozessinformationen zugreifen, die beim Anhängen an einen laufenden Prozess nicht verfügbar sind.

Sie können die ProcessStartInfo-Klasse verwenden, um eine bessere Kontrolle über den von Ihnen gestarteten Prozess zu erhalten. Sie müssen mindestens die FileName-Eigenschaft festlegen. Dies können Sie manuell oder mithilfe des Konstruktors ausführen. Bei dem Dateinamen handelt es sich um eine beliebige Anwendung bzw. ein beliebiges Dokument. Ein Dokument ist hier als ein beliebiger Dateityp definiert, dem eine Open- oder Standardaktion zugeordnet ist. Sie können die für den Computer registrierten Dateitypen und die zugeordneten Anwendungen im Dialogfeld Ordneroptionen des Betriebssystems anzeigen. Die Schaltfläche Erweitert führt zu einem Dialogfeld, in dem angezeigt wird, ob einem bestimmten registrierten Dateityp eine Open-Aktion zugeordnet ist.

Außerdem können Sie andere Eigenschaften festlegen, die mit dieser Datei auszuführende Aktionen definieren. Sie können für die Verb-Eigenschaft einen für den Typ der FileName-Eigenschaft spezifischen Wert angeben. Sie können z. B. für einen Dokumenttyp "print" angeben. Sie können außerdem angeben, dass Arguments-Eigenschaftswerte als Befehlszeilenargumente an die Open-Prozedur der Datei übergeben werden. Wenn Sie z. B. in der FileName-Eigenschaft eine Text-Editor-Anwendung angeben, können Sie mithilfe der Arguments-Eigenschaft eine Textdatei angeben, die durch den Editor geöffnet werden soll.

Als Standardeingabe wird i. d. R. die Tastatur verwendet, und die Standardausgabe sowie die Ausgabe von Fehlern erfolgt i. d. R. auf dem Monitorbildschirm. Sie können jedoch die RedirectStandardInput-Eigenschaft, die RedirectStandardOutput-Eigenschaft und die RedirectStandardError-Eigenschaft verwenden, damit der Prozess Eingaben aus einer Datei oder einem anderen Gerät abruft oder Ausgaben an diese zurückgibt. Wenn Sie die StandardInput-Eigenschaft, die StandardOutput-Eigenschaft oder die StandardError-Eigenschaft für die Process-Komponente 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 Stream eine Ausnahme aus.

Legen Sie UseShellExecute fest, um anzugeben, ob der Prozess mithilfe der Shell des Betriebssystems gestartet werden soll.

Sie können den Wert jeder ProcessStartInfo-Eigenschaft bis zum Startzeitpunkt des Prozesses ändern. Nach dem Starten des Prozesses hat das Ändern dieser Werte keine Auswirkungen.

Hinweis Hinweis

Diese Klasse enthält einen Linkaufruf auf der Klassenebene, der für alle Member gilt. Eine SecurityException wird ausgelöst, wenn der unmittelbare Aufrufer über keine Berechtigung mit vollständiger Vertrauenswürdigkeit verfügt. Ausführliche Informationen über Sicherheitsanforderungen finden Sie unter Verknüpfungsaufrufe.

Hinweis Hinweis

Das auf diesen Typ oder Member angewendete HostProtectionAttribute-Attribut besitzt den folgenden Resources-Eigenschaftswert: SharedState | SelfAffectingProcessMgmt. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie unter der HostProtectionAttribute-Klasse oder unter SQL Server-Programmierung und Hostschutzattribute.

Im folgenden Codebeispiel wird veranschaulicht, wie die ProcessStartInfo-Klasse zum Starten von Internet Explorer verwendet wird und die Ziel-URLs als ProcessStartInfo-Argumente übergibt.


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();
        }
    }
}


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ