Console.ForegroundColor Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a cor do primeiro plano do console.
public:
static property ConsoleColor ForegroundColor { ConsoleColor get(); void set(ConsoleColor value); };
public static ConsoleColor ForegroundColor { get; set; }
static member ForegroundColor : ConsoleColor with get, set
Public Shared Property ForegroundColor As ConsoleColor
Valor da propriedade
Um ConsoleColor que especifica a cor do primeiro plano do console; ou seja, a cor de cada caractere exibido. O padrão é cinza.
Exceções
A cor especificada em uma operação de conjunto não é um membro válido de ConsoleColor.
O usuário não tem permissão para executar esta ação.
Ocorreu um erro de E/S.
Exemplos
O exemplo a seguir verifica se a cor da tela de fundo do console é preta e, se estiver, altera a cor da tela de fundo para vermelho e a cor do primeiro plano para preto.
using System;
public class Example
{
public static void Main()
{
if (Console.BackgroundColor == ConsoleColor.Black) {
Console.BackgroundColor = ConsoleColor.Red;
Console.ForegroundColor = ConsoleColor.Black;
Console.Clear();
}
}
}
open System
if Console.BackgroundColor = ConsoleColor.Black then
Console.BackgroundColor <- ConsoleColor.Red
Console.ForegroundColor <- ConsoleColor.Black
Console.Clear()
Module Example
Public Sub Main()
If Console.BackgroundColor = ConsoleColor.Black Then
Console.BackgroundColor = ConsoleColor.Red
Console.ForegroundColor = ConsoleColor.Black
Console.Clear()
End If
End Sub
End Module
O exemplo a seguir salva os valores da ConsoleColor enumeração em uma matriz e armazena os valores atuais das propriedades e BackgroundColor das ForegroundColor propriedades em variáveis. Em seguida, ele altera a cor do primeiro plano para cada cor na ConsoleColor enumeração, exceto para a cor que corresponde à tela de fundo atual, e altera a cor da tela de fundo para cada cor na ConsoleColor enumeração, exceto para a cor que corresponde ao primeiro plano atual. (Se a cor do primeiro plano for a mesma da cor da tela de fundo, o texto não estará visível.) Por fim, ele chama o ResetColor método para restaurar as cores originais do console.
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...
open System
// Get an array with the values of ConsoleColor enumeration members.
let colors = ConsoleColor.GetValues<ConsoleColor>()
// Save the current background and foreground colors.
let currentBackground = Console.BackgroundColor
let currentForeground = Console.ForegroundColor
// Display all foreground colors except the one that matches the background.
printfn $"All the foreground colors except {currentBackground}, the background color:"
for color in colors do
if color <> currentBackground then
Console.ForegroundColor <- color
printfn $" The foreground color is {color}."
printfn ""
// Restore the foreground color.
Console.ForegroundColor <- currentForeground;
// Display each background color except the one that matches the current foreground color.
printfn $"All the background colors except {currentForeground}, the foreground color:"
for color in colors do
if color <> currentForeground then
Console.BackgroundColor <- color
printfn $" The background color is {color}."
// Restore the original console colors.
Console.ResetColor()
printfn "\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...
Public Module Example
Public Sub Main()
' Get an array with the values of ConsoleColor enumeration members.
Dim colors() As ConsoleColor = ConsoleColor.GetValues(GetType(ConsoleColor))
' Save the current background and foreground colors.
Dim currentBackground As ConsoleColor = Console.BackgroundColor
Dim currentForeground As ConsoleColor = 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)
For Each color In colors
If color = currentBackground Then Continue For
Console.ForegroundColor = color
Console.WriteLine(" The foreground color is {0}.", color)
Next
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)
For Each color In colors
If color = currentForeground then Continue For
Console.BackgroundColor = color
Console.WriteLine(" The background color is {0}.", color)
Next
' Restore the original console colors.
Console.ResetColor
Console.WriteLine()
Console.WriteLine("Original colors restored...")
End Sub
End Module
'The example displays output like the following:
' 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...
Comentários
Uma operação de obtenção para um aplicativo baseado no Windows, no qual um console não existe, retorna Gray.
Os sistemas Unix não fornecem nenhum mecanismo geral para buscar as cores atuais do console. Por isso, ForegroundColor retorna (ConsoleColor)-1 até que seja definido de forma explícita (usando o setter).