ProcessStartInfo Osztály

Definíció

Névtér:

System.Diagnostics

Szerelvények:

netstandard.dll, System.Diagnostics.Process.dll

Forrás:

ProcessStartInfo.cs

A folyamat indításakor használt értékkészletet adja meg.

public ref class ProcessStartInfo sealed

public sealed class ProcessStartInfo

type ProcessStartInfo = class

Public NotInheritable Class ProcessStartInfo

Öröklődés

Object

ProcessStartInfo

Példák

Az alábbi példakód bemutatja, hogyan indíthatja el a Internet Explorer a ProcessStartInfo osztályt. A cél URL-címek argumentumként ProcessStartInfo vannak megadva.

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

Megjegyzések

ProcessStartInfo a rendszer az Process összetevővel együtt használja. Amikor elindít egy folyamatot az Process osztály használatával, a futó folyamathoz csatolva a rendelkezésre álló adatokon kívül a folyamat adataihoz is hozzáférhet.

Az osztály segítségével ProcessStartInfo jobban szabályozhatja a folyamatot. Legalább manuálisan vagy a FileName konstruktor használatával kell beállítania a tulajdonságot. A fájlnév bármely alkalmazás vagy dokumentum. Itt egy dokumentum olyan fájltípusként van definiálva, amelyhez egy megnyitott vagy alapértelmezett művelet van társítva. A regisztrált fájltípusokat és a számítógéphez társított alkalmazásokat a Mappabeállítások párbeszédpanelen tekintheti meg, amely az operációs rendszeren keresztül érhető el. A Speciális gomb egy párbeszédpanelhez vezet, amely bemutatja, hogy van-e nyitott művelet egy adott regisztrált fájltípushoz társítva.

Emellett más tulajdonságokat is beállíthat, amelyek meghatározzák a fájllal végrehajtandó műveleteket. Megadhat egy értéket, amely a tulajdonság tulajdonságának FileName típusára vonatkozik Verb . Megadhat például "nyomtatást" egy dokumentumtípushoz. Emellett megadhatja Arguments , hogy a tulajdonságértékek parancssori argumentumokként legyenek átadva a fájl nyílt eljárásának. Ha például egy szövegszerkesztő alkalmazást ad meg a FileName tulajdonságban, a Arguments tulajdonság használatával megadhatja a szerkesztő által megnyitni kívánt szövegfájlt.

A standard bemenet általában a billentyűzet, a szabványos kimenet és a standard hiba pedig általában a monitor képernyője. A , RedirectStandardInputés RedirectStandardOutput tulajdonságok használatával RedirectStandardErrorazonban a folyamat bemenetet kérhet le, vagy kimenetet adhat vissza egy fájlhoz vagy más eszközhöz. Ha az StandardInputösszetevő , StandardOutputvagy StandardError tulajdonságokat Process használja, először be kell állítania a megfelelő értéket a ProcessStartInfo tulajdonságon. Ellenkező esetben a rendszer kivételt jelez a stream olvasása vagy írása során.

A tulajdonság beállításával UseShellExecute megadhatja, hogy az operációs rendszerhéj használatával indítsa-e el a folyamatot. Ha UseShellExecute be van állítva false, az új folyamat örökli a hívási folyamat szabványos bemenetét, standard kimenetét és szabványos hibafolyamait, kivéve, ha a RedirectStandardInput, RedirectStandardOutputvagy RedirectStandardError tulajdonságok trueértéke .

Bármely ProcessStartInfo tulajdonság értékét módosíthatja a folyamat kezdetének időpontjáig. A folyamat elindítása után ezeknek az értékeknek a módosítása nincs hatással.

Important

Az ilyen típusú példányok nem megbízható adatokkal való használata biztonsági kockázatot jelent. Ezt az objektumot csak megbízható adatokkal használja. További információ: Minden bemenet ellenőrzése.

Note

Ez az osztály az összes tagra vonatkozó hivatkozási igényt tartalmaz az osztály szintjén. Az A SecurityException akkor jön létre, ha az azonnali hívó nem rendelkezik teljes megbízhatósági engedéllyel. A biztonsági követelményekkel kapcsolatos részletekért tekintse meg a Hivatkozási igények című témakört.

Konstruktorok

Name	Description
ProcessStartInfo()	Inicializálja az ProcessStartInfo osztály új példányát anélkül, hogy megad egy fájlnevet, amellyel elindíthatja a folyamatot.
ProcessStartInfo(String, IEnumerable<String>)	Inicializálja az ProcessStartInfo osztály új példányát, és megadja az elindítandó alkalmazás nevét, valamint az alkalmazásnak átadni kívánt parancssori argumentumokat.
ProcessStartInfo(String, String)	Inicializálja az osztály új példányát, megadja az ProcessStartInfo alkalmazás fájlnevét, amellyel elindíthatja a folyamatot, és megadja az alkalmazásnak továbbítandó parancssori argumentumokat.
ProcessStartInfo(String)	Inicializálja az ProcessStartInfo osztály új példányát, és megad egy fájlnevet, például egy alkalmazást vagy dokumentumot, amellyel a folyamatot el szeretné indítani.

Tulajdonságok

Name	Description
ArgumentList	Lekéri az alkalmazás indításakor használandó parancssori argumentumok gyűjteményét. A listához hozzáadott sztringeket nem kell korábban kimenekíteni.
Arguments	Lekéri vagy beállítja az alkalmazás indításakor használni kívánt parancssori argumentumokat.
CreateNewProcessGroup	Beolvas vagy beállít egy értéket, amely jelzi, hogy egy új folyamatcsoportban szeretné-e elindítani a folyamatot.
CreateNoWindow	Lekéri vagy beállítja azt az értéket, amely jelzi, hogy a folyamatot egy új ablakban kell-e elindítani.
Domain	Lekéri vagy beállít egy értéket, amely azonosítja a folyamat indításakor használni kívánt tartományt. Ha ez az nullérték, a UserName tulajdonságot UPN formátumban kell megadni.
Environment	Lekéri az erre a folyamatra és a gyermekfolyamatokra vonatkozó környezeti változókat.
EnvironmentVariables	Lekéri a fájlok keresési útvonalait, az ideiglenes fájlok könyvtárait, az alkalmazásspecifikus beállításokat és más hasonló információkat.
ErrorDialog	Beolvas vagy beállít egy értéket, amely jelzi, hogy megjelenik-e hibaablak a felhasználó számára, ha a folyamat nem indítható el.
ErrorDialogParentHandle	Lekéri vagy beállítja az ablakleírót, ha egy nem indítható folyamathoz hiba párbeszédpanel jelenik meg.
FileName	Lekéri vagy beállítja az alkalmazást vagy a dokumentumot az indításhoz.
LoadUserProfile	Lekéri vagy beállít egy értéket, amely jelzi, hogy a Windows felhasználói profilt be kell-e tölteni a beállításjegyzékből.
Password	Lekéri vagy beállít egy biztonságos sztringet, amely tartalmazza a folyamat indításakor használni kívánt felhasználói jelszót.
PasswordInClearText	Lekéri vagy beállítja a felhasználói jelszót a folyamat indításakor használandó tiszta szövegben.
RedirectStandardError	Lekéri vagy beállít egy értéket, amely jelzi, hogy egy alkalmazás hibakimenete a StandardError streambe van-e írva.
RedirectStandardInput	Lekéri vagy beállít egy értéket, amely jelzi, hogy az alkalmazás bemenete beolvasva van-e a StandardInput streamből.
RedirectStandardOutput	Lekéri vagy beállít egy értéket, amely jelzi, hogy az alkalmazás szöveges kimenete a StandardOutput streambe van-e írva.
StandardErrorEncoding	Lekéri vagy beállítja a hibakimenethez előnyben részesített kódolást.
StandardInputEncoding	Lekéri vagy beállítja a standard bemenethez előnyben részesített kódolást.
StandardOutputEncoding	Lekéri vagy beállítja a standard kimenethez előnyben részesített kódolást.
UseCredentialsForNetworkingOnly	Lekéri vagy beállít egy értéket, amely jelzi, hogy a felhasználói hitelesítő adatok csak hálózati erőforrásokhoz vannak-e használva.
UserName	Lekéri vagy beállítja a felhasználónév használatát a folyamat indításakor. Ha UPN formátumot használ, user@DNS_domain_namea tulajdonságnak meg Domain kell lennie null.
UseShellExecute	Lekéri vagy beállít egy értéket, amely jelzi, hogy az operációs rendszerhéjat kell-e használni a folyamat elindításához.
Verb	Lekéri vagy beállítja a tulajdonság által megadott alkalmazás vagy dokumentum megnyitásakor használni kívánt igét FileName .
Verbs	Lekéri a tulajdonság által megadott fájltípushoz társított igék készletét FileName .
WindowStyle	Lekéri vagy beállítja a folyamat indításakor használni kívánt ablakállapotot.
WorkingDirectory	Ha a UseShellExecute tulajdonság értéke, falselekéri vagy beállítja a folyamat indításához szükséges munkakönyvtárat. Ha UseShellExecute igen true, lekéri vagy beállítja az elindítandó folyamatot tartalmazó könyvtárat.

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• Process