Environment.ExpandEnvironmentVariables(String) Metódus

Definíció

Névtér:

System

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

Environment.cs

A megadott sztringbe beágyazott környezeti változók nevét lecseréli a változó értékének megfelelő karakterláncra, majd visszaadja az eredményül kapott sztringet.

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

Paraméterek

name

String

Nulla vagy több környezeti változó nevét tartalmazó sztring. A rendszer minden környezeti változót a százalékjel karakterrel (%) idéz.

Válaszok

String

Egy sztring, amelynek minden környezeti változóját az értéke váltja fel.

Kivételek

ArgumentNullException

name az null.

Példák

Az alábbi példa bemutatja, hogyan szerezheti be a rendszermeghajtót és a rendszer gyökérváltozóit.

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

Megjegyzések

A COM interop használatával lekérhetők a környezeti változók az operációs rendszerből. Ha a környezeti változók com-hiba miatt nem kérhetők le, a hiba okát magyarázó HRESULT a lehetséges kivételek egyikének létrehozására szolgál; vagyis a kivétel a HRESULT függvénytől függ. A HRESULT feldolgozásával kapcsolatos további információkért tekintse meg a módszer Megjegyzések szakaszát Marshal.ThrowExceptionForHR .

Csak a beállított környezeti változók esetében történik csere. Tegyük fel például, hogy name "MyENV = %MyENV%". Ha a MyENV környezeti változó értéke 42, akkor ez a metódus a "MyENV = 42" értéket adja vissza. Ha a MyENV nincs beállítva, nem történik változás; ez a metódus a "MyENV = %MyENV%" értéket adja vissza.

A visszatérési érték mérete legfeljebb 32K lehet.