Environment.GetFolderPath Methode

Definition

Ruft den Pfad des durch die angegebene Enumeration bezeichneten besonderen Systemordners ab.Gets the path to the system special folder that is identified by the specified enumeration.

Überlädt

GetFolderPath(Environment+SpecialFolder)

Ruft den Pfad des durch die angegebene Enumeration bezeichneten besonderen Systemordners ab.Gets the path to the system special folder that is identified by the specified enumeration.

GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)

Ruft den Pfad zum besonderen Systemordner ab, der von der angegebenen Enumeration bezeichnet wird, und verwendet eine angegebene Option zum Zugreifen auf besondere Ordner.Gets the path to the system special folder that is identified by the specified enumeration, and uses a specified option for accessing special folders.

GetFolderPath(Environment+SpecialFolder)

Ruft den Pfad des durch die angegebene Enumeration bezeichneten besonderen Systemordners ab.Gets the path to the system special folder that is identified by the specified enumeration.

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 eine besonderen Systemordner bezeichnen.One of enumeration values that identifies a system special folder.

Gibt zurück

Der Pfad zum angegebenen besonderen Systemordner, sofern dieser auf dem Computer physisch vorhanden ist, andernfalls eine leere Zeichenfolge ("").The path to the specified system special folder, if that folder physically exists on your computer; otherwise, an empty string ("").

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.A folder will not physically exist if the operating system did not create it, the existing folder was deleted, or the folder is a virtual directory, such as My Computer, which does not correspond to a physical path.

Ausnahmen

folder ist kein Member von Environment.SpecialFolder.folder is not a member of Environment.SpecialFolder.

Die aktuelle Plattform wird nicht unterstützt.The current platform is not supported.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die GetFolderPath-Methode verwendet wird, um den Pfad zurückzugeben und anzuzeigen, der dem folder-Parameter zugeordnet ist.The following example demonstrates how to use the GetFolderPath method to return and display the path associated with the folder parameter.

// 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
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. Programmdateien, Programme, System oder Start, mit dem auf allgemeine Informationen zugegriffen werden kann.This method retrieves the path to a system special folder, such as Program Files, Programs, System, or Startup, which can be used to access common information. Besondere Ordner werden standardmäßig vom System oder explizit durch den Benutzer festgelegt, wenn eine Version von Windows installiert wird.Special folders are set by default by the system, or explicitly by the user, when installing a version of Windows.

Der folder-Parameter legt den speziellen Ordner fest, der abgerufen werden soll, und muss einer der Werte in der Environment.SpecialFolder-Enumeration sein. jeder andere Wert löst eine Ausnahme aus.The folder parameter designates the special folder to retrieve and must be one of the values in the Environment.SpecialFolder enumeration; any other value throws an exception.

Weitere Informationen zu speziellen Ordnern finden Sie im Thema CSIDL values.For more information about special folders, see the CSIDL values topic.

Sicherheit

FileIOPermission
für den Zugriff auf die Informationen im Pfad selbst.for access to the information in the path itself. Zugehörige Enumeration: PathDiscoveryAssociated enumeration: PathDiscovery

GetFolderPath(Environment+SpecialFolder, Environment+SpecialFolderOption)

Ruft den Pfad zum besonderen Systemordner ab, der von der angegebenen Enumeration bezeichnet wird, und verwendet eine angegebene Option zum Zugreifen auf besondere Ordner.Gets the path to the system special folder that is identified by the specified enumeration, and uses a specified option for accessing special folders.

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.One of the enumeration values that identifies a system special folder.

option
Environment.SpecialFolderOption

Einer der Enumerationswerte, die Optionen zum Zugreifen auf einen besonderen Ordner angeben.One of the enumeration values that specifies options to use for accessing a special folder.

Gibt zurück

Der Pfad zum angegebenen besonderen Systemordner, sofern dieser auf dem Computer physisch vorhanden ist, andernfalls eine leere Zeichenfolge ("").The path to the specified system special folder, if that folder physically exists on your computer; otherwise, an empty string ("").

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.A folder will not physically exist if the operating system did not create it, the existing folder was deleted, or the folder is a virtual directory, such as My Computer, which does not correspond to a physical path.

Ausnahmen

folder ist kein Member von Environment.SpecialFolder.folder is not a member of Environment.SpecialFolder. - oder --or-

options ist kein Member von Environment.SpecialFolderOption.options is not a member of Environment.SpecialFolderOption.

Die aktuelle Plattform wird nicht unterstützt.The current platform is not supported.

Hinweise

Diese Methode ruft den Pfad zu einem speziellen Systemordner ab, z. b. Programmdateien, Programme, System oder Start, mit dem auf allgemeine Informationen zugegriffen werden kann.This method retrieves the path to a system special folder, such as Program Files, Programs, System, or Startup, which can be used to access common information. Besondere Ordner werden standardmäßig vom System oder explizit durch den Benutzer festgelegt, wenn eine Version von Windows installiert wird.Special folders are set by default by the system, or explicitly by the user, when installing a version of Windows.

Der folder-Parameter legt den speziellen Ordner fest, der abgerufen werden soll, und muss einer der Werte in der Environment.SpecialFolder-Enumeration sein. jeder andere Wert löst eine Ausnahme aus.The folder parameter designates the special folder to retrieve and must be one of the values in the Environment.SpecialFolder enumeration; any other value throws an exception.

Weitere Informationen zu speziellen Ordnern finden Sie im Thema CSIDL values.For more information about special folders, see the CSIDL values topic.

Sicherheit

FileIOPermission
für den Zugriff auf die Informationen im Pfad selbst.for access to the information in the path itself. Zugehörige Enumeration: PathDiscoveryAssociated enumeration: PathDiscovery

Gilt für: