Console.ForegroundColor Vlastnost

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Console.dll

Zdroj:

Console.cs

Získá nebo nastaví barvu popředí konzoly.

[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static ConsoleColor ForegroundColor { get; set; }

Hodnota vlastnosti

ConsoleColor

Určuje ConsoleColor barvu popředí konzoly, tj. barvu každého zobrazeného znaku. Výchozí hodnota je šedá.

Atributy

UnsupportedOSPlatformAttribute

Výjimky

ArgumentException

Barva zadaná v operaci set není platným členem .ConsoleColor

SecurityException

Uživatel nemá oprávnění k provedení této akce.

IOException

Došlo k vstupně-výstupní chybě.

Příklady

Následující příklad zkontroluje, jestli je barva pozadí konzoly černá, a pokud ano, změní barvu pozadí na červenou a barvu popředí na černou.

using System;

public class Example
{
   public static void Main()
   {
      if (Console.BackgroundColor == ConsoleColor.Black) {
         Console.BackgroundColor = ConsoleColor.Red;
         Console.ForegroundColor = ConsoleColor.Black;
         Console.Clear();
      }
   }
}

Následující příklad uloží hodnoty výčtu ConsoleColor do pole a uloží aktuální hodnoty BackgroundColor vlastností a ForegroundColor do proměnných. Potom změní barvu popředí na každou barvu ve výčtu ConsoleColor s výjimkou barvy, která odpovídá aktuálnímu pozadí, a změní barvu pozadí na každou barvu ve ConsoleColor výčtu s výjimkou barvy, která odpovídá aktuálnímu popředí. (Pokud je barva popředí stejná jako barva pozadí, text není viditelný.) Nakonec volá metodu ResetColor obnovení původních barev konzoly.

using System;

class Example
{
   public static void Main()
   {
      // Get an array with the values of ConsoleColor enumeration members.
      ConsoleColor[] colors = (ConsoleColor[]) ConsoleColor.GetValues(typeof(ConsoleColor));
      // Save the current background and foreground colors.
      ConsoleColor currentBackground = Console.BackgroundColor;
      ConsoleColor currentForeground = Console.ForegroundColor;

      // Display all foreground colors except the one that matches the background.
      Console.WriteLine("All the foreground colors except {0}, the background color:",
                        currentBackground);
      foreach (var color in colors) {
         if (color == currentBackground) continue;

         Console.ForegroundColor = color;
         Console.WriteLine("   The foreground color is {0}.", color);
      }
      Console.WriteLine();
      // Restore the foreground color.
      Console.ForegroundColor = currentForeground;

      // Display each background color except the one that matches the current foreground color.
      Console.WriteLine("All the background colors except {0}, the foreground color:",
                        currentForeground);
      foreach (var color in colors) {
         if (color == currentForeground) continue;

         Console.BackgroundColor = color;
         Console.WriteLine("   The background color is {0}.", color);
      }

      // Restore the original console colors.
      Console.ResetColor();
      Console.WriteLine("\nOriginal colors restored...");
   }
}
//The example displays output like the following:
//    All the foreground colors except DarkCyan, the background color:
//       The foreground color is Black.
//       The foreground color is DarkBlue.
//       The foreground color is DarkGreen.
//       The foreground color is DarkRed.
//       The foreground color is DarkMagenta.
//       The foreground color is DarkYellow.
//       The foreground color is Gray.
//       The foreground color is DarkGray.
//       The foreground color is Blue.
//       The foreground color is Green.
//       The foreground color is Cyan.
//       The foreground color is Red.
//       The foreground color is Magenta.
//       The foreground color is Yellow.
//       The foreground color is White.
//
//    All the background colors except White, the foreground color:
//       The background color is Black.
//       The background color is DarkBlue.
//       The background color is DarkGreen.
//       The background color is DarkCyan.
//       The background color is DarkRed.
//       The background color is DarkMagenta.
//       The background color is DarkYellow.
//       The background color is Gray.
//       The background color is DarkGray.
//       The background color is Blue.
//       The background color is Green.
//       The background color is Cyan.
//       The background color is Red.
//       The background color is Magenta.
//       The background color is Yellow.
//
//    Original colors restored...

Poznámky

Operace get pro aplikaci se systémem Windows, ve které neexistuje konzola, vrátí Gray. Unixové systémy neposkytují žádný obecný mechanismus pro načtení aktuálních barev konzoly. Z tohoto důvodu vrací hodnotu(ConsoleColor)-1, ForegroundColor dokud není nastavena explicitně (pomocí setter).

Platí pro