Environment.ExpandEnvironmentVariables(String) Methode

Definition

Namespace:
System
Assemblys:
mscorlib.dll, System.Runtime.Extensions.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
Environment.cs
Quelle:
Environment.cs
Quelle:
Environment.cs
Quelle:
Environment.cs
Quelle:
Environment.cs

Ersetzt den Namen jeder Umgebungsvariable, die in der angegebenen Zeichenfolge eingebettet ist, durch die Zeichenfolgenentsprechung des Werts der Variablen und gibt dann die resultierende Zeichenfolge zurück.

public:
 static System::String ^ ExpandEnvironmentVariables(System::String ^ name);
public static string ExpandEnvironmentVariables(string name);
static member ExpandEnvironmentVariables : string -> string
Public Shared Function ExpandEnvironmentVariables (name As String) As String

Parameter

name
String

Eine Zeichenfolge mit den Namen von Null- oder mehr Umgebungsvariablen. Jede Umgebungsvariable wird mit dem Prozentzeichen (%) zitiert.

Gibt zurück

String

Eine Zeichenfolge mit jeder Umgebungsvariable, die durch ihren Wert ersetzt wird.

Ausnahmen

ArgumentNullException

name ist null.

Beispiele

Das folgende Beispiel zeigt, wie Sie die Systemlaufwerk- und Systemstammvariablen abrufen.

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

class Sample
{
    public static void Main()
    {
        // Keep this information secure!
        string query = "My system drive is %SystemDrive% and my system root is %SystemRoot%";

        string str = Environment.ExpandEnvironmentVariables(query);

        Console.WriteLine(str);
    }
}
/*
This example prints:

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

// Sample for the Environment.ExpandEnvironmentVariables method
open System

let nl = Environment.NewLine

//  <-- Keep this information secure! -->
let query = "My system drive is %SystemDrive% and my system root is %SystemRoot%"
let str = Environment.ExpandEnvironmentVariables query
printfn $"\nExpandEnvironmentVariables: {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
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
End Class
'
'This example produces the following results:
'
'ExpandEnvironmentVariables:
'  My system drive is C: and my system root is C:\WINNT
'

Hinweise

COM-Interoperabilität wird verwendet, um die Umgebungsvariablen aus dem Betriebssystem abzurufen. Wenn die Umgebungsvariablen aufgrund eines COM-Fehlers nicht abgerufen werden können, wird das HRESULT, das die Ursache des Fehlers erläutert, verwendet, um eine von mehreren möglichen Ausnahmen zu generieren. d. h., die Ausnahme hängt vom HRESULT ab. Weitere Informationen zur Verarbeitung des HRESULT finden Sie im Abschnitt "Hinweise" der Marshal.ThrowExceptionForHR Methode.

Ersetzung tritt nur für Umgebungsvariablen auf, die festgelegt sind. Angenommen name , "MyENV = %MyENV%". Wenn die Umgebungsvariable MyENV auf 42 festgelegt ist, gibt diese Methode "MyENV = 42" zurück. Wenn MyENV nicht festgelegt ist, tritt keine Änderung auf; diese Methode gibt "MyENV = %MyENV%" zurück.

Die Größe des Rückgabewerts ist auf 32 KB begrenzt.

Gilt für: