StreamWriter.Write Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.IO
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
System.Runtime.Extensions.dll
Bütünleştirilmiş Kod:
System.IO.dll
Bütünleştirilmiş Kod:
mscorlib.dll
Bütünleştirilmiş Kod:
netstandard.dll

Akışa veri yazar.

Aşırı Yüklemeler

Write(String, Object, Object, Object)

Format(String, Object, Object, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(String, Object, Object)

Format(String, Object, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(Char[], Int32, Int32)

Akışa bir karakter alt dizisi yazar.
Write(String, ReadOnlySpan<Object>)

Format(String, ReadOnlySpan<Object>)ile aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(String, Object[])

Format(String, Object[]) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.
Write(ReadOnlySpan<Char>)

Akışa bir karakter aralığı yazar.
Write(String)

Akışa bir dize yazar.
Write(Char[])

Akışa bir karakter dizisi yazar.
Write(Char)

Akışa bir karakter yazar.
Write(String, Object)

Format(String, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.

Write(String, Object, Object, Object)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Format(String, Object, Object, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.

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)

Parametreler

format
String

Bileşik biçim dizesi.

arg0
Object

Biçimlendirilip yazacak ilk nesne.

arg1
Object

Biçimlendirilip yazacak ikinci nesne.

arg2
Object

Biçimlendirilip yazacak üçüncü nesne.

Açıklamalar

Sunulan bileşik biçimlendirme özelliklerinin açıklaması için bkz. Write(String, Object, Object, Object).

Şunlara uygulanır

Write(String, Object, Object)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Format(String, Object, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.

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)

Parametreler

format
String

Bileşik biçim dizesi.

arg0
Object

Biçimlendirilip yazacak ilk nesne.

arg1
Object

Biçimlendirilip yazacak ikinci nesne.

Açıklamalar

Sunulan bileşik biçimlendirme özelliklerinin açıklaması için bkz. Write(String, Object, Object).

Şunlara uygulanır

Write(Char[], Int32, Int32)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Akışa bir karakter alt dizisi yazar.

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)

Parametreler

buffer
Char[]

Yazacak verileri içeren bir karakter dizisi.

index
Int32

Arabellekte verileri okumaya başlanması gereken karakter konumu.

count
Int32

Yazacak karakter sayısı üst sınırı.

Özel durumlar

ArgumentNullException

buffer null.

ArgumentException

Arabellek uzunluğu eksi indexcount'den küçüktür.

ArgumentOutOfRangeException

index veya count negatiftir.

IOException

G/Ç hatası oluşur.

ObjectDisposedException

AutoFlush true veya StreamWriter arabelleği dolu ve geçerli yazıcı kapatılır.

NotSupportedException

AutoFlush doğru veya StreamWriter arabelleği dolu ve StreamWriter akışın sonunda olduğundan arabelleğin içeriği temel alınan sabit boyutlu akışa yazılamaz.

Örnekler

Bu örnek, dizinin üçüncü öğesinden başlayarak 13 öğeli bir diziden dosyaya sekiz karakter yazar.

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

Açıklamalar

Bu yöntem TextWriter.Writegeçersiz kılar.

Karakterler index başlayarak buffer okunur ve index + (count - 1) ile devam edilir. Temel alınan akışın sonuna erken ulaşılmadığı sürece tüm karakterler temel alınan akışa yazılır. AutoFlush true Flush otomatik olarak çağrılır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Şunlara uygulanır

Write(String, ReadOnlySpan<Object>)

Format(String, ReadOnlySpan<Object>)ile aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.

public:
 override void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public override void Write (string format, scoped ReadOnlySpan<object?> arg);
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overrides Sub Write (format As String, arg As ReadOnlySpan(Of Object))

Parametreler

format
String

Bileşik biçim dizesi.

arg
ReadOnlySpan<Object>

Biçimlendirilip yazılacak sıfır veya daha fazla nesne içeren nesne aralığı.

Şunlara uygulanır

Write(String, Object[])

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Format(String, Object[]) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.

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())

Parametreler

format
String

Bileşik biçim dizesi.

arg
Object[]

Biçimlendirilip yazacak sıfır veya daha fazla nesne içeren bir nesne dizisi.

Açıklamalar

Sunulan bileşik biçimlendirme özelliklerinin açıklaması için bkz. Write(String, Object[]).

Şunlara uygulanır

Write(ReadOnlySpan<Char>)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Akışa bir karakter aralığı yazar.

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))

