Process.StartInfo Özellik

Tanım

ProcessStart() metoduna geçirilecek özellikleri alır veya ayarlar.Gets or sets the properties to pass to the Start() method of the Process.

public:
 property System::Diagnostics::ProcessStartInfo ^ StartInfo { System::Diagnostics::ProcessStartInfo ^ get(); void set(System::Diagnostics::ProcessStartInfo ^ value); };
[System.ComponentModel.Browsable(false)]
public System.Diagnostics.ProcessStartInfo StartInfo { get; set; }
member this.StartInfo : System.Diagnostics.ProcessStartInfo with get, set
Public Property StartInfo As ProcessStartInfo

Özellik Değeri

İşlemin başlatılacağı verileri temsil eden ProcessStartInfo.The ProcessStartInfo that represents the data with which to start the process. Bu bağımsız değişkenler, işlemi başlatmak için kullanılan yürütülebilir dosyanın veya belgenin adını içerir.These arguments include the name of the executable file or document used to start the process.

Öznitelikler

Özel Durumlar

StartInfo belirten değer null.The value that specifies the StartInfo is null.

İşlemi başlatmak için Start() yöntemi kullanılmadı.The Start() method was not used to start the process.

Örnekler

Aşağıdaki örnek, yürütülecek dosyayı, üzerinde gerçekleştirilen eylemi ve bir kullanıcı arabirimini görüntüleyip görüntülemediğini bir StartInfo doldurur.The following example populates a StartInfo with the file to execute, the action performed on it and whether it should displays a user interface. Ek örnekler için ProcessStartInfo sınıfının özellikleri için başvuru sayfalarına bakın.For additional examples, refer to the reference pages for properties of the ProcessStartInfo class.

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

int main()
{
    Process^ myProcess = gcnew Process;

    try
    {
        myProcess->StartInfo->UseShellExecute = false;
        // You can start any process, HelloWorld is a do-nothing example.
        myProcess->StartInfo->FileName = "C:\\HelloWorld.exe";
        myProcess->StartInfo->CreateNoWindow = true;
        myProcess->Start();
        // This code assumes the process you are starting will terminate itself. 
        // Given that is is started without a window so you cannot terminate it 
        // on the desktop, it must terminate itself or you can do it programmatically
        // from this application using the Kill method.
    }
    catch ( Exception^ e ) 
    {
        Console::WriteLine( e->Message );
    }
}
using System;
using System.Diagnostics;
using System.ComponentModel;

