StreamWriter.Write Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.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, 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

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

Write(String, Object, Object)

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

Write(Char[], Int32, Int32)

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.

• Dosya ve Akış G/Ç
• Nasıl yapılır: Dosya Metin Okuma
• Nasıl yapılır: Dosya Metin Yazma

Write(String, Object[])

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[]).

Write(ReadOnlySpan<Char>)

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ığı.

Write(String)

Kaynak:

StreamWriter.cs

Akışa bir dize yazar.

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)

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.

• Dosya ve Akış G/Ç
• Nasıl yapılır: Dosya Metin Okuma
• Nasıl yapılır: Dosya Metin Yazma

Write(Char[])

Kaynak:

StreamWriter.cs

Akışa bir karakter dizisi yazar.

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

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.

• Dosya ve Akış G/Ç
• Nasıl yapılır: Dosya Metin Okuma
• Nasıl yapılır: Dosya Metin Yazma

Write(Char)

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.

• Dosya ve Akış G/Ç
• Nasıl yapılır: Dosya Metin Okuma
• Nasıl yapılır: Dosya Metin Yazma

Write(String, Object)

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