ProcessStartInfo Klas

Definitie

Specificeert een set waarden die worden gebruikt wanneer u een proces start.

public ref class ProcessStartInfo sealed
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class ProcessStartInfo
public sealed class ProcessStartInfo
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))>]
type ProcessStartInfo = class
type ProcessStartInfo = class
Public NotInheritable Class ProcessStartInfo
Overname
ProcessStartInfo
Kenmerken

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de klasse ProcessStartInfo gebruikt om Internet Explorer te starten. De doel-URL's worden opgegeven als ProcessStartInfo argumenten.

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

Opmerkingen

ProcessStartInfo wordt samen met het Process onderdeel gebruikt. Wanneer u een proces start met behulp van de Process klasse, hebt u toegang tot het verwerken van informatie, naast het proces dat beschikbaar is bij het koppelen aan een actief proces.

U kunt de ProcessStartInfo klasse gebruiken voor betere controle over het proces dat u start. U moet de FileName eigenschap ten minste handmatig instellen of de constructor gebruiken. De bestandsnaam is een toepassing of document. Hier wordt een document gedefinieerd als elk bestandstype waaraan een geopende of standaardactie is gekoppeld. U kunt geregistreerde bestandstypen en de bijbehorende toepassingen voor uw computer weergeven met behulp van het dialoogvenster Mapopties , dat beschikbaar is via het besturingssysteem. De knop Geavanceerd leidt naar een dialoogvenster waarin wordt weergegeven of er een geopende actie is gekoppeld aan een specifiek geregistreerd bestandstype.

Daarnaast kunt u andere eigenschappen instellen waarmee acties worden gedefinieerd die met dat bestand moeten worden uitgevoerd. U kunt een waarde opgeven die specifiek is voor het type FileName eigenschap voor de Verb eigenschap. U kunt bijvoorbeeld 'afdrukken' opgeven voor een documenttype. Daarnaast kunt u eigenschapswaarden opgeven Arguments als opdrachtregelargumenten om door te geven aan de geopende procedure van het bestand. Als u bijvoorbeeld een teksteditortoepassing in de FileName eigenschap opgeeft, kunt u de Arguments eigenschap gebruiken om een tekstbestand op te geven dat door de editor moet worden geopend.

Standaardinvoer is meestal het toetsenbord en standaarduitvoer en standaardfout zijn meestal het monitorscherm. U kunt echter de RedirectStandardInput, RedirectStandardOutputen RedirectStandardError eigenschappen gebruiken om ervoor te zorgen dat het proces invoer krijgt van of uitvoer retourneert naar een bestand of ander apparaat. Als u de StandardInput, StandardOutputof StandardError eigenschappen van het Process onderdeel gebruikt, moet u eerst de bijbehorende waarde voor de ProcessStartInfo eigenschap instellen. Anders genereert het systeem een uitzondering wanneer u naar de stream leest of schrijft.

Stel de UseShellExecute eigenschap in om op te geven of het proces moet worden gestart met behulp van de shell van het besturingssysteem. Als UseShellExecute dit is ingesteld falseop, neemt het nieuwe proces de standaardinvoer, standaarduitvoer en standaardfoutstromen van het aanroepende proces over, tenzij respectievelijk de RedirectStandardInput, RedirectStandardOutputof RedirectStandardError eigenschappen zijn ingesteld op true.

U kunt de waarde van elke ProcessStartInfo eigenschap wijzigen tot het moment dat het proces wordt gestart. Nadat u het proces hebt gestart, heeft het wijzigen van deze waarden geen effect.

Important

Het gebruik van een exemplaar van dit type met niet-vertrouwde gegevens is een beveiligingsrisico. Gebruik dit object alleen met vertrouwde gegevens. Zie Alle invoergegevens validerenvoor meer informatie.

Note

Deze klasse bevat een koppelingsvraag op klasseniveau die van toepassing is op alle leden. Er SecurityException wordt een gegenereerd wanneer de directe beller geen machtiging voor volledig vertrouwen heeft. Zie Koppelingsvereisten voor meer informatie over beveiligingsvereisten.

Constructors

Name Description
ProcessStartInfo()

