Environment.ExpandEnvironmentVariables(String) Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Environment.cs

Belirtilen dizeye katıştırılmış her ortam değişkeninin adını değişkenin değerinin dize eşdeğeriyle değiştirir, ardından sonuçta elde edilen dizeyi döndürür.

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

Parametreler

name

String

Sıfır veya daha fazla ortam değişkeninin adını içeren bir dize. Her ortam değişkeni yüzde işareti karakteri (%) ile tırnak içine alınır.

Döndürülenler

String

Her ortam değişkeninin değeriyle değiştirdiği bir dize.

Özel durumlar

ArgumentNullException

name, null değeridir.

Örnekler

Aşağıdaki örnekte, sistem sürücüsünün ve sistem kök değişkenlerinin nasıl elde edilir gösterilmektedir.

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

Açıklamalar

COM birlikte çalışma, işletim sisteminden ortam değişkenlerini almak için kullanılır. Ortam değişkenleri com hatası nedeniyle alınamıyorsa, hatanın nedenini açıklayan HRESULT birkaç olası özel durumdan birini oluşturmak için kullanılır; yani özel durum HRESULT'a bağlıdır. HRESULT'un nasıl işlendiği hakkında daha fazla bilgi için yönteminin Açıklamalar bölümüne Marshal.ThrowExceptionForHR bakın.

Değiştirme yalnızca ayarlanan ortam değişkenleri için gerçekleşir. Örneğin, "MyENV = %MyENV%" olduğunu varsayalım name . MyENV ortam değişkeni 42 olarak ayarlanırsa, bu yöntem "MyENV = 42" döndürür. MyENV ayarlanmamışsa hiçbir değişiklik olmaz; bu yöntem "MyENV = %MyENV%" döndürür.

Dönüş değerinin boyutu 32K ile sınırlıdır.