Environment.GetCommandLineArgs-Methode

Gibt ein Zeichenfolgenarray mit den Befehlszeilenargumenten für den aktuellen Prozess zurück.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function GetCommandLineArgs As String()
'Usage
Dim returnValue As String()

returnValue = Environment.GetCommandLineArgs

public static string[] GetCommandLineArgs ()

public:
static array<String^>^ GetCommandLineArgs ()

public static String[] GetCommandLineArgs ()

public static function GetCommandLineArgs () : String[]

Rückgabewert

Ein Array von Zeichenfolgen, in dem jedes Element ein Befehlszeilenargument enthält. Das erste Element ist der Name der ausführbaren Datei. Weitere eventuell folgende Elemente enthalten die restlichen Befehlszeilenargumente.

Ausnahmen

Hinweise

Das erste Element des Arrays enthält den Dateinamen des ausgeführten Programms. Wenn der Dateiname nicht verfügbar ist, ist das erste Element gleich String.Empty. Die restlichen Elemente enthalten die zusätzlich in der Befehlszeile eingegebenen Token.

Der Programmdateiname kann optional Pfadangaben enthalten.

Befehlszeilenargumente sind durch Leerräume (LEERTASTE (U+0020) oder ZEICHENTABELLE (U+0009)) getrennt, sofern der Leerraum nicht in Anführungszeichen dargestellt wird (ANFÜHRUNGSZEICHEN, U+0022). Ein Leerraum innerhalb von Anführungszeichen gilt als Teil des zitierten Texts. Das Trennzeichen ist nicht im Befehlszeilenargument enthalten.

Umgekehrte Schrägstriche (UMGEKEHRTER SCHRÄGSTRICH (U+005C)), denen ein Anführungszeichen folgt, werden gesondert interpretiert. Wenn 2n umgekehrten Schrägstrichen ein Anführungszeichen folgt, enthält das Befehlszeilenargument n umgekehrte Schrägstriche, und Beginn und Ende des zitierten Textes werden mit Anführungszeichen gekennzeichnet. Wenn 2n+1 umgekehrten Schrägstrichen ein Anführungszeichen folgt, enthält das Befehlszeilenargument n umgekehrte Schrägstriche und ein Literalanführungszeichen. Wenn n umgekehrten Schrägstrichen kein Anführungszeichen folgt, enthält das Befehlszeilenargument n umgekehrte Schrägstriche.

Verwenden Sie die CommandLine-Eigenschaft, wenn Sie die ganze Befehlszeile als einzelne Zeichenfolge benötigen.

Hinweis zu Windows NT 4.0, Windows 2000: Der Name der ausführbaren Datei enthält keine Pfadangabe.

Hinweis zu Windows 98, Windows Millennium Edition: Der Name der ausführbaren Datei enthält eine Pfadangabe. Lange Dateinamen, die nicht im DOS-Format 8.3 vorliegen, können auf ihre 8.3-Darstellung verkürzt werden.

Beispiel

' Sample for the Environment.GetCommandLineArgs method
Imports System

Class Sample
   Public Shared Sub Main()
      Console.WriteLine()
      '  Invoke this sample with an arbitrary set of command line arguments.
      Dim arguments As [String]() = Environment.GetCommandLineArgs()
      Console.WriteLine("GetCommandLineArgs: {0}", [String].Join(", ", arguments))
   End Sub 'Main
End Class 'Sample
'
'This example produces the following results:
'
'C:\>GetCommandLineArgs ARBITRARY TEXT
'
'GetCommandLineArgs: GetCommandLineArgs, ARBITRARY, TEXT
'

// Sample for the Environment.GetCommandLineArgs method
using System;

class Sample 
{
    public static void Main() 
    {
    Console.WriteLine();
//  Invoke this sample with an arbitrary set of command line arguments.
    String[] arguments = Environment.GetCommandLineArgs();
    Console.WriteLine("GetCommandLineArgs: {0}", String.Join(", ", arguments));
    }
}
/*
This example produces the following results:

C:\>GetCommandLineArgs ARBITRARY TEXT

GetCommandLineArgs: GetCommandLineArgs, ARBITRARY, TEXT
*/

// Sample for the Environment::GetCommandLineArgs method
using namespace System;
int main()
{
   Console::WriteLine();
   
   //  Invoke this sample with an arbitrary set of command line arguments.
   array<String^>^arguments = Environment::GetCommandLineArgs();
   Console::WriteLine( "GetCommandLineArgs: {0}", String::Join( ", ", arguments ) );
}

/*
This example produces the following results:

C:\>GetCommandLineArgs ARBITRARY TEXT

GetCommandLineArgs: GetCommandLineArgs, ARBITRARY, TEXT
*/

// Sample for the Environment.GetCommandLineArgs method
import System.*;

class Sample
{
    public static void main(String[] args)
    {
        Console.WriteLine();
        //  Invoke this sample with an arbitrary set of command line arguments.
        String arguments[] = Environment.GetCommandLineArgs();
        Console.WriteLine("GetCommandLineArgs: {0}", 
            String.Join(", ", arguments));
    } //main
} //Sample

/*
This example produces the following results:

C:\>GetCommandLineArgs ARBITRARY TEXT

GetCommandLineArgs: GetCommandLineArgs, ARBITRARY, TEXT
*/

.NET Framework-Sicherheit

• EnvironmentPermission  für den Zugriff auf die Umgebungsvariable "Path". Zugeordnete Enumeration: EnvironmentPermissionAccess.Read

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Environment-Klasse
Environment-Member
System-Namespace
CommandLine