ProcessStartInfo Sınıf

Tanım

Bir işlemi başlattığınızda kullanılan bir değer kümesi belirtir.Specifies a set of values that are used when you start a process.

public ref class ProcessStartInfo sealed
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ExpandableObjectConverter))]
public sealed class ProcessStartInfo
type ProcessStartInfo = class
Public NotInheritable Class ProcessStartInfo
Devralma
ProcessStartInfo
Öznitelikler

Örnekler

Aşağıdaki kod örneği, Internet Explorer 'ı başlatmak için ProcessStartInfo sınıfının nasıl kullanılacağını gösterir ve hedef URL 'Leri ProcessStartInfo bağımsız değişken olarak sağlar.The following code example demonstrates how to use the ProcessStartInfo class to start Internet Explorer, providing the destination URLs as ProcessStartInfo arguments.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

// 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()
{
    // 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");
}

// Uses the ProcessStartInfo class to start new processes,
// both in a minimized mode.
void OpenWithStartInfo()
{
    ProcessStartInfo^ startInfo = gcnew ProcessStartInfo("IExplore.exe");
    startInfo->WindowStyle = ProcessWindowStyle::Minimized;
    Process::Start(startInfo);
    startInfo->Arguments = "www.northwindtraders.com";
    Process::Start(startInfo);
}

int main()
{
    // Get the path that stores favorite links.
    String^ myFavoritesPath = Environment::GetFolderPath(Environment::SpecialFolder::Favorites);
    OpenApplication(myFavoritesPath);
    OpenWithArguments();
    OpenWithStartInfo();
}
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

Açıklamalar

ProcessStartInfo, Process bileşeniyle birlikte kullanılır.ProcessStartInfo is used together with the Process component. Process sınıfını kullanarak bir işlem başlattığınızda, çalışan bir işleme eklenirken bu bilgilere ek olarak işleme bilgilerine de erişebilirsiniz.When you start a process using the Process class, you have access to process information in addition to that available when attaching to a running process.

Başlattığınız işlem üzerinde daha iyi denetim için ProcessStartInfo sınıfını kullanabilirsiniz.You can use the ProcessStartInfo class for better control over the process you start. FileName özelliğini, el ile ya da oluşturucuyu kullanarak ayarlamanız gerekir.You must at least set the FileName property, either manually or using the constructor. Dosya adı herhangi bir uygulama veya belgedir.The file name is any application or document. Burada bir belge, kendisiyle ilişkili açık veya varsayılan bir eyleme sahip herhangi bir dosya türü olarak tanımlanmıştır.Here a document is defined to be any file type that has an open or default action associated with it. Bilgisayarınızda kayıtlı dosya türlerini ve bunlarla ilişkili uygulamaları, işletim sistemi aracılığıyla kullanılabilen klasör seçenekleri iletişim kutusunu kullanarak görüntüleyebilirsiniz.You can view registered file types and their associated applications for your computer by using the Folder Options dialog box, which is available through the operating system. Gelişmiş düğmesi, belirli bir kayıtlı dosya türüyle ilişkili açık bir eylem olup olmadığını gösteren bir iletişim kutusuna yol açar.The Advanced button leads to a dialog box that shows whether there is an open action associated with a specific registered file type.

Ayrıca, bu dosyayla gerçekleştirilecek eylemleri tanımlayan diğer özellikleri de ayarlayabilirsiniz.In addition, you can set other properties that define actions to take with that file. Verb özelliği için FileName özelliğinin türüne özgü bir değer belirtebilirsiniz.You can specify a value specific to the type of the FileName property for the Verb property. Örneğin, bir belge türü için "Yazdır" seçeneğini belirleyebilirsiniz.For example, you can specify "print" for a document type. Ayrıca, dosyanın açma yordamına geçirilecek Arguments özellik değerlerini komut satırı bağımsız değişkenleri olacak şekilde belirtebilirsiniz.Additionally, you can specify Arguments property values to be command-line arguments to pass to the file's open procedure. Örneğin, FileName özelliğinde bir metin düzenleyici uygulaması belirtirseniz, düzenleyici tarafından açılacak bir metin dosyası belirtmek için Arguments özelliğini kullanabilirsiniz.For example, if you specify a text editor application in the FileName property, you can use the Arguments property to specify a text file to be opened by the editor.