Initialiseert een nieuw exemplaar van de ProcessStartInfo klasse zonder een bestandsnaam op te geven waarmee het proces moet worden gestart.

ProcessStartInfo(String, String)

Initialiseert een nieuw exemplaar van de ProcessStartInfo klasse, geeft een naam op voor het toepassingsbestand waarmee het proces moet worden gestart en geeft een set opdrachtregelargumenten op die aan de toepassing moeten worden doorgegeven.

ProcessStartInfo(String)

Initialiseert een nieuw exemplaar van de ProcessStartInfo klasse en geeft een bestandsnaam op, zoals een toepassing of document waarmee het proces moet worden gestart.

Eigenschappen

Name Description
ArgumentList

Hiermee haalt u een verzameling opdrachtregelargumenten op die moeten worden gebruikt bij het starten van de toepassing. Tekenreeksen die zijn toegevoegd aan de lijst hoeven niet eerder te worden ontsnapt.

Arguments

Hiermee haalt u de set opdrachtregelargumenten op die moeten worden gebruikt bij het starten van de toepassing.

CreateNoWindow

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het proces in een nieuw venster moet worden gestart.

Domain

Hiermee wordt een waarde opgehaald of ingesteld waarmee het domein wordt geïdentificeerd dat moet worden gebruikt bij het starten van het proces. Als deze waarde is null, moet de UserName eigenschap worden opgegeven in UPN-indeling.

Environment

Haalt de omgevingsvariabelen op die van toepassing zijn op dit proces en de onderliggende processen.

EnvironmentVariables

Hiermee worden zoekpaden opgehaald voor bestanden, mappen voor tijdelijke bestanden, toepassingsspecifieke opties en andere vergelijkbare informatie.

ErrorDialog

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of er een foutdialoogvenster wordt weergegeven aan de gebruiker als het proces niet kan worden gestart.

ErrorDialogParentHandle

Hiermee haalt u de venstergreep op die moet worden gebruikt wanneer een foutdialoogvenster wordt weergegeven voor een proces dat niet kan worden gestart.

FileName

Hiermee haalt u de toepassing of het document op om te starten.

LoadUserProfile

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het Windows gebruikersprofiel moet worden geladen vanuit het register.

Password

Hiermee haalt u een beveiligde tekenreeks op die het gebruikerswachtwoord bevat dat moet worden gebruikt bij het starten van het proces.

PasswordInClearText

Hiermee haalt u het gebruikerswachtwoord op in duidelijke tekst die moet worden gebruikt bij het starten van het proces.

RedirectStandardError

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de foutuitvoer van een toepassing naar de StandardError stream wordt geschreven.

RedirectStandardInput

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de invoer voor een toepassing wordt gelezen uit de StandardInput stream.

RedirectStandardOutput

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de tekstuele uitvoer van een toepassing naar de StandardOutput stream wordt geschreven.

StandardErrorEncoding

Hiermee haalt u de voorkeurscodering op of stelt u deze in voor foutuitvoer.

StandardInputEncoding

Hiermee haalt u de voorkeurscodering op of stelt u deze in voor standaardinvoer.

StandardOutputEncoding

Hiermee haalt u de voorkeurscodering op of stelt u deze in voor standaarduitvoer.

UserName

Hiermee haalt u de gebruikersnaam op die moet worden gebruikt bij het starten van het proces. Als u de UPN-indeling gebruikt, user@DNS_domain_namemoet de Domain eigenschap zijn null.

UseShellExecute

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de shell van het besturingssysteem moet worden gebruikt om het proces te starten.

Verb

Hiermee haalt u het werkwoord op dat moet worden gebruikt bij het openen van de toepassing of het document dat is opgegeven door de FileName eigenschap.

Verbs

Hiermee haalt u de set werkwoorden op die zijn gekoppeld aan het type bestand dat is opgegeven door de FileName eigenschap.

WindowStyle

Hiermee wordt de vensterstatus opgevraagd of ingesteld voor gebruik wanneer het proces wordt gestart.

WorkingDirectory

Wanneer de UseShellExecute eigenschap is false, haalt of stelt u de werkmap in voor het proces dat moet worden gestart. Wanneer UseShellExecute is true, haalt of stelt u de map in die het proces bevat dat moet worden gestart.

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook