HOWTO · Csharp
Abrufen des aktuellen Benutzernamens in .NET mit C#
In diesem Artikel erfahren Sie, wie Sie in .NET mit C# den aktuellen Umgebungsbenutzernamen oder den Namen der Windows-Identität auslesen.
Auf dieser Seite
Verwenden Sie in .NET Environment.UserName, um den Benutzernamen abzurufen, der der Umgebung zugeordnet ist, in der Ihr C#-Prozess ausgeführt wird. Wenn Sie gezielt die aktuelle Windows-Identität benötigen, verwenden Sie WindowsIdentity.GetCurrent().Name; zum Lesen einer Prozessumgebungsvariablen verwenden Sie Environment.GetEnvironmentVariable("USERNAME"). Diese Werte beschreiben die Prozessumgebung oder Identität. Sie belegen weder, dass sich eine Person authentifiziert hat, noch dass sie zu einer Aktion berechtigt ist.
Die folgenden Beispiele sind vollständige Programme. Ihre Ausgabe hängt zur Laufzeit vom Konto und von der Prozessumgebung ab; ein bestimmter Beispielbenutzername wird daher nicht vorausgesetzt.
Aktuellen Benutzernamen mit Environment.UserName abrufen
Environment.UserName ist eine Eigenschaft im Namespace System. Sie gibt den Benutzernamen zurück, der der aktuellen Umgebung zugeordnet ist. Wenn Ihre Anwendung genau diesen Wert benötigt, ist dies die direkte Wahl. Die Eigenschaft sagt jedoch nicht aus, ob das Konto auf eine bestimmte Ressource zugreifen darf.
Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
using System;
class Program
{
static void Main()
{
string username = Environment.UserName;
Console.WriteLine($"Current username: {username}");
}
}
Das Programm gibt den Eigenschaftswert mit einer kurzen Beschriftung aus. Der tatsächliche Benutzername stammt aus der Umgebung, in der der Prozess läuft. Er kann sich daher je nach Rechner, Konto und Prozesskonfiguration unterscheiden.
Namen der Windows-Identität mit WindowsIdentity.GetCurrent().Name abrufen
WindowsIdentity.GetCurrent() gibt ein WindowsIdentity-Objekt für die aktuelle Windows-Identität zurück. Die Eigenschaft Name liefert den Kontonamen dieser Identität, unter Windows häufig in einer Form mit Domänenangabe. Dies ist eine Windows-spezifische Identitäts-API. Behandeln Sie ihren Wert nicht auf jeder Plattform und bei jeder Prozesskonfiguration als gleichbedeutend mit dem Umgebungsbenutzernamen.
Führen Sie dieses Beispiel in einer Umgebung aus, die Windows-Identitäten unterstützt:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
using System;
using System.Security.Principal;
class Program
{
static void Main()
{
string identityName = WindowsIdentity.GetCurrent().Name;
Console.WriteLine($"Windows identity: {identityName}");
}
}
Wählen Sie diese API, wenn es ausdrücklich um die aktuelle Windows-Identität geht. Der zurückgegebene Name bezeichnet die aktuelle Identität des Prozesses; für sich genommen führt er keine Berechtigungsprüfung durch. Anwendungen sollten Zugriffe mit dem jeweils passenden Sicherheitsmechanismus steuern, statt sich auf einen angezeigten oder gespeicherten Benutzernamen zu verlassen.
Die Umgebungsvariable USERNAME lesen
Environment.GetEnvironmentVariable("USERNAME") liest die Variable USERNAME aus der Prozessumgebung. Eine Umgebungsvariable kann fehlen oder anders konfiguriert sein; ihr Wert hängt davon ab, wie der Prozess gestartet wurde. Diese API liest die Variable, fragt aber nicht unabhängig davon ein Konto ab und überprüft es auch nicht.
Führen Sie dieses Beispiel aus:
Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.
using System;
class Program
{
static void Main()
{
string username = Environment.GetEnvironmentVariable("USERNAME");
Console.WriteLine(username ?? "USERNAME is not set");
}
}
Der Null-Koaleszenz-Ausdruck liefert eine verständliche Meldung, wenn die Variable nicht verfügbar ist. Er belegt nicht, dass ein vorhandener Wert aktuell oder vertrauenswürdig ist. Verwenden Sie diese Methode, wenn Ihre Anwendung gezielt auf die Prozessvariable USERNAME angewiesen ist, und behandeln Sie ihr Fehlen entsprechend den Anforderungen Ihrer Anwendung.
Die passende API für Ihre Anwendung auswählen
Verwenden Sie Environment.UserName für den Benutzernamen, der der laufenden Umgebung zugeordnet ist. Verwenden Sie WindowsIdentity.GetCurrent().Name, wenn Sie den Kontonamen der aktuellen Windows-Identität benötigen und Ihre Anwendung auf einer Plattform läuft, die diese API unterstützt. Verwenden Sie Environment.GetEnvironmentVariable("USERNAME") nur dann, wenn Sie genau diese Prozessvariable lesen möchten, einschließlich ihres konfigurierten oder fehlenden Werts.
Die drei APIs können unterschiedliche Werte zurückgeben, weil sie verschiedene Quellen darstellen. Ein Prozess kann mit einer Umgebungskonfiguration laufen, die von den Identitätsinformationen abweicht, die Ihre Anwendung erwartet. Außerdem lässt sich das Verhalten von Windows-Identitäten nicht auf alle Plattformen von .NET übertragen. Wählen Sie die API nach dem Wert aus, den Ihre Aufgabe erfordert, und verwenden Sie für Sicherheitsentscheidungen Authentifizierungs- und Autorisierungsmechanismen. Keine dieser Benutzerzeichenfolgen bestätigt für sich genommen, wer mit Ihrer Anwendung interagiert, oder gewährt Zugriff auf geschützte Daten.