Standart giriş genellikle klavyedir ve standart çıktı ve standart hata genellikle izleyici ekranıdır.Standard input is usually the keyboard, and standard output and standard error are usually the monitor screen. Ancak, RedirectStandardInput, RedirectStandardOutputve RedirectStandardError özelliklerini kullanarak işlemin bir dosya veya başka bir cihazdan giriş veya çıkış almasını sağlayabilirsiniz.However, you can use the RedirectStandardInput, RedirectStandardOutput, and RedirectStandardError properties to cause the process to get input from or return output to a file or other device. Process bileşeninde StandardInput, StandardOutputveya StandardError özelliklerini kullanırsanız, önce ProcessStartInfo özelliğinde karşılık gelen değeri ayarlamanız gerekir.If you use the StandardInput, StandardOutput, or StandardError properties on the Process component, you must first set the corresponding value on the ProcessStartInfo property. Aksi takdirde, akış okuduğunuzda veya akışa yazdığınızda sistem bir özel durum oluşturur.Otherwise, the system throws an exception when you read or write to the stream.

İşlemin işletim sistemi kabuğu kullanılarak başlatılıp başlatılmayacağını belirtmek için UseShellExecute özelliğini ayarlayın.Set the UseShellExecute property to specify whether to start the process by using the operating system shell. UseShellExecute falseolarak ayarlanırsa, yeni işlem sırasıyla RedirectStandardInput, RedirectStandardOutputveya RedirectStandardError özellikleri trueolarak ayarlanmadığı sürece, çağıran işlemin standart giriş, standart çıkış ve standart hata akışlarını devralır.If UseShellExecute is set to false, the new process inherits the standard input, standard output, and standard error streams of the calling process, unless the RedirectStandardInput, RedirectStandardOutput, or RedirectStandardError properties, respectively, are set to true.

Herhangi bir ProcessStartInfo özelliğinin değerini, işlemin başladığı saate kadar değiştirebilirsiniz.You can change the value of any ProcessStartInfo property up to the time that the process starts. İşlemi başlattıktan sonra, bu değerlerin değiştirilmesinin etkisi olmaz.After you start the process, changing these values has no effect.

Not

Bu sınıf, tüm Üyeler için geçerli olan sınıf düzeyinde bir bağlantı talebi içerir.This class contains a link demand at the class level that applies to all members. Hemen çağıranın tam güven iznine sahip olmadığı bir SecurityException oluşturulur.A SecurityException is thrown when the immediate caller does not have full-trust permission. Güvenlik talepleri hakkında daha fazla bilgi için bkz. bağlantı talepleri.For details about security demands, see Link Demands.

Oluşturucular

ProcessStartInfo()

İşlemin başlatılacağı bir dosya adı belirtmeden ProcessStartInfo sınıfının yeni bir örneğini başlatır.Initializes a new instance of the ProcessStartInfo class without specifying a file name with which to start the process.

ProcessStartInfo(String)

ProcessStartInfo sınıfının yeni bir örneğini başlatır ve işlemin başlatılacağı uygulama veya belge gibi bir dosya adı belirtir.Initializes a new instance of the ProcessStartInfo class and specifies a file name such as an application or document with which to start the process.

ProcessStartInfo(String, String)

ProcessStartInfo sınıfının yeni bir örneğini başlatır, işlemin başlatılacağı bir uygulama dosyası adını belirtir ve uygulamaya geçirilecek bir dizi komut satırı bağımsız değişkeni belirtir.Initializes a new instance of the ProcessStartInfo class, specifies an application file name with which to start the process, and specifies a set of command-line arguments to pass to the application.

Özellikler

ArgumentList

Uygulamayı başlatırken kullanılacak komut satırı bağımsız değişkenlerinin koleksiyonunu alır.Gets a collection of command-line arguments to use when starting the application.

Arguments

Uygulamayı başlatırken kullanılacak komut satırı bağımsız değişkenlerinin kümesini alır veya ayarlar.Gets or sets the set of command-line arguments to use when starting the application.

CreateNoWindow

İşlemin yeni bir pencerede başlatılıp başlatılmayacağını gösteren bir değer alır veya ayarlar.Gets or sets a value indicating whether to start the process in a new window.

Domain

İşlem başlatılırken kullanılacak etki alanını tanımlayan bir değeri alır veya ayarlar.Gets or sets a value that identifies the domain to use when starting the process. Bu değer nullise, UserName özelliğinin UPN biçiminde belirtilmesi gerekir.If this value is null, the UserName property must be specified in UPN format.

Environment

Bu işleme ve alt işlemlerine uygulanan ortam değişkenlerini alır.Gets the environment variables that apply to this process and its child processes.

EnvironmentVariables

Dosyalar için arama yollarını, geçici dosyalar için dizinleri, uygulamaya özel seçenekleri ve diğer benzer bilgileri alır.Gets search paths for files, directories for temporary files, application-specific options, and other similar information.