Parametreler

buffer
ReadOnlySpan<Char>

Yazılacak karakter aralığı.

Şunlara uygulanır

Write(String)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Akışa bir dize yazar.

public:
 override void Write(System::String ^ value);
public override void Write (string value);
public override void Write (string? value);
override this.Write : string -> unit
Public Overrides Sub Write (value As String)

Parametreler

value
String

Akışa yazacak dize. value null ise hiçbir şey yazılır.

Özel durumlar

ObjectDisposedException

AutoFlush true veya StreamWriter arabelleği dolu ve geçerli yazıcı kapatılır.

NotSupportedException

AutoFlush doğru veya StreamWriter arabelleği dolu ve StreamWriter akışın sonunda olduğundan arabelleğin içeriği temel alınan sabit boyutlu akışa yazılamaz.

IOException

G/Ç hatası oluşur.

Açıklamalar

Bu yöntem TextWriter.Writegeçersiz kılar.

Belirtilen String, akışın sonuna erken ulaşılmadığı sürece temel alınan akışa yazılır.

AutoFlush true Flush otomatik olarak çağrılır. value nullise hiçbir girdi yazılır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Şunlara uygulanır

Write(Char[])

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Akışa bir karakter dizisi yazar.

public:
 override void Write(cli::array <char> ^ buffer);
public override void Write (char[] buffer);
public override void Write (char[]? buffer);
override this.Write : char[] -> unit
Public Overrides Sub Write (buffer As Char())

Parametreler

buffer
Char[]

Yazacak verileri içeren bir karakter dizisi. buffer nullise hiçbir şey yazılır.

Özel durumlar

IOException

G/Ç hatası oluşur.

ObjectDisposedException

AutoFlush true veya StreamWriter arabelleği dolu ve geçerli yazıcı kapatılır.

NotSupportedException

AutoFlush doğru veya StreamWriter arabelleği dolu ve StreamWriter akışın sonunda olduğundan arabelleğin içeriği temel alınan sabit boyutlu akışa yazılamaz.

Açıklamalar

Bu yöntem TextWriter.Writegeçersiz kılar.

Akışın sonuna erken ulaşılmadığı sürece belirtilen karakterler temel alınan akışa yazılır. AutoFlush trueise Flush otomatik olarak çağrılır.

Bu yöntem, denetlenecek bağımsız değişken sayısı az olduğundan Write (char[],``int,``int) daha hızlı performans sağlayabilir.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Şunlara uygulanır

Write(Char)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Akışa bir karakter yazar.

public:
 override void Write(char value);
public override void Write (char value);
override this.Write : char -> unit
Public Overrides Sub Write (value As Char)

Parametreler

value
Char

Akışa yazacak karakter.

Özel durumlar

IOException

G/Ç hatası oluşur.

ObjectDisposedException

AutoFlush true veya StreamWriter arabelleği dolu ve geçerli yazıcı kapatılır.

NotSupportedException

AutoFlush doğru veya StreamWriter arabelleği dolu ve StreamWriter akışın sonunda olduğundan arabelleğin içeriği temel alınan sabit boyutlu akışa yazılamaz.

Açıklamalar

Bu yöntem TextWriter.Writegeçersiz kılar.

Akışın sonuna erken ulaşılmadığı sürece, belirtilen karakter temel alınan akışa yazılır. AutoFlush trueise Flush otomatik olarak çağrılır.

Yaygın G/Ç görevlerinin listesi için bkz. Ortak G/Ç Görevleri.

Ayrıca bkz.

Şunlara uygulanır

Write(String, Object)

Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs
Kaynak:
StreamWriter.cs

Format(String, Object) yöntemiyle aynı semantiği kullanarak akışa biçimlendirilmiş bir dize yazar.

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)

Parametreler

format
String

Bileşik biçim dizesi.

arg0
Object

Biçimlendirilip yazacak nesne.

Açıklamalar

Sunulan bileşik biçimlendirme özelliklerinin açıklaması için bkz. Write(String, Object).

Şunlara uygulanır