ProcessStartInfo.Arguments Tulajdonság

Definíció

Névtér:

System.Diagnostics

Szerelvények:

netstandard.dll, System.Diagnostics.Process.dll

Forrás:

ProcessStartInfo.cs

Lekéri vagy beállítja az alkalmazás indításakor használni kívánt parancssori argumentumokat.

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

Tulajdonság értéke

String

Egyetlen sztring, amely a tulajdonságban FileName megadott célalkalmazásnak továbbítandó argumentumokat tartalmazza. Az alapértelmezett érték egy üres sztring ("").

Példák

Az első példa egy kis alkalmazást (argsecho.exe) hoz létre, amely a konzol argumentumait visszhangozza. A második példa létrehoz egy alkalmazást, amely argsecho.exe hív meg a Arguments tulajdonság különböző változatainak bemutatásához.

// 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

Megjegyzések

A tulajdonsághoz Arguments rendelt sztring hosszának 32 699-nél kisebbnek kell lennie.

Az argumentumokat a célalkalmazás elemzi és értelmezi, ezért igazodnia kell az alkalmazás elvárásaihoz. Az alábbi példákban bemutatott .NET alkalmazások esetében a szóközök elválasztóként vannak értelmezve több argumentum között. A szóközöket tartalmazó argumentumokat idézőjelekkel kell körülvenni, de ezek az idézőjelek nem kerülnek át a célalkalmazásba. Ha idézőjeleket szeretne belefoglalni az utolsó elemzett argumentumba, az egyes jeleket háromszorosára kell feloldani. Ha ezt a tulajdonságot parancssori argumentumok beállítására használja, ArgumentList nem tartalmazhat elemeket.

Arguments és ArgumentList függetlenek egymástól. Ez azt jelenti, hogy a Arguments tulajdonsághoz rendelt sztring nem tölti fel a ArgumentList gyűjteményt, és a ArgumentList gyűjtemény tagjai nincsenek hozzárendelve a Arguments tulajdonsághoz.

Important

Az ilyen típusú példányok nem megbízható adatokkal való használata biztonsági kockázatot jelent. Ezt az objektumot csak megbízható adatokkal használja. További információ: Minden bemenet ellenőrzése.