Windows apps
Collapse the table of content
Expand the table of content
Information
Switch
Switch
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Console::Title Property

.NET Framework (current version)
 

Gets or sets the title to display in the console title bar.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

C#
C++
F#
VB
Copy 
public:
property String^ Title {
	static String^ get();
	static void set(String^ value);
}

Property Value

Type: System::String^

The string to be displayed in the title bar of the console. The maximum length of the title string is 24500 characters.

Exception Condition
InvalidOperationException

In a get operation, the retrieved title is longer than 24500 characters.

ArgumentOutOfRangeException

In a set operation, the specified title is longer than 24500 characters.

ArgumentNullException

In a set operation, the specified title is null.

IOException

An I/O error occurred.

Win9xFamily

The maximum length of the title string is 127 ANSI characters. Unicode characters are not supported.

This example demonstrates the Title property. The example displays the current title of the operating system window, waits for a key press, then displays a new title.

C#
C++
VB
Copy 
// This example demonstrates the Console.Title property.
using namespace System;
int main()
{
   Console::WriteLine( "The current console title is: \"{0}\"", Console::Title );
   Console::WriteLine( "  (Press any key to change the console title.)" );
   Console::ReadKey( true );
   Console::Title = "The title has changed!";
   Console::WriteLine( "Note that the new console title is \"{0}\"\n"
   "  (Press any key to quit.)", Console::Title );
   Console::ReadKey( true );
}

/*
This example produces the following results:

>myTitle
The current console title is: "Command Prompt - myTitle"
  (Press any key to change the console title.)
Note that the new console title is "The title has changed!"
  (Press any key to quit.)

*/

UIPermission

for modifying safe top-level windows and subwindows. Associated enumeration: UIPermissionWindow::SafeTopLevelWindows

.NET Framework
Available since 2.0
Return to top
Show:
© 2017 Microsoft