StreamWriter.Write 方法

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

将数据写入流。

重载

Write(String, Object, Object, Object)	使用与 Format(String, Object, Object, Object) 方法相同的语义将格式化字符串写入流。
Write(String, Object, Object)	使用与 Format(String, Object, Object) 方法相同的语义将格式化字符串写入流。
Write(Char[], Int32, Int32)	将字符的子数组写入流。
Write(String, Object[])	使用与 Format(String, Object[]) 方法相同的语义将格式化字符串写入流。
Write(ReadOnlySpan<Char>)	将字符范围写入流。
Write(String)	将字符串写入流。
Write(Char[])	将字符数组写入流。
Write(Char)	将字符写入流。
Write(String, Object)	使用与 Format(String, Object) 方法相同的语义将格式化字符串写入流。

Write(String, Object, Object, Object)

Source:

StreamWriter.cs

使用与 Format(String, Object, Object, Object) 方法相同的语义将格式化字符串写入流。

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public override void Write (string format, object? arg0, object? arg1, object? arg2);

override this.Write : string * obj * obj * obj -> unit

Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

参数

format

String

复合格式字符串。

arg0

Object

要格式化和写入的第一个对象。

arg1

Object

要格式化和写入的第二个对象。

arg2

Object

要格式化和写入的第三个对象。

注解

有关提供的复合格式设置功能的说明，请参阅 Write(String, Object, Object, Object)。

Write(String, Object, Object)

Source:

StreamWriter.cs

使用与 Format(String, Object, Object) 方法相同的语义将格式化字符串写入流。

public:
 override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public override void Write (string format, object? arg0, object? arg1);

override this.Write : string * obj * obj -> unit

Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object)

参数

format

String

复合格式字符串。

arg0

Object

要格式化和写入的第一个对象。

arg1

Object

要格式化和写入的第二个对象。

注解

有关提供的复合格式设置功能的说明，请参阅 Write(String, Object, Object)。

Write(Char[], Int32, Int32)

Source:

StreamWriter.cs

将字符的子数组写入流。

public:
 override void Write(cli::array <char> ^ buffer, int index, int count);

public override void Write (char[] buffer, int index, int count);

override this.Write : char[] * int * int -> unit

Public Overrides Sub Write (buffer As Char(), index As Integer, count As Integer)

参数

buffer

Char[]

包含要写入的数据的字符数组。

index

Int32

缓冲区中开始读取数据的字符位置。

count

Int32

要写入的最大字符数。

例外

ArgumentNullException

buffer null。

ArgumentException

缓冲区长度减去 index 小于 count。

ArgumentOutOfRangeException

index 或 count 为负数。

IOException

出现 I/O 错误。

ObjectDisposedException

AutoFlush 为 true 或 StreamWriter 缓冲区已满，并且当前编写器已关闭。

NotSupportedException

AutoFlush 为 true 或 StreamWriter 缓冲区已满，并且无法将缓冲区的内容写入基础固定大小流，因为 StreamWriter 位于流末尾。

示例

此示例从 13 元素数组写入文件（从数组的第三个元素开始）中的 8 个字符。

using namespace System;
using namespace System::IO;

int main()
{
   FileStream^ sb = gcnew FileStream( "MyFile.txt",FileMode::OpenOrCreate );
   array<Char>^b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
   StreamWriter^ sw = gcnew StreamWriter( sb );
   sw->Write( b, 3, 8 );
   sw->Close();
}

using System;
using System.IO;

public class SWBuff
{
    public static void Main(String[] args)
    {
        FileStream sb = new FileStream("MyFile.txt", FileMode.OpenOrCreate);
        char[] b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
        StreamWriter sw = new StreamWriter(sb);
        sw.Write(b, 3, 8);
        sw.Close();
    }
}

Imports System.IO

Public Class SWBuff

    Public Shared Sub Main()
        Dim sb As New FileStream("MyFile.txt", FileMode.OpenOrCreate)
        Dim b As Char() = {"a"c, "b"c, "c"c, "d"c, "e"c, "f"c, "g"c, _
           "h"c, "i"c, "j"c, "k"c, "l"c, "m"c}
        Dim sw As New StreamWriter(sb)
        sw.Write(b, 3, 8)
        sw.Close()
    End Sub
End Class

注解

此方法替代 TextWriter.Write。

字符从 index 开始从 buffer 读取，并继续 index + （count - 1）。 除非提前到达基础流的末尾，否则所有字符都会写入基础流。 如果 AutoFlushtrue，将自动调用 Flush。

有关常见 I/O 任务的列表，请参阅 常见 I/O 任务。

另请参阅

• 文件和流 I/O
• 如何：从文件读取文本
• 如何：将文本写入文件

