ProcessStartInfo.Arguments Özellik

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Diagnostics.Process.dll

Kaynak:

ProcessStartInfo.cs

Uygulamayı başlatırken kullanılacak komut satırı bağımsız değişkenleri kümesini alır veya ayarlar.

public:
 property System::String ^ Arguments { System::String ^ get(); void set(System::String ^ value); };

public string Arguments { get; set; }

member this.Arguments : string with get, set

Public Property Arguments As String

Özellik Değeri

String

özelliğinde FileName belirtilen hedef uygulamaya geçirmek için bağımsız değişkenleri içeren tek bir dize. Varsayılan değer boş bir dizedir ("").

Örnekler

İlk örnek, bağımsız değişkenlerini konsola yankılayan küçük bir uygulama (argsecho.exe) oluşturur. İkinci örnek, özelliği için farklı varyasyonları göstermek üzere Arguments argsecho.exe çağıran bir uygulama oluşturur.

// Place this code into a console project called ArgsEcho to build the argsecho.exe target

using System;

namespace StartArgs
{
    class ArgsEcho
    {
        static void Main(string[] args)
        {
            Console.WriteLine("Received the following arguments:\n");

            for (var i = 0; i < args.Length; i++)
            {
                Console.WriteLine($"[{i}] = {args[i]}");
            }

            Console.WriteLine("\nPress any key to exit");
            Console.ReadLine();
        }
    }
}

' Place this code into a console project called ArgsEcho to build the argsecho.exe target

Module Module1
    Sub Main()
        Dim i As Integer = 0

        For Each s As String In My.Application.CommandLineArgs
            Console.WriteLine($"[{i}] = {s}")
            i = i + 1
        Next

        Console.WriteLine(Environment.NewLine + "Press any key to exit")
        Console.ReadLine()
    End Sub
End Module

// Place this code into a console project called StartArgsEcho. It depends on the
// console application named argsecho.exe.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Diagnostics;

namespace StartArgsEcho
{
    class Program
    {
        static void Main()
        {
            ProcessStartInfo startInfo = new ProcessStartInfo("argsecho.exe");
            startInfo.WindowStyle = ProcessWindowStyle.Normal;

            // Start with one argument.
            // Output of ArgsEcho:
            //  [0]=/a
            startInfo.Arguments = "/a";
            Process.Start(startInfo);

            // Start with multiple arguments separated by spaces.
            // Output of ArgsEcho:
            //  [0] = /a
            //  [1] = /b
            //  [2] = c:\temp
            startInfo.Arguments = "/a /b c:\\temp";
            Process.Start(startInfo);

            // An argument with spaces inside quotes is interpreted as multiple arguments.
            // Output of ArgsEcho:
            //  [0] = /a
            //  [1] = literal string arg
            startInfo.Arguments = "/a \"literal string arg\"";
            Process.Start(startInfo);

            // An argument inside double quotes is interpreted as if the quote weren't there,
            // that is, as separate arguments. Equivalent verbatim string is @"/a /b:""string with quotes"""
            // Output of ArgsEcho:
            //  [0] = /a
            //  [1] = /b:string
            //  [2] = in
            //  [3] = double
            //  [4] = quotes
            startInfo.Arguments = "/a /b:\"\"string in double quotes\"\"";
            Process.Start(startInfo);

            // Triple-escape quotation marks to include the character in the final argument received
            // by the target process. Equivalent verbatim string: @"/a /b:""""""quoted string""""""";
            //  [0] = /a
            //  [1] = /b:"quoted string"
            startInfo.Arguments = "/a /b:\"\"\"quoted string\"\"\"";
            Process.Start(startInfo);
        }
    }
}

' Place this code into a console project called StartArgsEcho. It depends on the
' console application named argsecho.exe.

Module Module1
    Sub Main()
        Dim startInfo As ProcessStartInfo = New ProcessStartInfo("argsecho.exe")
        startInfo.WindowStyle = ProcessWindowStyle.Normal

        ' Start with one argument.
        ' Output of ArgsEcho:
        '  [0]=/a            
        startInfo.Arguments = "/a"
        Process.Start(startInfo)

        ' Start with multiple arguments separated by spaces.
        ' Output of ArgsEcho:
        '  [0] = /a
        '  [1] = /b
        '  [2] = c:\temp
        startInfo.Arguments = "/a /b c:\temp"
        Process.Start(startInfo)

        ' An argument with spaces inside quotes is interpreted as multiple arguments.
        ' Output of ArgsEcho:
        '  [0] = /a
        '  [1] = literal string arg
        startInfo.Arguments = "/a ""literal string arg"" "
        Process.Start(startInfo)

        ' An argument inside double quotes is interpreted as if the quote weren't there,
        ' that is, as separate arguments.
        ' Output of ArgsEcho:
        '  [0] = /a
        '  [1] = /b:string
        '  [2] = in
        '  [3] = double
        '  [4] = quotes
        startInfo.Arguments = "/a /b:""""string in double quotes"""" "
        Process.Start(startInfo)

        ' Triple-escape quotation marks to include the character in the final argument received
        ' by the target process. 
        '  [0] = /a
        '  [1] = /b:"quoted string"
        startInfo.Arguments = "/a /b:""""""quoted string"""""" "
        Process.Start(startInfo)
    End Sub
End Module

Açıklamalar

Özelliğine atanan dizenin Arguments uzunluğu 32.699'dan az olmalıdır.

Bağımsız değişkenler hedef uygulama tarafından ayrıştırılır ve yorumlanır, bu nedenle bu uygulamanın beklentileriyle uyumlu olmalıdır. Aşağıdaki Örneklerde gösterildiği gibi .NET uygulamaları için boşluklar, birden çok bağımsız değişken arasında ayırıcı olarak yorumlanır. Boşluk içeren tek bir bağımsız değişken tırnak içine alınmalıdır, ancak bu tırnak işaretleri hedef uygulamaya taşınmaz. Ayrıştırılan son bağımsız değişkene tırnak işaretleri eklemek için her işareti üç kez kaçış olarak ayarlayın. Komut satırı bağımsız değişkenlerini ayarlamak için bu özelliği kullanırsanız, ArgumentList herhangi bir öğe içermemelidir.

Arguments ve ArgumentList birbirinden bağımsızdır. Başka bir ifadeyle, özelliğine Arguments atanan dize koleksiyonu doldurmaz ArgumentList ve koleksiyonun ArgumentList üyeleri özelliğine Arguments atanmamış olur.

Ö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.