ProcessStartInfo Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica um conjunto de valores que são utilizados quando inicia um processo.
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
- Herança
-
ProcessStartInfo
- Atributos
Exemplos
O exemplo de código seguinte demonstra como usar a classe ProcessStartInfo para iniciar Internet Explorer. Os URLs de destino são fornecidos como ProcessStartInfo argumentos.
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
Observações
ProcessStartInfo é usado em conjunto com o Process componente. Quando inicia um processo usando a Process classe, tem acesso à informação do processo além da disponível ao anexar a um processo em execução.
Podes usar a ProcessStartInfo disciplina para teres melhor controlo sobre o processo que começas. Deves pelo menos definir a FileName propriedade, seja manualmente ou usando o construtor. O nome do ficheiro é qualquer candidatura ou documento. Aqui, um documento é definido como qualquer tipo de ficheiro que tenha uma ação aberta ou padrão associada. Pode visualizar os tipos de ficheiros registados e as suas aplicações associadas para o seu computador usando a caixa de diálogo Opções de Pasta , que está disponível através do sistema operativo. O botão Avançado leva a uma caixa de diálogo que mostra se existe uma ação aberta associada a um tipo específico de ficheiro registado.
Além disso, podes definir outras propriedades que definem ações a realizar com esse ficheiro. Pode especificar um valor específico para o tipo de FileName propriedade da Verb propriedade. Por exemplo, pode especificar "imprimir" para um tipo de documento. Além disso, pode especificar Arguments valores de propriedade como argumentos de linha de comandos para passar ao procedimento aberto do ficheiro. Por exemplo, se especificar uma aplicação de editor de texto na FileName propriedade, pode usar essa Arguments propriedade para especificar um ficheiro de texto a ser aberto pelo editor.
A entrada padrão é geralmente o teclado, e a saída padrão e o erro padrão são normalmente o ecrã do monitor. No entanto, pode usar as RedirectStandardInputpropriedades , RedirectStandardOutput, e RedirectStandardError para fazer com que o processo receba entrada ou retorne a saída para um ficheiro ou outro dispositivo. Se usar , StandardInputStandardOutput, ou StandardError propriedades no Process componente, deve primeiro definir o valor correspondente na ProcessStartInfo propriedade. Caso contrário, o sistema lança uma exceção quando lê ou escreve no fluxo.
Defina a UseShellExecute propriedade para especificar se deve iniciar o processo usando o shell do sistema operativo. Se UseShellExecute for definido como false, o novo processo herda os fluxos padrão de entrada, saída padrão e erro padrão do processo chamador, a menos que as RedirectStandardInputpropriedades , RedirectStandardOutput, ou RedirectStandardError as propriedades, respetivamente, estejam definidas para true.
Pode alterar o valor de qualquer ProcessStartInfo propriedade até ao início do processo. Depois de iniciar o processo, alterar esses valores não tem efeito.
Importante
Utilizar uma instância deste tipo com dados não confiáveis é um risco de segurança. Use este objeto apenas com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.
Note
Esta classe contém uma exigência de ligação ao nível da classe que se aplica a todos os membros. A SecurityException é lançado quando o chamador imediato não tem permissão de confiança total. Para obter detalhes sobre requisitos de segurança, consulte Exigências de Link.
Construtores
| Name | Description |
|---|---|
| ProcessStartInfo() |
Inicializa uma nova instância da ProcessStartInfo classe sem especificar um nome de ficheiro para iniciar o processo. |
| ProcessStartInfo(String, String) |
Inicializa uma nova instância da ProcessStartInfo classe, especifica um nome de ficheiro de aplicação com o qual iniciar o processo e especifica um conjunto de argumentos de linha de comandos para passar à aplicação. |
| ProcessStartInfo(String) |
Inicializa uma nova instância da ProcessStartInfo classe e especifica um nome de ficheiro, como uma aplicação ou documento com o qual iniciar o processo. |
Propriedades
| Name | Description |
|---|---|
| ArgumentList |
Obtém uma coleção de argumentos de linha de comandos para usar ao iniciar a aplicação. Os fios adicionados à lista não precisam de ser eliminados anteriormente. |
| Arguments |
Obtém ou define o conjunto de argumentos de linha de comandos a usar ao iniciar a aplicação. |
| CreateNoWindow |
Recebe ou define um valor que indica se deve iniciar o processo numa nova janela. |
| Domain |
Recebe ou define um valor que identifica o domínio a usar no início do processo. Se este valor for |
| Environment |
Obtém as variáveis de ambiente que se aplicam a este processo e aos seus processos filhos. |
| EnvironmentVariables |
Obtém caminhos de pesquisa para ficheiros, diretórios para ficheiros temporários, opções específicas da aplicação e outras informações semelhantes. |
| ErrorDialog |
Recebe ou define um valor que indica se uma caixa de diálogo de erro é apresentada ao utilizador caso o processo não possa ser iniciado. |
| ErrorDialogParentHandle |
Obtém ou define o handle da janela para usar quando aparece uma caixa de diálogo de erro para um processo que não pode ser iniciado. |
| FileName |
Recebe ou define a candidatura ou documento para começar. |
| LoadUserProfile |
Recebe ou define um valor que indica se o perfil de utilizador do Windows deve ser carregado a partir do registo. |
| Password |
Obtém ou define uma string segura que contém a palavra-passe do utilizador para usar no início do processo. |
| PasswordInClearText |
Obtém ou define a palavra-passe do utilizador em texto claro para usar ao iniciar o processo. |
| RedirectStandardError |
Obtém ou define um valor que indica se o erro de saída de uma aplicação está escrito no StandardError fluxo. |
| RedirectStandardInput |
Recebe ou define um valor que indica se a entrada de uma aplicação é lida do StandardInput fluxo. |
| RedirectStandardOutput |
Obtém ou define um valor que indica se a saída textual de uma aplicação está escrita StandardOutput no fluxo. |
| StandardErrorEncoding |
Obtém ou define a codificação preferida para a saída de erro. |
| StandardInputEncoding |
Obtém ou define a codificação preferida para entrada padrão. |
| StandardOutputEncoding |
Obtém ou define a codificação preferida para a saída padrão. |
| UserName |
Obtém ou define o nome de utilizador a usar ao iniciar o processo. Se usar o formato UPN, |
| UseShellExecute |
Recebe ou define um valor que indica se deve usar a shell do sistema operativo para iniciar o processo. |
| Verb |
Obtém ou define o verbo a usar ao abrir a aplicação ou documento especificado pela FileName propriedade. |
| Verbs |
Obtém o conjunto de verbos associados ao tipo de ficheiro especificado pela FileName propriedade. |
| WindowStyle |
Recebe ou define o estado da janela para usar quando o processo é iniciado. |
| WorkingDirectory |
Quando a UseShellExecute propriedade é |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |