TextWriter 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示可以编写一系列连续字符的编写器。 此类是抽象的。
public ref class TextWriter abstract : IDisposablepublic ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposablepublic ref class TextWriter abstract : MarshalByRefObject, IDisposablepublic abstract class TextWriter : IDisposablepublic abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposablepublic abstract class TextWriter : MarshalByRefObject, IDisposable[System.Serializable]
public abstract class TextWriter : MarshalByRefObject, IDisposable[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextWriter : MarshalByRefObject, IDisposabletype TextWriter = class
interface IDisposabletype TextWriter = class
inherit MarshalByRefObject
interface IAsyncDisposable
interface IDisposabletype TextWriter = class
inherit MarshalByRefObject
interface IDisposable[<System.Serializable>]
type TextWriter = class
inherit MarshalByRefObject
interface IDisposable[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TextWriter = class
inherit MarshalByRefObject
interface IDisposablePublic MustInherit Class TextWriter
Implements IDisposablePublic MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposablePublic MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IDisposable- 继承
-
TextWriter
- 继承
- 派生
- 属性
- 实现
示例
TextWriter 类是一个抽象类。 因此，不会在代码中实例化它。 StreamWriter 类派生自 TextWriter，并提供成员的实现以写入流。 以下示例演示如何使用 WriteLineAsync(String) 方法将字符串值组成的两行写入文本文件。
using System.IO;
namespace ConsoleApplication
{
class Program4
{
static void Main()
{
WriteCharacters();
}
static async void WriteCharacters()
{
using (StreamWriter writer = File.CreateText("newfile.txt"))
{
await writer.WriteLineAsync("First line of example");
await writer.WriteLineAsync("and second line");
}
}
}
}
Imports System.IO
Imports System.Text
Module Module1
Sub Main()
WriteCharacters()
End Sub
Async Sub WriteCharacters()
Using writer As StreamWriter = File.CreateText("newfile.txt")
Await writer.WriteLineAsync("First line of example")
Await writer.WriteLineAsync("and second line")
End Using
End Sub
End Module
注解
TextWriter 是 StreamWriter 和 StringWriter的抽象基类，分别将字符写入流和字符串。 使用 TextWriter 实例将对象写入字符串、将字符串写入文件或序列化 XML。 还可以使用 TextWriter 实例，使用用于字符串或流的相同 API 将文本写入自定义后盾存储，或者添加对文本格式的支持。
所有 Write 方法 TextWriter 将基元数据类型作为参数写出字符串形式的值。
默认情况下，TextWriter 不是线程安全的。 有关线程安全的包装器，请参阅 TextWriter.Synchronized。
重要
此类型实现 IDisposable 接口。 使用从此类型派生的任何类型后，应直接或间接释放它。 若要直接释放类型，请在 try/catch 块中调用其 Dispose 方法。 若要间接处理它，请使用语言构造（如 using（在 C# 中）或 Using（在 Visual Basic 中）。 有关详细信息，请参阅 IDisposable 接口主题中的 Dispose 和“使用实现 IDisposable 的对象”部分。
有关常见 I/O 任务的列表，请参阅 常见 I/O 任务。
实施者说明
派生类必须至少实现 Write(Char) 方法，才能生成有用的 TextWriter实例。
构造函数
| TextWriter() |
初始化 TextWriter 类的新实例。 |
| TextWriter(IFormatProvider) |
使用指定的格式提供程序初始化 TextWriter 类的新实例。 |
字段
| CoreNewLine |
存储用于此 |
| Null |
提供一个 |
属性
| Encoding |
在派生类中重写时，返回在其中写入输出的字符编码。 |
| FormatProvider |
获取一个对象，该对象控制格式设置。 |
| NewLine |
获取或设置当前 |
方法
显式接口实现
| IDisposable.Dispose() |
有关此成员的说明，请参阅 Dispose()。 |
扩展方法
| ConfigureAwait(IAsyncDisposable, Boolean) |
配置如何执行从异步可释放项返回的任务的 await。 |
