Sdílet prostřednictvím


ProcessStartInfo Třída

Definice

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

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
Dědičnost
ProcessStartInfo
Atributy

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í vstup je obvykle klávesnice a standardní výstup a standardní chyba jsou 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 spustit, 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 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 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)

Platí pro

Viz také