ProcessStartInfo Kelas

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.Process.dll

Sumber:

ProcessStartInfo.cs

Menentukan sekumpulan nilai yang digunakan saat Anda memulai proses.

public ref class ProcessStartInfo sealed

public sealed class ProcessStartInfo

type ProcessStartInfo = class

Public NotInheritable Class ProcessStartInfo

Warisan

Object

ProcessStartInfo

Contoh

Contoh kode berikut menunjukkan cara menggunakan ProcessStartInfo kelas untuk memulai Internet Explorer. URL tujuan disediakan sebagai ProcessStartInfo argumen.

#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

Keterangan

ProcessStartInfo digunakan bersama dengan Process komponen. Saat memulai proses menggunakan Process kelas , Anda memiliki akses untuk memproses informasi selain yang tersedia saat melampirkan ke proses yang sedang berjalan.

Anda dapat menggunakan ProcessStartInfo kelas untuk kontrol yang lebih baik atas proses yang Anda mulai. Anda setidaknya harus mengatur FileName properti , baik secara manual atau menggunakan konstruktor . Nama file adalah aplikasi atau dokumen apa pun. Di sini dokumen didefinisikan untuk menjadi jenis file apa pun yang memiliki tindakan terbuka atau default yang terkait dengannya. Anda dapat melihat jenis file terdaftar dan aplikasi terkaitnya untuk komputer Anda dengan menggunakan kotak dialog Opsi Folder , yang tersedia melalui sistem operasi. Tombol Tingkat Lanjut mengarah ke kotak dialog yang memperlihatkan apakah ada tindakan terbuka yang terkait dengan jenis file terdaftar tertentu.

Selain itu, Anda dapat mengatur properti lain yang menentukan tindakan yang akan diambil dengan file tersebut. Anda dapat menentukan nilai khusus untuk jenis FileName properti untuk Verb properti . Misalnya, Anda dapat menentukan "cetak" untuk jenis dokumen. Selain itu, Anda dapat menentukan Arguments nilai properti untuk menjadi argumen baris perintah untuk diteruskan ke prosedur buka file. Misalnya, jika Anda menentukan aplikasi editor teks di FileName properti , Anda dapat menggunakan Arguments properti untuk menentukan file teks yang akan dibuka oleh editor.

Input standar biasanya adalah keyboard, dan output standar dan kesalahan standar biasanya layar monitor. Namun, Anda dapat menggunakan RedirectStandardInputproperti , RedirectStandardOutput, dan RedirectStandardError untuk menyebabkan proses mendapatkan input dari atau mengembalikan output ke file atau perangkat lain. Jika Anda menggunakan StandardInputproperti , StandardOutput, atau StandardError pada Process komponen , Anda harus terlebih dahulu mengatur nilai yang sesuai pada ProcessStartInfo properti . Jika tidak, sistem akan memberikan pengecualian saat Anda membaca atau menulis ke aliran.

Atur UseShellExecute properti untuk menentukan apakah akan memulai proses dengan menggunakan shell sistem operasi. Jika UseShellExecute diatur ke false, proses baru mewarisi input standar, output standar, dan aliran kesalahan standar dari proses panggilan, kecuali RedirectStandardInputproperti , , RedirectStandardOutputatau RedirectStandardError , masing-masing, diatur ke true.

Anda dapat mengubah nilai properti apa pun ProcessStartInfo hingga waktu proses dimulai. Setelah Anda memulai proses, mengubah nilai-nilai ini tidak berpengaruh.

Penting

Menggunakan instans objek ini dengan data yang tidak tepercaya adalah risiko keamanan. Gunakan objek ini hanya dengan data tepercaya. Untuk informasi selengkapnya, lihat Memvalidasi Semua Input.

Catatan

Kelas ini berisi permintaan tautan di tingkat kelas yang berlaku untuk semua anggota. SecurityException dilemparkan ketika penelepon langsung tidak memiliki izin kepercayaan penuh. Untuk detail tentang tuntutan keamanan, lihat Permintaan Tautan.

Konstruktor

ProcessStartInfo()	Menginisialisasi instans ProcessStartInfo baru kelas tanpa menentukan nama file untuk memulai proses.
ProcessStartInfo(String)	Menginisialisasi instans ProcessStartInfo baru kelas dan menentukan nama file seperti aplikasi atau dokumen untuk memulai proses.
ProcessStartInfo(String, IEnumerable<String>)	Menentukan sekumpulan nilai yang digunakan saat Anda memulai proses.
ProcessStartInfo(String, String)	Menginisialisasi instans ProcessStartInfo baru kelas , menentukan nama file aplikasi untuk memulai proses, dan menentukan sekumpulan argumen baris perintah untuk diteruskan ke aplikasi.

Properti

ArgumentList	Mendapatkan kumpulan argumen baris perintah untuk digunakan saat memulai aplikasi. String yang ditambahkan ke daftar tidak perlu dilewati sebelumnya.
Arguments	Mendapatkan atau mengatur kumpulan argumen baris perintah yang akan digunakan saat memulai aplikasi.
CreateNoWindow	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan memulai proses di jendela baru.
Domain	Mendapatkan atau menetapkan nilai yang mengidentifikasi domain yang akan digunakan saat memulai proses. Jika nilai ini adalah null, UserName properti harus ditentukan dalam format UPN.
Environment	Mendapatkan variabel lingkungan yang berlaku untuk proses ini dan proses anaknya.
EnvironmentVariables	Mendapatkan jalur pencarian untuk file, direktori untuk file sementara, opsi khusus aplikasi, dan informasi serupa lainnya.
ErrorDialog	Mendapatkan atau mengatur nilai yang menunjukkan apakah kotak dialog kesalahan ditampilkan kepada pengguna jika proses tidak dapat dimulai.
ErrorDialogParentHandle	Mendapatkan atau mengatur handel jendela yang akan digunakan saat kotak dialog kesalahan ditampilkan untuk proses yang tidak dapat dimulai.
FileName	Mendapatkan atau mengatur aplikasi atau dokumen untuk memulai.
LoadUserProfile	Mendapatkan atau menetapkan nilai yang menunjukkan apakah profil pengguna Windows akan dimuat dari registri.
Password	Mendapatkan atau mengatur string aman yang berisi kata sandi pengguna untuk digunakan saat memulai proses.
PasswordInClearText	Mendapatkan atau mengatur kata sandi pengguna dalam teks yang jelas untuk digunakan saat memulai proses.
RedirectStandardError	Mendapatkan atau menetapkan nilai yang menunjukkan apakah output kesalahan aplikasi ditulis ke StandardError aliran.
RedirectStandardInput	Mendapatkan atau menetapkan nilai yang menunjukkan apakah input untuk aplikasi dibaca dari StandardInput aliran.
RedirectStandardOutput	Mendapatkan atau menetapkan nilai yang menunjukkan apakah output tekstual aplikasi ditulis ke StandardOutput aliran.
StandardErrorEncoding	Mendapatkan atau mengatur pengodean pilihan untuk output kesalahan.
StandardInputEncoding	Mendapatkan atau mengatur pengodean pilihan untuk input standar.
StandardOutputEncoding	Mendapatkan atau mengatur pengodean pilihan untuk output standar.
UseCredentialsForNetworkingOnly	Menentukan sekumpulan nilai yang digunakan saat Anda memulai proses.
UserName	Mendapatkan atau mengatur nama pengguna yang akan digunakan saat memulai proses. Jika Anda menggunakan format UPN, user@DNS_domain_name, Domain properti harus .null
UseShellExecute	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menggunakan shell sistem operasi untuk memulai proses.
Verb	Mendapatkan atau mengatur kata kerja yang akan digunakan saat membuka aplikasi atau dokumen yang ditentukan oleh FileName properti .
Verbs	Mendapatkan kumpulan kata kerja yang terkait dengan jenis file yang ditentukan oleh FileName properti .
WindowStyle	Mendapatkan atau mengatur status jendela yang akan digunakan saat proses dimulai.
WorkingDirectory	UseShellExecute Ketika properti adalah false, mendapatkan atau mengatur direktori kerja untuk proses yang akan dimulai. Ketika UseShellExecute adalah true, mendapatkan atau mengatur direktori yang berisi proses yang akan dimulai.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Process