Freigeben über

Environment.ExpandEnvironmentVariables-Methode

  • Artikel

Ersetzt den Namen aller Umgebungsvariablen, die in die angegebene Zeichenfolge eingebettet sind, durch die Zeichenfolgenentsprechung für den Wert der Variablen, und gibt anschließend das Ergebnis als Zeichenfolge zurück.

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

Syntax

'Declaration
Public Shared Function ExpandEnvironmentVariables ( _
    name As String _
) As String
'Usage
Dim name As String
Dim returnValue As String

returnValue = Environment.ExpandEnvironmentVariables(name)

public static string ExpandEnvironmentVariables (
    string name
)

public:
static String^ ExpandEnvironmentVariables (
    String^ name
)

public static String ExpandEnvironmentVariables (
    String name
)

public static function ExpandEnvironmentVariables (
    name : String
) : String

Parameter

  • name
    Eine Zeichenfolge, die Namen von 0 (null) oder mehr Umgebungsvariablen enthält. Jede Umgebungsvariable steht zwischen Prozentzeichen (%).

Rückgabewert

Eine Zeichenfolge, bei der alle Umgebungsvariablen durch ihren Wert ersetzt wurden.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

name ist NULL (Nothing in Visual Basic).

Hinweise

COM-Interop wird zum Abrufen der Umgebungsvariablen des Betriebssystems verwendet. Wenn die Umgebungsvariablen aufgrund eines COM-Fehlers nicht abgerufen werden können, wird mithilfe des HRESULT, in dem die Ursache des Fehlers erläutert wird, eine von mehreren möglichen Ausnahmen generiert, d. h., die Ausnahme ist abhängig vom HRESULT. Weitere Informationen über das Verarbeiten von HRESULT finden Sie im Abschnitt "Hinweise" unter der Marshal.ThrowExceptionForHR-Methode.

Eine Ersetzung findet nur bei Umgebungsvariablen statt, die festgelegt sind. Angenommen, name hat den Wert "MyENV = %MyENV%". Wenn die Umgebungsvariable MyENV auf 42 festgelegt wurde, gibt diese Methode "MyENV = 42" zurück. Wenn MyENV nicht festgelegt wurde, werden keine Änderungen durchgeführt, und diese Methode gibt "MyENV = %MyENV%" zurück.

Die Größe des Rückgabewerts ist unter Windows NT 4.0 und früheren Versionen sowie unter Windows 2000 und höher auf 32 KB beschränkt. Unter Windows 98 und Windows Me gibt es keine Größeneinschränkung.

Beispiel

' Sample for the Environment.ExpandEnvironmentVariables method
Imports System

Class Sample
   Public Shared Sub Main()
      Dim str As [String]
      Dim nl As [String] = Environment.NewLine
      
      Console.WriteLine()
      '  <-- Keep this information secure! -->
      Dim query As [String] = "My system drive is %SystemDrive% and" & _ 
                              "my system root is %SystemRoot%"
      str = Environment.ExpandEnvironmentVariables(query)
      Console.WriteLine("ExpandEnvironmentVariables: {0}  {1}", nl, str)
   End Sub 'Main
End Class 'Sample
'
'This example produces the following results:
'
'ExpandEnvironmentVariables:
'  My system drive is C: and my system root is C:\WINNT
'

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

class Sample 
{
    public static void Main() 
    {
    String str;
    String nl = Environment.NewLine;

    Console.WriteLine();
//  <-- Keep this information secure! -->
    String query = "My system drive is %SystemDrive% and my system root is %SystemRoot%";
    str = Environment.ExpandEnvironmentVariables(query);
    Console.WriteLine("ExpandEnvironmentVariables: {0}  {1}", nl, str);
    }
}
/*
This example produces the following results:

ExpandEnvironmentVariables:
  My system drive is C: and my system root is C:\WINNT
*/

// Sample for the Environment::ExpandEnvironmentVariables method
using namespace System;
int main()
{
   String^ str;
   String^ nl = Environment::NewLine;
   Console::WriteLine();
   
   //  <-- Keep this information secure! -->
   String^ query = "My system drive is %SystemDrive% and my system root is %SystemRoot%";
   str = Environment::ExpandEnvironmentVariables( query );
   Console::WriteLine( "ExpandEnvironmentVariables: {0} {1}", nl, str );
}

/*
This example produces the following results:

ExpandEnvironmentVariables:
My system drive is C: and my system root is C:\WINNT
*/

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

class Sample
{
    public static void main(String[] args)
    {
        String str;
        String nl = Environment.get_NewLine();

        Console.WriteLine();
        //  <-- Keep this information secure! -->
        String query = "My system drive is %SystemDrive% and my"
            + " system root is %SystemRoot%";
        str = Environment.ExpandEnvironmentVariables(query);
        Console.WriteLine("ExpandEnvironmentVariables: {0}  {1}", nl, str);
    } //main
} //Sample

/*
This example produces the following results:

ExpandEnvironmentVariables:
  My system drive is C: and my system root is C:\WINDOWS
*/

.NET Framework-Sicherheit

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