Environment.ExpandEnvironmentVariables(String) Metodo

Definizione

Spazio dei nomi:
System
Assembly:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origine:
Environment.cs
Origine:
Environment.cs
Origine:
Environment.cs
Origine:
Environment.cs
Origine:
Environment.cs

Sostituisce il nome di ogni variabile di ambiente incorporata nella stringa specificata con la stringa equivalente al valore della variabile, quindi restituisce la stringa risultante.

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

Parametri

name
String

Stringa contenente i nomi di zero o più variabili di ambiente. Ogni variabile di ambiente è racchiusa tra virgolette con il carattere di segno percentuale (%).

Valori restituiti

String

Stringa con ogni variabile di ambiente sostituita dal relativo valore.

Eccezioni

ArgumentNullException

name è null.

Esempio

Nell'esempio seguente viene illustrato come ottenere l'unità di sistema e le variabili radice del sistema.

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

Commenti

L'interoperabilità COM viene usata per recuperare le variabili di ambiente dal sistema operativo. Se le variabili di ambiente non possono essere recuperate a causa di un errore COM, hresult che spiega la causa dell'errore viene usata per generare una delle diverse eccezioni possibili; ovvero, l'eccezione dipende dal valore HRESULT. Per altre informazioni sull'elaborazione di HRESULT, vedere la sezione Osservazioni del Marshal.ThrowExceptionForHR metodo .

La sostituzione viene eseguita solo per le variabili di ambiente impostate. Si supponga, ad esempio, che name sia "MyENV = %MyENV%". Se la variabile di ambiente MyENV è impostata su 42, questo metodo restituisce "MyENV = 42". Se MyENV non è impostato, non viene apportata alcuna modifica; questo metodo restituisce "MyENV = %MyENV%".

Le dimensioni del valore restituito sono limitate a 32.000.

Si applica a