ProcessStartInfo.Arguments Eigenschaft

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.Process.dll

Quelle:

ProcessStartInfo.cs

Ruft den Satz von Befehlszeilenargumenten ab, die beim Starten der Anwendung verwendet werden sollen, oder legt diesen fest.

C#

public string Arguments { get; set; }

Eigenschaftswert

String

Eine einzelne Zeichenfolge, die die Argumente enthält, die an die in der FileName-Eigenschaft angegebene Zielanwendung übergeben werden sollen. Der Standardwert ist eine leere Zeichenfolge ("").

Beispiele

Im ersten Beispiel wird eine kleine Anwendung (argsecho.exe) erstellt, die ihre Argumente an die Konsole angibt. Im zweiten Beispiel wird eine Anwendung erstellt, die argsecho.exe aufruft, um verschiedene Variationen für die Arguments Eigenschaft zu veranschaulichen.

C#

// 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();
        }
    }
}

C#

// 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);
        }
    }
}

Hinweise

Die Länge der der Arguments Eigenschaft zugewiesenen Zeichenfolge muss kleiner als 32.699 sein.

Argumente werden von der Zielanwendung analysiert und interpretiert und müssen daher den Erwartungen der betreffenden Anwendung entsprechen. Für .NET-Anwendungen, wie in den folgenden Beispielen veranschaulicht, werden Leerzeichen als Trennzeichen zwischen mehreren Argumenten interpretiert. Ein einzelnes Argument, das Leerzeichen enthält, muss in Anführungszeichen eingeschlossen sein, diese Anführungszeichen werden jedoch nicht an die Zielanwendung übergeben. Um Anführungszeichen in das letzte analysierte Argument einzuschließen, müssen Sie jede Marke dreifach escapen. Wenn Sie diese Eigenschaft zum Festlegen von Befehlszeilenargumenten verwenden, ArgumentList dürfen keine Elemente enthalten.

Arguments und ArgumentList, die ab .NET Core 2.1 und .NET Standard 2.1 unterstützt werden, sind unabhängig voneinander. Das heißt, die der Arguments -Eigenschaft zugewiesene Zeichenfolge füllt die ArgumentList Auflistung nicht auf, und die Elemente der ArgumentList Auflistung werden der Arguments -Eigenschaft nicht zugewiesen.

Wichtig

Das Verwenden einer Instanz dieses Objekts mit nicht vertrauenswürdigen Daten stellt ein Sicherheitsrisiko dar. Verwenden Sie dieses Objekt nur mit vertrauenswürdigen Daten. Weitere Informationen finden Sie unter Überprüfen aller Eingaben.

Gilt für: