ProcessStartInfo Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.Process.dll

Kaynak:

ProcessStartInfo.cs

Bir işlemi başlattığınızda kullanılan bir değer kümesini belirler.

public ref class ProcessStartInfo sealed

public sealed class ProcessStartInfo

type ProcessStartInfo = class

Public NotInheritable Class ProcessStartInfo

Devralma

Object

ProcessStartInfo

Örnekler

Aşağıdaki kod örneği, Internet Explorer'ı başlatmak için sınıfının nasıl kullanılacağını ProcessStartInfo gösterir. Hedef URL'ler bağımsız değişken olarak ProcessStartInfo sağlanır.

#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 bileşeniyle Process birlikte kullanılır. sınıfını Process kullanarak bir işlem başlattığınızda, çalışan bir işleme eklerken kullanılabilen bilgilere ek olarak işlem bilgilerine de erişebilirsiniz.

Başlattığınız işlem üzerinde daha iyi denetim için sınıfını kullanabilirsiniz ProcessStartInfo . En azından el ile veya oluşturucu kullanarak özelliğini ayarlamanız FileName gerekir. Dosya adı herhangi bir uygulama veya belgedir. Burada bir belge, kendisiyle ilişkilendirilmiş açık veya varsayılan eylemi olan herhangi bir dosya türü olarak tanımlanmıştır. İşletim sistemi aracılığıyla kullanılabilen Klasör Seçenekleri iletişim kutusunu kullanarak bilgisayarınız için kayıtlı dosya türlerini ve bunların ilişkili uygulamalarını görüntüleyebilirsiniz. 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.

Ayrıca, bu dosyayla gerçekleştirecek eylemleri tanımlayan diğer özellikleri de ayarlayabilirsiniz. Özelliğin özelliğinin FileNameVerb türüne özgü bir değer belirtebilirsiniz. Örneğin, bir belge türü için "yazdır" belirtebilirsiniz. Ayrıca, dosyanın açık yordamına geçirilecek komut satırı bağımsız değişkenleri olacak özellik değerlerini belirtebilirsiniz Arguments . Örneğin, özelliğinde FileName bir metin düzenleyici uygulaması belirtirseniz, düzenleyici tarafından açılacak bir metin dosyası belirtmek için özelliğini kullanabilirsiniz Arguments .

Standart giriş genellikle klavyedir ve standart çıkış ve standart hata genellikle monitör ekranıdır. Ancak, işlemin bir dosyadan veya başka bir cihazdan giriş almasına veya çıkış döndürmesine neden olmak için , RedirectStandardOutputve RedirectStandardError özelliklerini kullanabilirsinizRedirectStandardInput. Bileşende StandardInputProcess , StandardOutputveya StandardError özelliklerini kullanırsanız, önce özelliğinde karşılık gelen değeri ProcessStartInfo ayarlamanız gerekir. Aksi takdirde, akışa okuduğunuzda veya yazdığınızda sistem bir özel durum oluşturur.

UseShellExecute İşletim sistemi kabuğunu kullanarak işlemin başlatılıp başlatılmayacağını belirtmek için özelliğini ayarlayın. olarak ayarlanırsa UseShellExecutefalse, sırasıyla , RedirectStandardOutputveya RedirectStandardError özellikleri olarak ayarlanmadığı truesüreceRedirectStandardInput, yeni işlem çağrı işleminin standart girişini, standart çıkışını ve standart hata akışlarını devralır.

Herhangi bir ProcessStartInfo özelliğin değerini işlemin başladığı zamana kadar değiştirebilirsiniz. İşlemi başlattıktan sonra bu değerleri değiştirmenin hiçbir etkisi olmaz.

Önemli

Güvenilmeyen verilerle bu nesnenin bir örneğini kullanmak bir güvenlik riskidir. Bu nesneyi yalnızca güvenilen verilerle kullanın. Daha fazla bilgi için bkz. Tüm Girişleri Doğrulama.

Not

Bu sınıf, tüm üyeler için geçerli olan sınıf düzeyinde bir bağlantı talebi içerir. Hemen çağıranın tam güven izni olmadığında bir SecurityException oluşturulur. Güvenlik talepleri hakkında ayrıntılı bilgi için bkz. Bağlantı Talepleri.

Oluşturucular

ProcessStartInfo()	İşlemin ProcessStartInfo başlatıldığı bir dosya adı belirtmeden sınıfının yeni bir örneğini başlatır.
ProcessStartInfo(String)	sınıfının yeni bir örneğini ProcessStartInfo başlatır ve işlemin başlatıldığı uygulama veya belge gibi bir dosya adı belirtir.
ProcessStartInfo(String, IEnumerable<String>)	Bir işlemi başlattığınızda kullanılan bir değer kümesini belirler.
ProcessStartInfo(String, String)	sınıfının yeni bir örneğini ProcessStartInfo başlatır, işlemin başlatıldığı bir uygulama dosyası adı belirtir ve uygulamaya geçirebileceğiniz bir dizi komut satırı bağımsız değişkeni belirtir.

Özellikler

ArgumentList	Uygulamayı başlatırken kullanılacak komut satırı bağımsız değişkenlerinden oluşan bir koleksiyon alır. Listeye eklenen dizelerin daha önce kaçış karakterine sahip olması gerekmez.
Arguments	Uygulamayı başlatırken kullanılacak komut satırı bağımsız değişkenlerini alır veya ayarlar.
CreateNoWindow	İşlemin yeni bir pencerede başlatılıp başlatılmayacağını belirten bir değer alır veya ayarlar.
Domain	İşlemi başlatırken kullanılacak etki alanını tanımlayan bir değer alır veya ayarlar. Bu değer ise nullUserName özelliği UPN biçiminde belirtilmelidir.
Environment	Bu işleme ve onun alt işlemlerine uygulanan ortam değişkenlerini alır.
EnvironmentVariables	Dosyalar için arama yollarını, geçici dosyalar için dizinleri, uygulamaya özgü seçenekleri ve diğer benzer bilgileri alır.
ErrorDialog	İşlem başlatılamıyorsa kullanıcıya bir hata iletişim kutusunun görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
ErrorDialogParentHandle	Başlatılamayan bir işlem için hata iletişim kutusu gösterildiğinde kullanılacak pencere tutamacını alır veya ayarlar.
FileName	Başlatacak uygulamayı veya belgeyi alır veya ayarlar.
LoadUserProfile	Windows kullanıcı profilinin kayıt defterinden yüklenip yüklenmeyeceğini belirten bir değer alır veya ayarlar.
Password	İşlemi başlatırken kullanılacak kullanıcı parolasını içeren güvenli bir dize alır veya ayarlar.
PasswordInClearText	İşlemi başlatırken kullanılacak kullanıcı parolasını düz metin olarak alır veya ayarlar.
RedirectStandardError	Bir uygulamanın hata çıkışının akışa StandardError yazılıp yazılmadığını belirten bir değer alır veya ayarlar.
RedirectStandardInput	Bir uygulama girişinin akıştan StandardInput okunup okunmadığını belirten bir değer alır veya ayarlar.
RedirectStandardOutput	Bir uygulamanın metin çıktısının akışa StandardOutput yazılıp yazılmadığını belirten bir değer alır veya ayarlar.
StandardErrorEncoding	Hata çıkışı için tercih edilen kodlamayı alır veya ayarlar.
StandardInputEncoding	Standart giriş için tercih edilen kodlamayı alır veya ayarlar.
StandardOutputEncoding	Standart çıkış için tercih edilen kodlamayı alır veya ayarlar.
UseCredentialsForNetworkingOnly	Bir işlemi başlattığınızda kullanılan bir değer kümesini belirler.
UserName	İşlemi başlatırken kullanılacak kullanıcı adını alır veya ayarlar. UPN biçimini kullanıyorsanız, userDomain@DNS_domain_nameözelliği olmalıdır.null
UseShellExecute	İşlemi başlatmak için işletim sistemi kabuğunun kullanılıp kullanılmayacağını belirten bir değer alır veya ayarlar.
Verb	Özelliği tarafından FileName belirtilen uygulamayı veya belgeyi açarken kullanılacak fiili alır veya ayarlar.
Verbs	özelliği tarafından FileName belirtilen dosya türüyle ilişkili fiil kümesini alır.
WindowStyle	İşlem başlatıldığında kullanılacak pencere durumunu alır veya ayarlar.
WorkingDirectory	UseShellExecute özelliği olduğundafalse, işlemin başlatılması için çalışma dizinini alır veya ayarlar. olduğunda UseShellExecutetrue, başlatılacak işlemi içeren dizini alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Process