ErrorDialog

İşlem başlatılmamışsa, kullanıcıya bir hata iletişim kutusu görüntülenip görüntülenmediğini gösteren değeri alır veya ayarlar.Gets or sets a value indicating whether an error dialog box is displayed to the user if the process cannot be started.

ErrorDialogParentHandle

Başlatılmamış bir işlem için bir hata iletişim kutusu gösterildiğinde kullanılacak pencere tanıtıcısını alır veya ayarlar.Gets or sets the window handle to use when an error dialog box is shown for a process that cannot be started.

FileName

Başlatılacak uygulamayı veya belgeyi alır veya ayarlar.Gets or sets the application or document to start.

LoadUserProfile

Windows Kullanıcı profilinin kayıt defterinden yüklenip yüklenmeyeceğini gösteren bir değer alır veya ayarlar.Gets or sets a value that indicates whether the Windows user profile is to be loaded from the registry.

Password

İşlem başlatılırken kullanılacak kullanıcı parolasını içeren bir güvenli dize alır veya ayarlar.Gets or sets a secure string that contains the user password to use when starting the process.

PasswordInClearText

İşlem başlatılırken kullanılacak şifresiz metinde Kullanıcı parolasını alır veya ayarlar.Gets or sets the user password in clear text to use when starting the process.

RedirectStandardError

Bir uygulamanın hata çıktısının StandardError akışa yazılıp yazılmadığını gösteren bir değer alır veya ayarlar.Gets or sets a value that indicates whether the error output of an application is written to the StandardError stream.

RedirectStandardInput

Uygulama girişinin StandardInput akıştan okunup okunmadığını gösteren bir değer alır veya ayarlar.Gets or sets a value indicating whether the input for an application is read from the StandardInput stream.

RedirectStandardOutput

Bir uygulamanın metinsel çıktısının StandardOutput akışa yazılıp yazılmadığını gösteren bir değer alır veya ayarlar.Gets or sets a value that indicates whether the textual output of an application is written to the StandardOutput stream.

StandardErrorEncoding

Hata çıktısı için tercih edilen kodlamayı alır veya ayarlar.Gets or sets the preferred encoding for error output.

StandardInputEncoding

Standart giriş için tercih edilen kodlamayı alır veya ayarlar.Gets or sets the preferred encoding for standard input.

StandardOutputEncoding

Standart çıkış için tercih edilen kodlamayı alır veya ayarlar.Gets or sets the preferred encoding for standard output.

UserName

İşlem başlatılırken kullanılacak kullanıcı adını alır veya ayarlar.Gets or sets the user name to use when starting the process. user@DNS_domain_nameUPN biçimini kullanırsanız Domain özelliği nullolmalıdır.If you use the UPN format, user@DNS_domain_name, the Domain property must be null.

UseShellExecute

İşlemi başlatmak için işletim sistemi kabuğu 'nun kullanılıp kullanılmayacağını gösteren bir değer alır veya ayarlar.Gets or sets a value indicating whether to use the operating system shell to start the process.

Verb

FileName özelliği tarafından belirtilen uygulamayı veya belgeyi açarken kullanılacak fiili 'i alır veya ayarlar.Gets or sets the verb to use when opening the application or document specified by the FileName property.

Verbs

FileName özelliği tarafından belirtilen dosya türüyle ilişkili fiil kümesini alır.Gets the set of verbs associated with the type of file specified by the FileName property.

WindowStyle

İşlem başlatıldığında kullanılacak pencere durumunu alır veya ayarlar.Gets or sets the window state to use when the process is started.

WorkingDirectory

UseShellExecute özelliği falseolduğunda, başlatılacak işlemin çalışma dizinini alır veya ayarlar.When the UseShellExecute property is false, gets or sets the working directory for the process to be started. UseShellExecute trueolduğunda, başlatılacak işlemi içeren dizini alır veya ayarlar.When UseShellExecute is true, gets or sets the directory that contains the process to be started.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneyle eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Serves as the default hash function.Serves as the default hash function.

(Devralındığı yer: Object)
GetType()

Gets the Type of the current instance.Gets the Type of the current instance.

(Devralındığı yer: Object)
MemberwiseClone()

Creates a shallow copy of the current Object.Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden bir dize döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Güvenlik

SecurityPermission
ProcessStartInfoüyelerini çağırmak için.for calling members of ProcessStartInfo. Talep değeri: LinkDemand; Adlandırılmış Izin kümeleri: FullTrust.Demand value: LinkDemand; Named Permission Sets: FullTrust.

Şunlara uygulanır

Ayrıca bkz.