Aracılığıyla paylaş


Environment.ExpandEnvironmentVariables(String) Yöntem

Tanım

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

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

Özel durumlar

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.

Şunlara uygulanır