namespace MyProcessSample
{
    class MyProcess
    {
        public static void Main()
        {
            try
            {
                using (Process myProcess = new Process())
                {
                    myProcess.StartInfo.UseShellExecute = false;
                    // You can start any process, HelloWorld is a do-nothing example.
                    myProcess.StartInfo.FileName = "C:\\HelloWorld.exe";
                    myProcess.StartInfo.CreateNoWindow = true;
                    myProcess.Start();
                    // This code assumes the process you are starting will terminate itself. 
                    // Given that is is started without a window so you cannot terminate it 
                    // on the desktop, it must terminate itself or you can do it programmatically
                    // from this application using the Kill method.
                }
            }
            catch (Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}
Imports System.Diagnostics
Imports System.ComponentModel

Namespace MyProcessSample
    Class MyProcess
        Public Shared Sub Main()
            Try
                Using myProcess As New Process()

                    myProcess.StartInfo.UseShellExecute = False
                    ' You can start any process, HelloWorld is a do-nothing example.
                    myProcess.StartInfo.FileName = "C:\\HelloWorld.exe"
                    myProcess.StartInfo.CreateNoWindow = True
                    myProcess.Start()
                    ' This code assumes the process you are starting will terminate itself. 
                    ' Given that is is started without a window so you cannot terminate it 
                    ' on the desktop, it must terminate itself or you can do it programmatically
                    ' from this application using the Kill method.
                End Using
            Catch e As Exception
                Console.WriteLine((e.Message))
            End Try
        End Sub
    End Class
End Namespace

Açıklamalar

StartInfo bir işlemi başlatmak için kullanılacak parametre kümesini temsil eder.StartInfo represents the set of parameters to use to start a process. Start çağrıldığında, başlatılacak işlemi belirtmek için StartInfo kullanılır.When Start is called, the StartInfo is used to specify the process to start. Ayarlanacak tek gerekli StartInfo üyesi FileName özelliktir.The only necessary StartInfo member to set is the FileName property. FileName özelliğini belirterek bir işlemin başlatılması, Windows Başlat menüsünün Çalıştır iletişim kutusunda bilgileri yazmaya benzer.Starting a process by specifying the FileName property is similar to typing the information in the Run dialog box of the Windows Start menu. Bu nedenle, FileName özelliğinin yürütülebilir bir dosyayı göstermesi gerekmez.Therefore, the FileName property does not need to represent an executable file. Uzantının sistemde yüklü bir uygulamayla ilişkilendirildiği herhangi bir dosya türü olabilir.It can be of any file type for which the extension has been associated with an application installed on the system. Örneğin, Not Defteri gibi bir düzenleyici ile ilişkili metin dosyaları varsa FileName bir. txt uzantısına sahip olabilir veya. doc dosyalarını Microsoft Word gibi bir sözcük işleme aracı ile ilişkilendirdiyseniz. doc olabilir.For example the FileName can have a .txt extension if you have associated text files with an editor, such as Notepad, or it can have a .doc if you have associated .doc files with a word processing tool, such as Microsoft Word. Benzer şekilde, Çalıştır iletişim kutusunun. exe uzantısı olan veya olmadan çalıştırılabilir dosya adını kabul edebileceği şekilde,. exe uzantısı FileName üyesinde isteğe bağlıdır.Similarly, in the same way that the Run dialog box can accept an executable file name with or without the .exe extension, the .exe extension is optional in the FileName member. Örneğin, FileName özelliğini "Notepad. exe" ya da "Notepad" olarak ayarlayabilirsiniz.For example, you can set the FileName property to either "Notepad.exe" or "Notepad".

FileName özelliğini, uygulamayı ilk yüklediğiniz konuma (örneğin, bir Web adresi) ayarlayarak bir ClickOnce uygulaması başlatabilirsiniz.You can start a ClickOnce application by setting the FileName property to the location (for example, a Web address) from which you originally installed the application. Sabit sürücünüzde yüklü konumunu belirterek bir ClickOnce uygulaması başlatmayın.Do not start a ClickOnce application by specifying its installed location on your hard drive.

Dosya adı. doc dosyası gibi yürütülebilir olmayan bir dosya içeriyorsa, dosyada hangi eylemin yapılacağını belirten bir fiil dahil edebilirsiniz.If the file name involves a nonexecutable file, such as a .doc file, you can include a verb specifying what action to take on the file. Örneğin,. doc uzantısıyla biten bir dosya için Verb "Print" olarak ayarlayabilirsiniz.For example, you could set the Verb to "Print" for a file ending in the .doc extension. Verb özelliği için el ile bir değer girerseniz FileName özelliğinde belirtilen dosya adının bir uzantısı olması gerekmez.The file name specified in the FileName property does not need to have an extension if you manually enter a value for the Verb property. Ancak, hangi fiillerin kullanılabildiğini belirlemek için Verbs özelliğini kullanırsanız, uzantıyı dahil etmeniz gerekir.However, if you use the Verbs property to determine what verbs are available, you must include the extension.

StartInfo özelliğinde belirtilen parametreleri, işlem üzerinde Start yöntemini çağırdığınız zamana kadar değiştirebilirsiniz.You can change the parameters specified in the StartInfo property up to the time that you call the Start method on the process. İşlemi başlattıktan sonra, StartInfo değerlerinin değiştirilmesi ilişkili işlemi etkilemez veya yeniden başlatmaz.After you start the process, changing the StartInfo values does not affect or restart the associated process. Start(ProcessStartInfo) yöntemini ProcessStartInfo.UserName ve ProcessStartInfo.Password Özellikler ayarlanmış olarak çağırırsanız, yönetilmeyen CreateProcessWithLogonW işlevi çağrılır, bu, CreateNoWindow Özellik değeri true veya WindowStyle Özellik değeri Hiddenolsa bile işlemi yeni bir pencerede başlatır.If you call the Start(ProcessStartInfo) method with the ProcessStartInfo.UserName and ProcessStartInfo.Password properties set, the unmanaged CreateProcessWithLogonW function is called, which starts the process in a new window even if the CreateNoWindow property value is true or the WindowStyle property value is Hidden.

StartInfo özelliğine yalnızca Start yöntemi tarafından döndürülen bir Process nesnesi üzerinde erişmeniz gerekir.You should only access the StartInfo property on a Process object returned by the Start method. Örneğin, GetProcessestarafından döndürülen bir Process nesnesindeki StartInfo özelliğine erişiminizin olmaması gerekir.For example, you should not access the StartInfo property on a Process object returned by GetProcesses. Aksi takdirde, .NET Core 'da StartInfo özelliği bir InvalidOperationException oluşturur .NET Framework ve bir kukla ProcessStartInfo nesnesi döndürür.Otherwise, on .NET Core the StartInfo property will throw an InvalidOperationException and on .NET Framework it will return a dummy ProcessStartInfo object.

İşlem başlatıldığında dosya adı (salt okunurdur) MainModule özelliğini dolduran dosyadır.When the process is started, the file name is the file that populates the (read-only) MainModule property. İşlem başladıktan sonra işlemle ilişkili yürütülebilir dosyayı almak istiyorsanız MainModule özelliğini kullanın.If you want to retrieve the executable file that is associated with the process after the process has started, use the MainModule property. İlişkili bir işlemin başlatılmadığı bir Process örneğinin yürütülebilir dosyasını ayarlamak istiyorsanız, StartInfo özelliğinin FileName üyesini kullanın.If you want to set the executable file of a Process instance for which an associated process has not been started, use the StartInfo property's FileName member. StartInfo özelliğinin üyeleri bir işlemin Start yöntemine geçirilen bağımsız değişkenler olduğundan, ilişkili işlem başladıktan sonra FileName özelliğinin değiştirilmesi MainModule özelliğini sıfırlayamaz.Because the members of the StartInfo property are arguments that are passed to the Start method of a process, changing the FileName property after the associated process has started will not reset the MainModule property. Bu özellikler yalnızca ilişkili işlemi başlatmak için kullanılır.These properties are used only to initialize the associated process.

Güvenlik

LinkDemand
şu anki çağırana ilişkin tam güven için.for full trust for the immediate caller. Bu üye kısmen güvenilen kod tarafından kullanılamaz.This member cannot be used by partially trusted code.

Şunlara uygulanır

Ayrıca bkz.