Process.StandardError 属性
获取用于读取应用程序错误输出的流。
**命名空间:**System.Diagnostics
**程序集:**System（在 system.dll 中）
语法
声明
Public ReadOnly Property StandardError As StreamReader
用法
Dim instance As Process
Dim value As StreamReader
value = instance.StandardError
public StreamReader StandardError { get; }
public:
property StreamReader^ StandardError {
StreamReader^ get ();
}
/** @property */
public StreamReader get_StandardError ()
public function get StandardError () : StreamReader
属性值
一个 StreamReader，可用于读取应用程序的标准错误流。
异常
| 异常类型 | 条件 |
|---|---|
尚未定义 StandardError 流以进行重定向；请确保将 ProcessStartInfo.RedirectStandardError 设置为 true，将 ProcessStartInfo.UseShellExecute 设置为 false。 - 或 - 已打开 StandardError 流，以便通过 BeginErrorReadLine 进行异步读取操作。 |
备注
当 Process 将文本写入其标准错误流中时，通常将在控制台上显示该文本。通过重定向 StandardError 流，可以操作或取消进程的错误输出。例如，您可以筛选文本、用不同方式将其格式化，也可以将输出同时写入控制台和指定的日志文件中。
提示
若要使用 StandardError，您必须将 ProcessStartInfo.UseShellExecute 设置为 false，并且将 ProcessStartInfo.RedirectStandardError 设置为 true。否则，读取 StandardError 流时将引发异常。
可以同步或异步读取重定向的 StandardError 流。Read、ReadLine 和 ReadToEnd 等方法对进程的错误输出流执行同步读取操作。这些同步读取操作只有在关联的 Process 写入其 StandardError 流或关闭该流后才能完成。
相反，BeginErrorReadLine 在 StandardError 流上开始异步读取操作。此方法会为流输出启用一个指定的事件处理程序并立即返回到调用方，这样当流输出被定向到该事件处理程序时，调用方还可以执行其他操作。
同步读取操作在读取 StandardError 流的调用方及写入该流中的子进程之间引入一个依赖项。这些依赖项可能导致产生死锁情况。调用方读取子进程的重定向流时依赖于该子进程。调用方将等待读取操作，直到子进程写入流或关闭流为止。子进程写入足够多的数据以填充重定向流的时间依赖于父进程。子进程将等待下一次写操作，直到父进程读取了全部流或关闭该流为止。当调用方和子进程相互等待对方完成操作时，就会产生死锁情况，使双方都无法继续执行操作。您可以通过计算调用方和子进程之间的依赖项从而避免出现死锁情况。
例如，下面的 C# 代码演示如何读取重定向流并等待子进程退出。
// Start the child process.
Process p = new Process();
// Redirect the error stream of the child process.
p.StartInfo.UseShellExecute = false;
p.StartInfo.RedirectStandardError = true;
p.StartInfo.FileName = "Write500Lines.exe";
p.Start();
// Do not wait for the child process to exit before
// reading to the end of its redirected error stream.
// p.WaitForExit();
// Read the error stream first and then wait.
string error = p.StandardError.ReadToEnd();
p.WaitForExit();
该代码示例通过在 p.WaitForExit 之前调用 p.StandardError.ReadToEnd 避免产生死锁情况。如果父进程在 p.StandardError.ReadToEnd 之前调用 p.WaitForExit，并且子进程写入足够多的文本以填充重定向流，就会产生死锁情况。父进程将无限期地等待子进程退出。子进程将无限期地等待父进程读取全部 StandardError 流。
在读取标准输出和标准错误流的所有文本时，会出现类似的问题。例如，下面的 C# 代码对这两种流执行读取操作。
// Do not perform a synchronous read to the end of both
// redirected streams.
// string output = p.StandardOutput.ReadToEnd();
// string error = p.StandardError.ReadToEnd();
// p.WaitForExit();
// Use asynchronous read operations on at least one of the streams.
p.BeginOutputReadLine();
string error = p.StandardError.ReadToEnd();
p.WaitForExit();
此代码示例通过对 StandardOutput 流执行异步读取操作避免产生死锁情况。如果父进程在调用 p.StandardOutput.ReadToEnd 之后调用 p.StandardError.ReadToEnd，并且子进程写入足够多的文本以填充错误流，就会产生死锁情况。父进程将无限期地等待子进程关闭其 StandardOutput 流。子进程将无限期地等待父进程读取全部 StandardError 流。
您可以使用异步读取操作避免出现这些依赖项及其潜在的死锁情况。或者，您还可以通过创建两个线程并读取每个线程中每个流的输出来避免产生死锁情况。
提示
您不能对同一个重定向流混合使用异步和同步读取操作。在异步或同步模式下打开 Process 的重定向流后，对该流的所有进一步的读取操作都必须在同一模式下进行。例如，不要对 StandardError 流调用 BeginErrorReadLine 后接着调用 ReadLine，反之亦然。但是，您可以在不同的模式下读取两个不同的流。例如，您可以先调用 BeginOutputReadLine，然后再为 StandardError 流调用 ReadLine。
示例
下面的示例使用 net use 命令和用户提供的一个参数一起映射网络资源。然后它将读取 net 命令的标准错误流，并将其写入控制台中。
Dim myProcess As New Process()
Dim myProcessStartInfo As New ProcessStartInfo("net ", "use " + args(1))
myProcessStartInfo.UseShellExecute = False
myProcessStartInfo.RedirectStandardError = True
myProcess.StartInfo = myProcessStartInfo
myProcess.Start()
Dim myStreamReader As StreamReader = myProcess.StandardError
' Read the standard error of net.exe and write it on to console.
Console.WriteLine(myStreamReader.ReadLine())
myProcess.Close()
Process myProcess = new Process();
ProcessStartInfo myProcessStartInfo = new ProcessStartInfo("net ","use "+ args[0]);
myProcessStartInfo.UseShellExecute = false;
myProcessStartInfo.RedirectStandardError = true;
myProcess.StartInfo = myProcessStartInfo;
myProcess.Start();
StreamReader myStreamReader = myProcess.StandardError;
// Read the standard error of net.exe and write it on to console.
Console.WriteLine( myStreamReader.ReadLine());
myProcess.Close();
Process^ myProcess = gcnew Process;
ProcessStartInfo^ myProcessStartInfo = gcnew ProcessStartInfo( "net ",String::Concat( "use ", args[ 0 ] ) );
myProcessStartInfo->UseShellExecute = false;
myProcessStartInfo->RedirectStandardError = true;
myProcess->StartInfo = myProcessStartInfo;
myProcess->Start();
StreamReader^ myStreamReader = myProcess->StandardError;
// Read the standard error of net.exe and write it on to console.
Console::WriteLine( myStreamReader->ReadLine() );
myProcess->Close();
.NET Framework 安全性
- SecurityPermission 用于调用 Process 的成员。要求值：LinkDemand；命名的权限集：FullTrust。
平台
Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition
.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。
版本信息
.NET Framework
受以下版本支持：2.0、1.1、1.0
请参见
参考
Process 类
Process 成员
System.Diagnostics 命名空间
StandardInput
StandardOutput
ProcessStartInfo.RedirectStandardError