TextWriter 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示可以编写一系列连续字符的编写器。 此类是抽象的。
public ref class TextWriter abstract : IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IAsyncDisposable, IDisposable
public ref class TextWriter abstract : MarshalByRefObject, IDisposable
public abstract class TextWriter : IDisposable
public abstract class TextWriter : MarshalByRefObject, IAsyncDisposable, IDisposable
public 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, IDisposable
type TextWriter = class
interface IDisposable
type TextWriter = class
inherit MarshalByRefObject
interface IAsyncDisposable
interface IDisposable
type 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 IDisposable
Public MustInherit Class TextWriter
Implements IDisposable
Public MustInherit Class TextWriter
Inherits MarshalByRefObject
Implements IAsyncDisposable, IDisposable
Public 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。 |