ProcessStartInfo Třída

Definice

Obor názvů:

System.Diagnostics

Sestavení:

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, jak použít ProcessStartInfo třídu ke spuštění aplikace Internet Explorer. Cílové adresy URL se zadají jako ProcessStartInfo argumenty.

#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

Poznámky

ProcessStartInfo se používá společně se komponentou Process . Když spustíte proces pomocí Process třídy , máte přístup k informacím o procesu a navíc k informacím, které jsou k dispozici při připojování ke spuštěným procesům.

Třídu můžete použít ProcessStartInfo pro lepší kontrolu nad procesem, který zahájíte. Musíte alespoň nastavit FileName vlastnost, a to buď ručně, nebo pomocí konstruktoru. Název souboru je libovolná aplikace nebo dokument. Dokument je zde definován jako jakýkoli typ souboru, ke kterému je přidružena otevřená nebo výchozí akce. 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 oknu, které zobrazuje, jestli je k určitému registrovanému typu souboru přidružená akce Otevření.

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 Verb vlastnosti. Pro typ dokumentu můžete například zadat tisk. Kromě toho můžete zadat Arguments hodnoty vlastností, které se mají jako argumenty příkazového řádku předat otevřené proceduře souboru. Pokud například ve vlastnosti zadáte aplikaci textového editoru FileName , můžete vlastnost použít Arguments k určení textového souboru, který má editor otevřít.

Standardním vstupem je obvykle klávesnice a standardním výstupem a standardní chybou je obvykle obrazovka monitoru. Pomocí vlastností , RedirectStandardOutputa RedirectStandardError však můžete RedirectStandardInputzpůsobit, že proces získá vstup z souboru nebo jiného zařízení nebo vrátí výstup do souboru nebo jiného zařízení. Pokud u komponenty použijete StandardInputvlastnosti Process , StandardOutputnebo StandardError , musíte nejprve nastavit odpovídající hodnotu vlastnosti ProcessStartInfo . V opačném případě systém vyvolá výjimku při čtení nebo zápisu do datového proudu.

UseShellExecute Nastavením vlastnosti určete, jestli se má proces spustit pomocí prostředí operačního systému. Pokud UseShellExecute je nastavená hodnota false, zdědí nový proces standardní vstupní, standardní výstup a standardní chybový datový proud volajícího procesu, pokud RedirectStandardInputvlastnosti , RedirectStandardOutputnebo RedirectStandardError nejsou nastavené na truehodnotu .

Až do zahájení procesu můžete změnit hodnotu libovolné ProcessStartInfo vlastnosti. Po zahájení procesu nemá změna těchto hodnot žádný vliv.

Důležité

Použití instance tohoto objektu s nedůvěryhodnými daty představuje bezpečnostní riziko. Tento objekt používejte pouze s důvěryhodnými daty. Další informace najdete 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í s úplným vztahem důvěryhodnosti. Podrobnosti o požadavcích na zabezpečení najdete v tématu Požadavky propojení.

Konstruktory

ProcessStartInfo()	Inicializuje novou instanci ProcessStartInfo třídy bez zadání názvu souboru, se kterým se má proces zahájit.
ProcessStartInfo(String)	Inicializuje novou instanci ProcessStartInfo třídy a určuje název souboru, jako je například aplikace nebo dokument, se kterým se má proces zahájit.
ProcessStartInfo(String, IEnumerable<String>)	Určuje sadu hodnot, které se použijí při spuštění procesu.
ProcessStartInfo(String, String)	Inicializuje novou instanci ProcessStartInfo třídy, určuje název souboru aplikace, se kterým se má proces zahájit, a určuje sadu argumentů příkazového řádku, které se mají předat aplikaci.

Vlastnosti

ArgumentList	Získá kolekci argumentů příkazového řádku použít při spuštění aplikace. Řetězce přidané do seznamu nemusí být dříve uváděné řídicím znakem.
Arguments	Získá nebo nastaví sadu argumentů příkazového řádku použít při spuštění aplikace.
CreateNoWindow	Získá nebo nastaví hodnotu označující, zda spustit proces v novém okně.
Domain	Získá nebo nastaví hodnotu, která identifikuje doménu použít při spuštění procesu. Pokud je nulltato hodnota , musí být vlastnost zadána UserName ve formátu hlavního názvu uživatele (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 označující, zda se uživateli zobrazí dialogové okno chyby, pokud proces nelze spustit.
ErrorDialogParentHandle	Získá nebo nastaví popisovač okna použít, pokud je zobrazena chyba dialogové okno pro proces, který nelze spustit.
FileName	Získá nebo nastaví aplikaci nebo dokument ke spuštění.
LoadUserProfile	Získá nebo nastaví hodnotu, která označuje, zda profil uživatele systému Windows má být načten z registru.
Password	Získá nebo nastaví zabezpečený řetězec, který obsahuje heslo uživatele použít při spuštění procesu.
PasswordInClearText	Získá nebo nastaví heslo uživatele ve formátu nesmazatelný text, 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 označující, zda vstup pro aplikaci je 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	Určuje sadu hodnot, které se použijí při spuštění procesu.
UserName	Získá nebo nastaví uživatelské jméno pro použití při spuštění procesu. Pokud používáte formát hlavního názvu uživatele (DomainUPN),DNS_domain_name@user musí být nullvlastnost .
UseShellExecute	Získá nebo nastaví hodnotu označ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ého FileName vlastností.
Verbs	Získá sadu sloves přidružených k typu souboru určenému FileName vlastností .
WindowStyle	Získá nebo nastaví stav okna, který se má použít při spuštění procesu.
WorkingDirectory	UseShellExecute Když je falsevlastnost , získá nebo nastaví pracovní adresář pro proces, který se má spustit. Když UseShellExecute je true, získá nebo nastaví adresář, který obsahuje proces, který se má spustit.

Metody

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

Viz také

• Process