ProcessStartInfo Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.Process.dll

Zdroj:

ProcessStartInfo.cs

Určuje sadu hodnot, které se použijí při spuštění procesu.

public ref class ProcessStartInfo sealed

public sealed class ProcessStartInfo

type ProcessStartInfo = class

Public NotInheritable Class ProcessStartInfo

Dědičnost

Object

ProcessStartInfo

Příklady

Následující příklad kódu ukazuje použití ProcessStartInfo třídy ke spuštění aplikace Internet Explorer. Cílové adresy URL jsou zadané jako ProcessStartInfo argumenty.

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

Poznámky

ProcessStartInfo se používá společně s komponentou Process . Při spuštění procesu pomocí Process třídy máte přístup k informacím o zpracování kromě toho, které jsou k dispozici při připojování ke spuštěném procesu.

Třídu můžete použít ProcessStartInfo pro lepší kontrolu nad procesem, který spustíte. Musíte alespoň nastavit FileName vlastnost ručně nebo pomocí konstruktoru. Název souboru je libovolná aplikace nebo dokument. Dokument je zde definován jako jakýkoli typ souboru, který má přidruženou otevřenou nebo výchozí akci. Registrované typy souborů a jejich přidružené aplikace pro váš počítač můžete zobrazit pomocí dialogového okna Možnosti složky , které je dostupné prostřednictvím operačního systému. Tlačítko Upřesnit vede k dialogovému okně, které ukazuje, zda je otevřená akce přidružená ke konkrétnímu registrovanému typu souboru.

Kromě toho můžete nastavit další vlastnosti, které definují akce, které se mají s tímto souborem provést. Můžete zadat hodnotu specifickou pro typ FileName vlastnosti vlastnosti Verb . Můžete například zadat "tisk" pro typ dokumentu. Kromě toho můžete zadat Arguments hodnoty vlastností, které mají být argumenty příkazového řádku pro předání otevřené procedury souboru. Pokud například ve vlastnosti zadáte aplikaci textového editoru FileName , můžete pomocí Arguments vlastnosti určit textový soubor, který má editor otevřít.

Standardní vstup je obvykle klávesnice a standardní výstup a standardní chyba jsou obvykle obrazovka monitoru. Můžete však použít RedirectStandardInput, RedirectStandardOutputa RedirectStandardError vlastnosti způsobit proces získání vstupu ze souboru nebo jiného zařízení výstupu. Pokud použijete vlastnost StandardInput, StandardOutputnebo StandardError vlastnosti komponenty Process , musíte nejprve nastavit odpovídající hodnotu vlastnosti ProcessStartInfo . Jinak systém vyvolá výjimku při čtení nebo zápisu do datového proudu.

UseShellExecute Nastavte vlastnost, která určuje, zda se má proces spustit pomocí prostředí operačního systému. Je-li UseShellExecute nastavena na false, nový proces dědí standardní vstup, standardní výstup a standardní chybové proudy volajícího procesu, pokud nejsou nastaveny RedirectStandardInputtrue, RedirectStandardOutputnebo RedirectStandardError vlastnosti , v uvedeném pořadí , na .

Hodnotu libovolné ProcessStartInfo vlastnosti můžete změnit až do okamžiku spuštění procesu. Po spuštění procesu nemá změna těchto hodnot žádný vliv.

Důležité

Použití instance tohoto typu s nedůvěryhodnými daty představuje bezpečnostní riziko. Tento objekt použijte pouze s důvěryhodnými daty. Další informace naleznete v tématu Ověření všech vstupů.

Poznámka:

Tato třída obsahuje požadavek na propojení na úrovni třídy, která se vztahuje na všechny členy. Vyvolá SecurityException se, když bezprostřední volající nemá oprávnění k úplnému důvěryhodnosti. Podrobnosti o požadavcích na zabezpečení najdete v tématu Požadavky propojení.

Konstruktory

Name	Description
ProcessStartInfo()	Inicializuje novou instanci ProcessStartInfo třídy bez zadání názvu souboru, se kterým se má proces spustit.
ProcessStartInfo(String, IEnumerable<String>)	Inicializuje novou instanci ProcessStartInfo třídy a určuje název aplikace, která se má spustit, a sadu argumentů příkazového řádku, které se předávají aplikaci.
ProcessStartInfo(String, String)	Inicializuje novou instanci ProcessStartInfo třídy, určuje název souboru aplikace, se kterým se má proces spustit, a určuje sadu argumentů příkazového řádku, které se mají předat aplikaci.
ProcessStartInfo(String)	Inicializuje novou instanci ProcessStartInfo třídy a určuje název souboru, například aplikaci nebo dokument, se kterým se má proces spustit.

Vlastnosti

Name	Description
ArgumentList	Získá kolekci argumentů příkazového řádku, které se mají použít při spuštění aplikace. Řetězce přidané do seznamu nemusí být dříve uchvácené.
Arguments	Získá nebo nastaví sadu argumentů příkazového řádku, které se mají použít při spuštění aplikace.
CreateNewProcessGroup	Získá nebo nastaví hodnotu určující, zda se má proces spustit v nové skupině procesů.
CreateNoWindow	Získá nebo nastaví hodnotu určující, zda má spustit proces v novém okně.
Domain	Získá nebo nastaví hodnotu, která identifikuje doménu, která se má použít při spuštění procesu. Pokud je nulltato hodnota , UserName vlastnost musí být zadána ve formátu UPN.
Environment	Získá proměnné prostředí, které se vztahují na tento proces a jeho podřízené procesy.
EnvironmentVariables	Získá cesty hledání pro soubory, adresáře pro dočasné soubory, možnosti specifické pro aplikaci a další podobné informace.
ErrorDialog	Získá nebo nastaví hodnotu určující, zda se uživateli zobrazí dialogové okno chyby, pokud proces nelze spustit.
ErrorDialogParentHandle	Získá nebo nastaví popisovač okna, který se má použít při zobrazení chybového dialogového okna pro proces, který nelze spustit.
FileName	Získá nebo nastaví aplikaci nebo dokument pro spuštění.
LoadUserProfile	Získá nebo nastaví hodnotu, která označuje, zda má být profil uživatele systému Windows načten z registru.
Password	Získá nebo nastaví zabezpečený řetězec, který obsahuje uživatelské heslo pro použití při spuštění procesu.
PasswordInClearText	Získá nebo nastaví uživatelské heslo ve formátu prostého textu, který se má použít při spuštění procesu.
RedirectStandardError	Získá nebo nastaví hodnotu, která označuje, zda je výstup chyby aplikace zapsán do datového StandardError proudu.
RedirectStandardInput	Získá nebo nastaví hodnotu určující, zda je vstup pro aplikaci načten z datového StandardInput proudu.
RedirectStandardOutput	Získá nebo nastaví hodnotu, která označuje, zda textový výstup aplikace je zapsán do datového StandardOutput proudu.
StandardErrorEncoding	Získá nebo nastaví upřednostňované kódování pro výstup chyby.
StandardInputEncoding	Získá nebo nastaví upřednostňované kódování pro standardní vstup.
StandardOutputEncoding	Získá nebo nastaví upřednostňované kódování pro standardní výstup.
UseCredentialsForNetworkingOnly	Získá nebo nastaví hodnotu, která označuje, zda se přihlašovací údaje uživatele používají pouze pro síťové prostředky.
UserName	Získá nebo nastaví uživatelské jméno, které se má použít při spuštění procesu. Pokud používáte formát hlavního názvu uživatele (UPN), user@DNS_domain_nameDomain vlastnost musí být null.
UseShellExecute	Získá nebo nastaví hodnotu určující, zda použít prostředí operačního systému ke spuštění procesu.
Verb	Získá nebo nastaví příkaz použít při otevření aplikace nebo dokumentu určené vlastností FileName .
Verbs	Získá sadu sloves přidružených k typu souboru určeného FileName vlastností.
WindowStyle	Získá nebo nastaví stav okna, který se má použít při spuštění procesu.
WorkingDirectory	UseShellExecute Pokud je falsevlastnost , získá nebo nastaví pracovní adresář pro proces, který má být spuštěn. Pokud UseShellExecute je true, získá nebo nastaví adresář, který obsahuje proces, který má být spuštěn.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Process