Write(String, Object[])

Source:

StreamWriter.cs

使用与 Format(String, Object[]) 方法相同的语义将格式化字符串写入流。

public:
 override void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);

public override void Write (string format, params object?[] arg);

override this.Write : string * obj[] -> unit

Public Overrides Sub Write (format As String, ParamArray arg As Object())

参数

format

String

复合格式字符串。

arg

Object[]

一个对象数组，其中包含要格式化和写入的零个或多个对象。

注解

有关提供的复合格式设置功能的说明，请参阅 Write(String, Object[])。

Write(ReadOnlySpan<Char>)

Source:

StreamWriter.cs

将字符范围写入流。

public:
 override void Write(ReadOnlySpan<char> buffer);

public override void Write (ReadOnlySpan<char> buffer);

override this.Write : ReadOnlySpan<char> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Char))

参数

buffer

ReadOnlySpan<Char>

要写入的字符范围。

Write(String)

Source:

StreamWriter.cs

将字符串写入流。

public:
 override void Write(System::String ^ value);

public override void Write (string? value);

override this.Write : string -> unit

Public Overrides Sub Write (value As String)

参数

value

String

要写入流的字符串。 如果 value 为 null，则不会写入任何内容。

例外

ObjectDisposedException

AutoFlush 为 true 或 StreamWriter 缓冲区已满，并且当前编写器已关闭。

NotSupportedException

AutoFlush 为 true 或 StreamWriter 缓冲区已满，并且无法将缓冲区的内容写入基础固定大小流，因为 StreamWriter 位于流末尾。

IOException

出现 I/O 错误。

注解

此方法替代 TextWriter.Write。

指定的 String 将写入基础流，除非提前到达流的末尾。

如果 AutoFlushtrue，将自动调用 Flush。 如果 valuenull，则不会写入任何条目。

有关常见 I/O 任务的列表，请参阅 常见 I/O 任务。

另请参阅

• 文件和流 I/O
• 如何：从文件读取文本
• 如何：将文本写入文件

Write(Char[])

Source:

StreamWriter.cs

将字符数组写入流。

public:
 override void Write(cli::array <char> ^ buffer);

public override void Write (char[]? buffer);

override this.Write : char[] -> unit

Public Overrides Sub Write (buffer As Char())

参数

buffer

Char[]

包含要写入的数据的字符数组。 如果 buffernull，则不会写入任何内容。

例外

IOException

出现 I/O 错误。

ObjectDisposedException

AutoFlush 为 true 或 StreamWriter 缓冲区已满，并且当前编写器已关闭。

NotSupportedException

AutoFlush 为 true 或 StreamWriter 缓冲区已满，并且无法将缓冲区的内容写入基础固定大小流，因为 StreamWriter 位于流末尾。

注解

此方法替代 TextWriter.Write。

除非提前到达流的末尾，否则指定的字符将写入基础流。 如果 AutoFlushtrue，则会自动调用 Flush。

此方法的性能可能比 Write（char[],``int,``int）更快，因为要检查的参数更少。

有关常见 I/O 任务的列表，请参阅 常见 I/O 任务。

另请参阅

• 文件和流 I/O
• 如何：从文件读取文本
• 如何：将文本写入文件

Write(Char)

Source:

StreamWriter.cs

将字符写入流。

public:
 override void Write(char value);

public override void Write (char value);

override this.Write : char -> unit

Public Overrides Sub Write (value As Char)

参数

value

Char

要写入流的字符。

例外

IOException

出现 I/O 错误。

ObjectDisposedException

AutoFlush 为 true 或 StreamWriter 缓冲区已满，并且当前编写器已关闭。

NotSupportedException

AutoFlush 为 true 或 StreamWriter 缓冲区已满，并且无法将缓冲区的内容写入基础固定大小流，因为 StreamWriter 位于流末尾。

注解

此方法替代 TextWriter.Write。

除非提前到达流的末尾，否则指定的字符将写入基础流。 如果 AutoFlushtrue，则会自动调用 Flush。

有关常见 I/O 任务的列表，请参阅 常见 I/O 任务。

另请参阅

• 文件和流 I/O
• 如何：从文件读取文本
• 如何：将文本写入文件

Write(String, Object)

Source:

StreamWriter.cs

使用与 Format(String, Object) 方法相同的语义将格式化字符串写入流。

public:
 override void Write(System::String ^ format, System::Object ^ arg0);

public override void Write (string format, object? arg0);

override this.Write : string * obj -> unit

Public Overrides Sub Write (format As String, arg0 As Object)

参数

format

String

复合格式字符串。

arg0

Object

要格式化和写入的对象。

注解

有关提供的复合格式设置功能的说明，请参阅 Write(String, Object)。