Code-Beispiel
Ein Beispiel zum Einsatz der Klasse System.Environment aus der .NET-Klassenbibliothek.
Autor: Dr. Holger Schwichtenberg
Beschreibung
Diese Klasse stellt verschiedene Informationen über das Betriebssystem und die aktuelle Anwendung bereit. Die folgende Tabelle listet alle wichtigen Attribute und Methoden der Klasse System.Environment auf.
Attribut Erläuterung
UserName Name des angemeldeten Benutzers
UserDomainName Name der Domäne, zu der der angemeldete Benutzer gehört
MaschineName Name des Computers
UserInteractive Liefert wahr, wenn der Benutzer interaktiv an Windows angemeldet ist. Liefert falsch, wenn die Anwendung ein Dienst oder eine Web-Anwendung ist.
CommandLine Name und Pfad der Anwendung
GetCommandLineArgs() Liefert ein Array of String der übergebenen Kommandozeilenparameter
WorkingSet Menge des allokierten Speichers für diese Anwendung
StackTrace Zeichenkette mit Informationen über die aktuelle Aufrufhierarchie
StackTrace() liefert die Aufrufreihenfolge der Unterroutinen bis zum aktuellen Punkt in einem Programm in Form eines Strings. Diese Information ist identisch mit den Daten, die Sie bei einem Laufzeitfehler von der CLR erhalten. Das Programm wird aber durch den Aufruf von StackTrace() nicht abgebrochen.
SystemDirectory Pfad zum Systemverzeichnis
CurrentDirecto Pfad zum aktuellen Verzeichnis
GetFolderPath(SONDERORDNER_TYP) Liefert den Pfad eines bestimmten Sonderordners
NewLine Informationen über das Trennzeichen, das auf der jeweiligen Plattform dazu dienen, Zeilenumbrüche in Zeichenketten zu definieren
TickCount Anzahl der vergangenen Millisekunden seit Systemstart
GetEnvironmentVariables() Liefert eine Collection mit DirectionaryEntry-Objekten für alle Umgebungsvariablen
GetEnvironmentVariable(VAR) Liefert den Wert einer bestimmten Umgebungsvariablen
ExpandEnvironmentVariables(STRING) Ersetzt alle Umgebungsvariablen in dem angegebenen String
OSVersion Das Attribut OSVersion bietet den Zugriff auf ein Unterobjekt vom Typ OperatingSystem. Diese Klasse implementiert zwei Attribute:
Plattform: Typ des Betriebssystems (DOS-basiert oder NT-basiert)
Version: Version des Betriebssystems
Version Version der CLR
GetLogicalDrives() GetLogicalDrives() liefert die Namen der logischen Laufwerke auf dem System in Form eines Arrays von String-Werten.
ExitCode Attribut zum Setzen des Rückgabewertes der Anwendung
Exit() Beenden der Anwendung
Instanziierung
Alle Mitglieder der Klasse Environment sind statisch. Daher muss die Klasse nicht instanziiert werden. Sie verhält sich wie ein Intrinsic Object. Um auf diese Instanz unter anderem Namen zugreifen zu können, reicht die einfache Deklaration eines Objekts vom Typ System.Environment.
Beispiel
Das folgende Listing zeigt die Ausgabe der wichtigsten Informationen zur Klasse Environment. Bitte beachten Sie, dass die Attribute Version und OSVersion.Version Objekte vom Typ System.Version liefern. Zur Ausgabe müssen Sie die toString()-Methode verwenden.
Programmcodebeispiele Visual Basic .NET (VB.NET)
' ============================
' .NET-Code-Beispiel in Visual Basic .NET
' Ausgabe von Informationen über System und Prozess
' (C) Holger@Schwichtenberg.de
' ============================
Sub env_test()
Dim e As Environment
Dim o As DictionaryEntry
Dim s As String
' --- Verschiedenes
say("ASCII-Wert des Zeilenumbruchs:" & Asc(e.NewLine))
' --- Zeitinfos
say("ms seit Systemstart:" & e.TickCount)
' --- Benutzerinfos
say("Computer: " & e.MachineName)
say("Benutzer: " & e.UserName)
say("Domäne: " & e.UserDomainName)
say("Interaktiv? " & e.UserInteractive)
' --- Anwendungs-Infos
say("Aufruf: " & e.CommandLine)
say("Aufruf-Parameter:")
For Each s In e.GetCommandLineArgs
out("- " & s)
Next
say("Allokierter Speicher: " & e.WorkingSet)
say("Anwendungsversion: " & e.Version.ToString)
say("Stacktrace:")
say(e.StackTrace)
' --- Verzeichnisinfos
say("Systemverzeichnis: " & e.SystemDirectory)
say("Aktuelles Verzeichnis:" & e.CurrentDirectory)
say("Logische Laufwerke:")
For Each s In e.GetLogicalDrives()
say("- " & s)
Next
' --- Plattform-Infos
say("Plattform-Typ:" & e.OSVersion.Platform)
say("CLR Version: " & e.OSVersion.Version.ToString)
' --- Umgebungsvariablen
say("Spezielle Umgebungsvariablen")
say(e.GetEnvironmentVariable("Path"))
say(e.ExpandEnvironmentVariables("Betriebssystem = %OS%"))
say("Alle Umgebungsvariablen")
For Each o In e.GetEnvironmentVariables
say(" - " & CStr(o.Key) & "=" & CStr(o.Value))
Next
End Sub
Programmcodebeispiele CSharp (C#)
using System;
using System.Collections;
using FCL_Buch;
namespace FCLBuch.System {
public class Samples_Environment {
public void EnvironmentTest() {
ArrayList result = new ArrayList();
// Verschiedenes
//FclOutput.PrintOut("ASCII-Wert des Zeilenumbruchs:" + (int)(Environment.NewLine));
// Zeitinfos
FclOutput.PrintOut( "ms seit Systemstart:" + Environment.TickCount.ToString() );
// Benutzerinfos
FclOutput.PrintOutSubHeader("Benutzerinformationen");
FclOutput.PrintOut( "Computer: " + Environment.MachineName );
FclOutput.PrintOut( "Benutzer: " + Environment.UserName );
FclOutput.PrintOut( "Domäne: " + Environment.UserDomainName );
FclOutput.PrintOut( "Interaktiv? " + Environment.UserInteractive );
// Anwendungs-Infos
FclOutput.PrintOutSubHeader("Anwendungsinformationen");
FclOutput.PrintOut("Aufruf: " + Environment.CommandLine);
FclOutput.PrintOut("Aufruf-Parameter:");
foreach ( string s in Environment.GetCommandLineArgs() )
FclOutput.PrintOut("- " + s);
FclOutput.PrintOut("Allokierter Speicher: " + Environment.WorkingSet);
FclOutput.PrintOut("Anwendungsversion: " + Environment.Version.ToString());
FclOutput.PrintOut("Stacktrace:");
FclOutput.PrintOut(Environment.StackTrace);
// Verzeichnisinfos
FclOutput.PrintOutSubHeader("Verzeichnisinformationen");
FclOutput.PrintOut("Systemverzeichnis: " + Environment.SystemDirectory);
FclOutput.PrintOut("Aktuelle Verzeichnis:" + Environment.CurrentDirectory);
FclOutput.PrintOut("Logische Laufwerke:");
foreach ( string s in Environment.GetLogicalDrives() )
FclOutput.PrintOut("- " + s);
// Plattform-Infos
FclOutput.PrintOutSubHeader("Plattforminformationen");
FclOutput.PrintOut("Plattform-Typ:" + Environment.OSVersion.Platform);
FclOutput.PrintOut("CLR Version: " + Environment.OSVersion.Version.ToString() );
// Umgebungsvariablen
FclOutput.PrintOutSubHeader("Umgebungsvariablen");
FclOutput.PrintOut("Spezielle Umgebungsvariablen");
FclOutput.PrintOut(Environment.GetEnvironmentVariable("Path"));
FclOutput.PrintOut(Environment.ExpandEnvironmentVariables("Betriebssystem = %OS%"));
FclOutput.PrintOut("Alle Umgebungsvariablen");
foreach ( DictionaryEntry o in Environment.GetEnvironmentVariables() )
FclOutput.PrintOut(" - " + ((string)o.Key) + "=" + ((string)o.Value) );
}
}
}
Hinweise
Ausgaben werden in den Beispielen durch Hilfsroutinen wie out() und
PrintOut() erzeugt. Diese sind hier nicht angegeben, da deren Implementierung
von der jeweiligen Umgebung abhängt. Für Konsolenanwendungen können hier z.B.
Console.WriteLine() einsetzen.
Querverweise
Liste aller Codebeispiele
Definition '.NET Framework Class Library'
Verfügbarkeit der Klasse 'System.Environment'
Übersicht über den FCL-Namensraum 'System'
.NET & Visual Studio Community Portal