Environment.GetFolderPath Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Ruft den Pfad des durch die angegebene Enumeration bezeichneten besonderen Systemordners ab.

Überlädt

GetFolderPath(Environment+SpecialFolder)	Ruft den Pfad zum angegebenen systemspezifischen Ordner ab.
GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)	Ruft den Pfad zum angegebenen systemspezifischen Ordner mithilfe einer angegebenen Option für den Zugriff auf spezielle Ordner ab.

GetFolderPath(Environment+SpecialFolder)

Ruft den Pfad zum angegebenen systemspezifischen Ordner ab.

public:
 static System::String ^ GetFolderPath(Environment::SpecialFolder folder);

public static string GetFolderPath (Environment.SpecialFolder folder);

static member GetFolderPath : Environment.SpecialFolder -> string

Public Shared Function GetFolderPath (folder As Environment.SpecialFolder) As String

Parameter

folder

Environment.SpecialFolder

Einer der Enumerationswerte, die einen besonderen Systemordner bezeichnen.

Gibt zurück

String

Der Pfad zum angegebenen besonderen Systemordner, sofern dieser auf dem Computer physisch vorhanden ist, andernfalls eine leere Zeichenfolge ("").

Ein Ordner ist physisch nicht vorhanden, wenn er nicht vom Betriebssystem erstellt wurde, wenn der vorhandene Ordner gelöscht wurde oder wenn der Ordner ein virtuelles Verzeichnis ist, z. B. Arbeitsplatz, das keinem physischen Pfad entspricht.

Ausnahmen

ArgumentException

folder ist kein Member von Environment.SpecialFolder.

PlatformNotSupportedException

Die aktuelle Plattform wird nicht unterstützt.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die GetFolderPath -Methode verwenden, um den dem folder Parameter zugeordneten Pfad zurückzugeben und anzuzeigen.

// Sample for the Environment::GetFolderPath method
using namespace System;
int main()
{
   Console::WriteLine();
   Console::WriteLine( "GetFolderPath: {0}", Environment::GetFolderPath( Environment::SpecialFolder::System ) );
}

/*
This example produces the following results:

GetFolderPath: C:\WINNT\System32
*/

// Sample for the Environment.GetFolderPath method
using System;

class Sample
{
    public static void Main()
    {
    Console.WriteLine();
    Console.WriteLine("GetFolderPath: {0}",
                 Environment.GetFolderPath(Environment.SpecialFolder.System));
    }
}
/*
This example produces the following results:

GetFolderPath: C:\WINNT\System32
*/

// Sample for the Environment.GetFolderPath method
open System

printfn $"\nGetFolderPath: {Environment.GetFolderPath Environment.SpecialFolder.System}"
            
// This example produces the following results:
//     GetFolderPath: C:\WINNT\System32

' Sample for the Environment.GetFolderPath method
Class Sample
   Public Shared Sub Main()
      Console.WriteLine()
      Console.WriteLine("GetFolderPath: {0}", Environment.GetFolderPath(Environment.SpecialFolder.System))
   End Sub
End Class
'
'This example produces the following results:
'
'GetFolderPath: C:\WINNT\System32
'

Hinweise

Diese Methode ruft den Pfad zu einem speziellen Systemordner ab, z. B. Programme, System oder Start, der für den Zugriff auf allgemeine Informationen verwendet werden kann. Spezielle Ordner werden standardmäßig vom System oder explizit vom Benutzer festgelegt, wenn eine Version von Windows installiert wird.

Der folder Parameter legt den abzurufenden speziellen Ordner fest und muss einer der Werte in der Environment.SpecialFolder Enumeration sein. Jeder andere Wert löst eine Ausnahme aus.

Weitere Informationen zu speziellen Ordnern finden Sie unter Liste der konstanten Spezialelement-ID (CSIDL).

Weitere Informationen

• GetFolderPath-Verhalten unter Unix

GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)

Ruft den Pfad zum angegebenen systemspezifischen Ordner mithilfe einer angegebenen Option für den Zugriff auf spezielle Ordner ab.

public:
 static System::String ^ GetFolderPath(Environment::SpecialFolder folder, Environment::SpecialFolderOption option);

public static string GetFolderPath (Environment.SpecialFolder folder, Environment.SpecialFolderOption option);

static member GetFolderPath : Environment.SpecialFolder * Environment.SpecialFolderOption -> string

Public Shared Function GetFolderPath (folder As Environment.SpecialFolder, option As Environment.SpecialFolderOption) As String

Parameter

folder

Environment.SpecialFolder

Einer der Enumerationswerte, die einen besonderen Systemordner bezeichnen.

option

Environment.SpecialFolderOption

Einer der Enumerationswerte, die Optionen zum Zugreifen auf einen besonderen Ordner angeben.

Gibt zurück

String

Der Pfad zum angegebenen besonderen Systemordner, sofern dieser auf dem Computer physisch vorhanden ist, andernfalls eine leere Zeichenfolge ("").

Ein Ordner ist physisch nicht vorhanden, wenn er nicht vom Betriebssystem erstellt wurde, wenn der vorhandene Ordner gelöscht wurde oder wenn der Ordner ein virtuelles Verzeichnis ist, z. B. Arbeitsplatz, das keinem physischen Pfad entspricht.

Ausnahmen

ArgumentException

folder ist kein Member von Environment.SpecialFolder.

- oder -

options ist kein Member von Environment.SpecialFolderOption.

PlatformNotSupportedException

Die aktuelle Plattform wird nicht unterstützt.

Hinweise

Diese Methode ruft den Pfad zu einem speziellen Systemordner ab, z. B. Programme, System oder Start, der für den Zugriff auf allgemeine Informationen verwendet werden kann. Spezielle Ordner werden standardmäßig vom System oder explizit vom Benutzer festgelegt, wenn eine Version von Windows installiert wird.

Der folder Parameter legt den abzurufenden speziellen Ordner fest und muss einer der Werte in der Environment.SpecialFolder Enumeration sein. Jeder andere Wert löst eine Ausnahme aus.

Weitere Informationen zu speziellen Ordnern finden Sie unter Liste der konstanten Spezialelement-ID (CSIDL).

Weitere Informationen

• GetFolderPath-Verhalten unter Unix