ProcessStartInfo Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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 |
| 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, |
| 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 |
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) |