Process.Start (Método) (String, String, String, SecureString, String) (System.Diagnostics)

Start (Método) (String, String, Str...

Contraer todo

Filtro de lenguage

Esta página es específica de

Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:

Biblioteca de clases de .NET Framework

Process.Start (Método) (String, String, String, SecureString, String)

Nota: este método es nuevo en la versión 2.0 de .NET Framework.

Inicia un recurso de proceso mediante la especificación del nombre de una aplicación y un conjunto de argumentos de línea de comandos, un nombre de usuario, una contraseña y un dominio, y asocia el recurso a un nuevo componente de Process.

Espacio de nombres: System.Diagnostics
Ensamblado: System (en system.dll)

Sintaxis

Visual Basic (Declaración)

Public Shared Function Start ( _
    fileName As String, _
    arguments As String, _
    userName As String, _
    password As SecureString, _
    domain As String _
) As Process

Visual Basic (Uso)

Dim fileName As String
Dim arguments As String
Dim userName As String
Dim password As SecureString
Dim domain As String
Dim returnValue As Process

returnValue = Process.Start(fileName, arguments, userName, password, domain)

public static Process Start (
    string fileName,
    string arguments,
    string userName,
    SecureString password,
    string domain
)

C++

public:
static Process^ Start (
    String^ fileName, 
    String^ arguments, 
    String^ userName, 
    SecureString^ password, 
    String^ domain
)

public static Process Start (
    String fileName, 
    String arguments, 
    String userName, 
    SecureString password, 
    String domain
)

JScript

public static function Start (
    fileName : String, 
    arguments : String, 
    userName : String, 
    password : SecureString, 
    domain : String
) : Process

Parámetros

fileName: Nombre de un archivo de aplicación que se va a ejecutar en el proceso.

arguments: Argumentos de línea de comandos que se van a pasar al iniciar el proceso.

userName: Nombre de usuario que se va a utilizar al iniciarse el proceso.

password: SecureString que contiene la contraseña que se va a utilizar al iniciarse el proceso.

domain: Dominio que se va a utilizar al iniciarse el proceso.

Valor devuelto

Nuevo componente Process que se asocia al recurso del proceso o referencia de objeto null (Nothing en Visual Basic) si no se inicia ningún recurso de proceso (por ejemplo, si se reutiliza un proceso existente).

Excepciones

Tipo de excepción	Condición
InvalidOperationException	No se ha especificado ningún nombre de archivo.
Win32Exception	fileName no es un archivo ejecutable (.exe).
Win32Exception	Se produjo un error al abrir el archivo asociado.
ObjectDisposedException	El objeto de proceso ya se ha desechado.

Comentarios

Utilice esta sobrecarga para crear un nuevo proceso y su subproceso principal especificando el nombre de archivo, los argumentos de la línea de comandos, el nombre de usuario, la contraseña y el dominio. El nuevo proceso ejecutará el archivo ejecutable especificado en el contexto de seguridad de las credenciales especificadas (usuario, dominio y contraseña). La sobrecarga asocia el recurso a un nuevo componente Process. Si el proceso ya está en ejecución, no se iniciará ningún recurso de proceso adicional. En lugar de esto, se reutiliza el recurso de proceso existente y no se crea un nuevo componente Process. En tal caso, en lugar de devolver un nuevo componente Process, Start devuelve referencia de objeto null (Nothing en Visual Basic) al procedimiento que realiza la llamada.

Esta sobrecarga permite iniciar un proceso sin crear primero una nueva instancia de Process. La sobrecarga es una alternativa a los pasos explícitos para crear una nueva instancia de Process, establecer las propiedades FileName, Arguments, UserName, Password y Domain de la propiedad StartInfo y llamar a Start para la instancia de Process.

Del mismo modo que el cuadro de diálogo Ejecutar acepta un nombre de archivo ejecutable con y sin extensión .exe, la extensión .exe es opcional en el parámetro fileName. Por ejemplo, se puede establecer el parámetro fileName en "Notepad.exe" o "Notepad". Si el parámetro fileName representa un archivo ejecutable, el parámetro arguments podría representar un archivo sobre el que se va a actuar como, por ejemplo, el archivo de texto de Notepad.exe myfile.txt.

Nota
El nombre de archivo debe representar un archivo ejecutable en las sobrecargas Start que tienen los parámetros userName, password y domain.

Seguridad de .NET Framework

SecurityPermission para llamar a los miembros de Process. Valor de la petición: LinkDemand; Conjuntos de permisos con nombre: FullTrust.

Plataformas

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

Información de versión

.NET Framework

Compatible con: 2.0

Vea también

Referencia

Process (Clase)
Process (Miembros)
System.Diagnostics (Espacio de nombres)

Etiquetas

: Agregar una etiqueta

Contenido de la comunidad

Agregar contenido nuevo

Anotaciones

Administre su perfil | MSDN Flash en Español | Contacto | Aviso legal