ProcessStartInfo Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Diagnostics.Process.dll

Kaynak:

ProcessStartInfo.cs

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

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;
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 belge, kendisiyle ilişkilendirilmiş açık veya varsayılan eylemi olan herhangi bir dosya türü olarak tanımlanı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şkilendirilmiş 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ği Verb türüne FileName ö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üzenleyicisi 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ıyorsanız, önce özelliğinde ilgili değeri ProcessStartInfo ayarlamanız gerekir. Aksi takdirde, akışa okuduğunuzda veya akışa 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 özellikleri olarak ayarlanmadığı truesürece, yeni işlem çağrı işleminin standart girişini, standart çıktısını RedirectStandardInputve RedirectStandardError 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 tür bir örneği 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.

Uyarı

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

Oluşturucular

Name	Description
ProcessStartInfo()	İşlemin ProcessStartInfo başlatıldığı bir dosya adı belirtmeden sınıfın yeni bir örneğini başlatır.
ProcessStartInfo(String, IEnumerable<String>)	Sınıfının yeni bir örneğini ProcessStartInfo başlatır ve başlatacak uygulamanın adını ve uygulamaya geçirecek bir dizi komut satırı bağımsız değişkenini belirtir.
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 komut satırı bağımsız değişkenleri kümesi belirtir.
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.

Özellikler

Name	Description
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çması gerekmez.
Arguments	Uygulamayı başlatırken kullanılacak komut satırı bağımsız değişkenleri kümesini alır veya ayarlar.
CreateNewProcessGroup	İşlemin yeni bir işlem grubunda başlatılıp başlatılmayacağını belirten bir değer 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 nullözelliği UserName UPN biçiminde belirtilmelidir.
Environment	Bu işleme ve 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ı gösteren 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ı gösteren 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	Kullanıcı kimlik bilgilerinin yalnızca ağ kaynakları için kullanılıp kullanılmadığını belirten bir değer alır veya ayarlar.
UserName	İşlemi başlatırken kullanılacak kullanıcı adını alır veya ayarlar. UPN biçimini kullanırsanız, user@DNS_domain_nameDomain özelliği olmalıdırnull.
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

Name	Description
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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Process