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 中）。 如需詳細資訊，請參閱
如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。
給實施者的注意事項
衍生類別必須至少實作 Write(Char) 方法，才能使 TextWriter的實用實例。
建構函式
| TextWriter() |
初始化 TextWriter 類別的新實例。 |
| TextWriter(IFormatProvider) |
使用指定的格式提供者，初始化 TextWriter 類別的新實例。 |
欄位
| CoreNewLine |
儲存用於這個 |
| Null |
提供 |
屬性
| Encoding |
在衍生類別中覆寫時，傳回寫入輸出的字元編碼方式。 |
| FormatProvider |
取得控制項格式設定的物件。 |
| NewLine |
取得或設定目前 |
方法
明確介面實作
| IDisposable.Dispose() |
如需此成員的描述，請參閱 Dispose()。 |
擴充方法
| ConfigureAwait(IAsyncDisposable, Boolean) |
設定如何執行從異步可處置專案傳回的工作等候。 |
