Console::SetError Method (TextWriter^)

.NET Framework (current version)

Sets the Error property to the specified TextWriter object.

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

Syntax

public:
[HostProtectionAttribute(SecurityAction::LinkDemand, UI = true)]
static void SetError(
	TextWriter^ newError
)

Parameters

newError: Type: System.IO::TextWriter^
A stream that is the new standard error output.

Exceptions

Exception	Condition
ArgumentNullException	newError is null.
SecurityException	The caller does not have the required permission.

Remarks

By default, the Error property is set to the standard error output stream.

A StreamWriter that encapsulates a FileStream can be used to send error messages to a file.

Examples

The following example shows how to redirect the standard error stream to a file.

C++

using namespace System;
using namespace System::IO;
using namespace System::Reflection;

ref class RedirectStdErr;

void main()
{
   // Define file to receive error stream.
   DateTime appStart = DateTime::Now;
   String^ fn = "c:\\temp\\errlog" + appStart.ToString("yyyyMMddHHmm") + ".log";
   TextWriter^ errStream = gcnew StreamWriter(fn);
   String^ appName = Assembly::GetExecutingAssembly()->Location;
   appName = appName->Substring(appName->LastIndexOf('\\') + 1);
   // Redirect standard error stream to file.
   Console::SetError(errStream);
   // Write file header.
   Console::Error->WriteLine("Error Log for Application {0}", appName);
   Console::Error->WriteLine();
   Console::Error->WriteLine("Application started at {0}.", appStart);
   Console::Error->WriteLine();
   //
   // Application code along with error output 
   //
   // Close redirected error stream.
   Console::Error->Close();
}

Security

SecurityPermission

for calling unmanaged code. Associated enumeration: SecurityPermissionFlag::UnmanagedCode

Version Information

.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0