Environment.ExpandEnvironmentVariables(String) Methode

Definitie

Naamruimte:
System
Assembly's:
mscorlib.dll, System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
netstandard.dll

Vervangt de naam van elke omgevingsvariabele die is ingesloten in de opgegeven tekenreeks door het tekenreeksequivalent van de waarde van de variabele en retourneert vervolgens de resulterende tekenreeks.

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

Parameters

name
String

Een tekenreeks met de namen van nul of meer omgevingsvariabelen. Elke omgevingsvariabele wordt aangeduid met het procentteken (%).

Retouren

String

Een tekenreeks met elke omgevingsvariabele vervangen door de waarde.

Uitzonderingen

ArgumentNullException

name is null.

Voorbeelden

In het volgende voorbeeld ziet u hoe u de systeemstation- en systeemhoofdvariabelen kunt verkrijgen.

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

Opmerkingen

COM-interoperabiliteit wordt gebruikt om de omgevingsvariabelen op te halen uit het besturingssysteem. Als de omgevingsvariabelen niet kunnen worden opgehaald vanwege een COM-fout, wordt hresult dat de oorzaak van de fout verklaart, gebruikt om een van de mogelijke uitzonderingen te genereren; Dat wil gezegd, de uitzondering is afhankelijk van het HRESULT. Zie de sectie Opmerkingen van de Marshal.ThrowExceptionForHR methode voor meer informatie over hoe HRESULT wordt verwerkt.

Vervanging vindt alleen plaats voor omgevingsvariabelen die zijn ingesteld. Stel dat name 'MyENV = %MyENV%' is. Als de omgevingsvariabele MyENV is ingesteld op 42, retourneert deze methode 'MyENV = 42'. Als MyENV niet is ingesteld, treedt er geen wijziging op; met deze methode wordt 'MyENV = %MyENV%' geretourneerd.

De grootte van de retourwaarde is beperkt tot 32.000.

Van toepassing op