TextWriter.WriteLine Metoda

Definicja

Namespace:

System.IO

Zestawów:

netstandard.dll, System.Runtime.dll

Zapisuje dane w strumieniu tekstowym, a następnie terminator wiersza.

Przeciążenia

Nazwa	Opis
WriteLine(String, Object, Object, Object)	Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co Format(String, Object).
WriteLine(String, Object, Object)	Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej semantyki co Format(String, Object, Object) metoda.
WriteLine(Char[], Int32, Int32)	Zapisuje podarraj znaków do strumienia tekstowego, a następnie terminator wiersza.
WriteLine(String, ReadOnlySpan<Object>)	Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co Format(String, ReadOnlySpan<Object>).
WriteLine(String, Object[])	Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co Format(String, Object).
WriteLine(String, Object)	Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej semantyki co Format(String, Object) metoda.
WriteLine(UInt64)	Zapisuje reprezentację tekstu 8-bajtowej liczby całkowitej bez znaku do strumienia tekstowego, a następnie terminator wiersza.
WriteLine(UInt32)	Zapisuje reprezentację tekstu 4-bajtowej liczby całkowitej bez znaku do strumienia tekstowego, a następnie terminator wiersza.
WriteLine(String)	Zapisuje ciąg w strumieniu tekstowym, po którym następuje terminator wiersza.
WriteLine(Single)	Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 4-bajtowej na strumień tekstowy, a następnie terminator wiersza.
WriteLine(StringBuilder)	Zapisuje tekstową reprezentację konstruktora ciągów w strumieniu tekstowym, a następnie terminator wiersza.
WriteLine(Object)	Zapisuje tekstową reprezentację obiektu w strumieniu tekstowym, wywołując ToString metodę w tym obiekcie, a następnie terminator wiersza.
WriteLine(Int64)	Zapisuje tekstową reprezentację liczby całkowitej ze znakiem 8 bajtów w strumieniu tekstowym, a następnie terminator wiersza.
WriteLine(Int32)	Zapisuje tekstową reprezentację 4-bajtowej liczby całkowitej ze znakiem do strumienia tekstowego, a następnie terminator wiersza.
WriteLine(Double)	Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 8-bajtowej na strumień tekstowy, a następnie terminator wiersza.
WriteLine(Decimal)	Zapisuje tekstową reprezentację wartości dziesiętnej w strumieniu tekstowym, a następnie terminator wiersza.
WriteLine(Char[])	Zapisuje tablicę znaków w strumieniu tekstowym, po której następuje terminator wiersza.
WriteLine(Char)	Zapisuje znak do strumienia tekstu, po którym następuje terminator wiersza.
WriteLine(Boolean)	Zapisuje tekstową reprezentację Boolean wartości w strumieniu tekstowym, a następnie terminator wiersza.
WriteLine()	Zapisuje terminator wiersza w strumieniu tekstowym.
WriteLine(ReadOnlySpan<Char>)	Zapisuje tekstową reprezentację zakresu znaków w strumieniu tekstowym, po którym następuje terminator wiersza.

WriteLine(String, Object, Object, Object)

Źródło:

TextWriter.cs

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co Format(String, Object).

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);

public virtual void WriteLine(string format, object? arg0, object? arg1, object? arg2);

abstract member WriteLine : string * obj * obj * obj -> unit
override this.WriteLine : string * obj * obj * obj -> unit

Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object, arg2 As Object)

Parametry

format

String

Ciąg formatu złożonego.

arg0

Object

Pierwszy obiekt do formatowania i zapisu.

arg1

Object

Drugi obiekt do formatowania i zapisu.

arg2

Object

Trzeci obiekt do formatowania i zapisu.

Wyjątki

ArgumentNullException

Parametr format ma wartość null.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

FormatException

format nie jest prawidłowym ciągiem formatu złożonego.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy liczbie obiektów do sformatowania (co dla tego przeciążenia metody wynosi trzy).

Uwagi

Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na jego reprezentację ciągu i osadzić tę reprezentację w ciągu. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Formatowanie złożone.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego i Niestandardowe ciągi formatu liczbowego.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu daty i godziny, zobacz Standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu wyliczenia, zobacz Ciągi formatu wyliczenia.

• Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym wartość odpowiedniego obiektu.

Składnia elementu formatu jest następująca:

{index[,length][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz Formatowanie złożone.

Pierwiastek	Opis
indeks	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez indeks to null, element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma trzy obiekty na liście parametrów, wartość indeksu musi zawsze wynosić 0, 1 lub 2. Jeśli w pozycji indeksu nie ma parametru, FormatException zostanie zgłoszony parametr .
,length	Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Ciąg formatu standardowego lub niestandardowego obsługiwany przez obiekt do sformatowania. Możliwe wartości parametru formatString są takie same jak wartości obsługiwane przez metodę obiektu ToString(string format) . Jeśli parametr formatString nie jest określony i obiekt, który ma zostać sformatowany, implementuje IFormattable interfejs, null jest przekazywany jako wartość parametru format , który jest używany jako IFormattable.ToString ciąg formatu.

Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w formatelemencie , określ dwa wiodące lub końcowe znaki nawiasu klamrowego, czyli "{{" lub "}}".

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zamienia je na NewLine.

Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(String, Object, Object)

Źródło:

TextWriter.cs

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej semantyki co Format(String, Object, Object) metoda.

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);

public virtual void WriteLine(string format, object? arg0, object? arg1);

abstract member WriteLine : string * obj * obj -> unit
override this.WriteLine : string * obj * obj -> unit

Public Overridable Sub WriteLine (format As String, arg0 As Object, arg1 As Object)

Parametry

format

String

Ciąg formatu złożonego.

arg0

Object

Pierwszy obiekt do formatowania i zapisu.

arg1

Object

Drugi obiekt do formatowania i zapisu.

Wyjątki

ArgumentNullException

Parametr format ma wartość null.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

FormatException

format nie jest prawidłowym ciągiem formatu złożonego.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy liczbie obiektów do sformatowania (które dla tego przeciążenia metody jest dwa).

Uwagi

Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na jego reprezentację ciągu i osadzić tę reprezentację w ciągu. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Formatowanie złożone.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego i Niestandardowe ciągi formatu liczbowego.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu daty i godziny, zobacz Standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu wyliczenia, zobacz Ciągi formatu wyliczenia.

• Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym wartość odpowiedniego obiektu.

Składnia elementu formatu jest następująca:

{index[,length][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz Formatowanie złożone.

Pierwiastek	Opis
indeks	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez indeks to null, element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma dwa obiekty na liście parametrów, wartość indeksu musi zawsze wynosić 0 lub 1. Jeśli w pozycji indeksu nie ma parametru, FormatException zostanie zgłoszony parametr .
,length	Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Ciąg formatu standardowego lub niestandardowego obsługiwany przez obiekt do sformatowania. Możliwe wartości parametru formatString są takie same jak wartości obsługiwane przez metodę obiektu ToString(string format) . Jeśli parametr formatString nie jest określony i obiekt, który ma zostać sformatowany, implementuje IFormattable interfejs, null jest przekazywany jako wartość parametru format , który jest używany jako IFormattable.ToString ciąg formatu.

Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w formatelemencie , określ dwa wiodące lub końcowe znaki nawiasu klamrowego, czyli "{{" lub "}}".

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zamienia je na NewLine.

Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(Char[], Int32, Int32)

Źródło:

TextWriter.cs

Zapisuje podarraj znaków do strumienia tekstowego, a następnie terminator wiersza.

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

public virtual void WriteLine(char[] buffer, int index, int count);

abstract member WriteLine : char[] * int * int -> unit
override this.WriteLine : char[] * int * int -> unit

Public Overridable Sub WriteLine (buffer As Char(), index As Integer, count As Integer)

Parametry

buffer

Char[]

Tablica znaków, z której są odczytywane dane.

index

Int32

Położenie znaku, w buffer którym należy rozpocząć odczytywanie danych.

count

Int32

Maksymalna liczba znaków do zapisania.

Wyjątki

ArgumentException

Długość buforu minus index jest mniejsza niż count.

ArgumentNullException

Parametr buffer jest null.

ArgumentOutOfRangeException

index lub count jest ujemny.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Ta metoda będzie zapisywać count znaki danych w tej TextWriter postaci z buffer tablicy znaków rozpoczynającej się od pozycji index.

To przeciążenie jest równoważne wywołaniu Write(Char[]) metody, po której następuje WriteLine dla każdego znaku między indexbuffer i (countindex + ).

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(String, ReadOnlySpan<Object>)

Źródło:

TextWriter.cs

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co Format(String, ReadOnlySpan<Object>).

public:
 virtual void WriteLine(System::String ^ format, ReadOnlySpan<System::Object ^> arg);

public virtual void WriteLine(string format, scoped ReadOnlySpan<object?> arg);

abstract member WriteLine : string * ReadOnlySpan<obj> -> unit
override this.WriteLine : string * ReadOnlySpan<obj> -> unit

Public Overridable Sub WriteLine (format As String, arg As ReadOnlySpan(Of Object))

Parametry

format

String

Ciąg formatu złożonego.

arg

ReadOnlySpan<Object>

Zakres obiektu, który zawiera zero lub więcej obiektów do formatowania i zapisu.

WriteLine(String, Object[])

Źródło:

TextWriter.cs

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstowego przy użyciu tej samej semantyki co Format(String, Object).

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

public virtual void WriteLine(string format, params object?[] arg);

abstract member WriteLine : string * obj[] -> unit
override this.WriteLine : string * obj[] -> unit

Public Overridable Sub WriteLine (format As String, ParamArray arg As Object())

Parametry

format

String

Ciąg formatu złożonego.

arg

Object[]

Tablica obiektów zawierająca zero lub więcej obiektów do formatowania i zapisu.

Wyjątki

ArgumentNullException

Ciąg lub obiekt jest przekazywany jako null.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

FormatException

format nie jest prawidłowym ciągiem formatu złożonego.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy długości arg tablicy.

Uwagi

Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na jego reprezentację ciągu i osadzić tę reprezentację w ciągu. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Formatowanie złożone.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego i Niestandardowe ciągi formatu liczbowego.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu daty i godziny, zobacz Standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu wyliczenia, zobacz Ciągi formatu wyliczenia.

• Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym wartość odpowiedniego obiektu.

Składnia elementu formatu jest następująca:

{index[,length][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz Formatowanie złożone.

Pierwiastek	Opis
indeks	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez indeks to null, element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma tablicę na liście parametrów, wartość indeksu musi być zawsze mniejsza niż długość tablicy. Jeśli w pozycji indeksu nie ma parametru, FormatException zostanie zgłoszony parametr .
,length	Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Ciąg formatu standardowego lub niestandardowego obsługiwany przez obiekt do sformatowania. Możliwe wartości parametru formatString są takie same jak wartości obsługiwane przez metodę obiektu ToString(string format) . Jeśli parametr formatString nie jest określony i obiekt, który ma zostać sformatowany, implementuje IFormattable interfejs, null jest przekazywany jako wartość parametru format , który jest używany jako IFormattable.ToString ciąg formatu.

Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w formatelemencie , określ dwa wiodące lub końcowe znaki nawiasu klamrowego, czyli "{{" lub "}}".

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zamienia je na NewLine.

Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(String, Object)

Źródło:

TextWriter.cs

Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej semantyki co Format(String, Object) metoda.

public:
 virtual void WriteLine(System::String ^ format, System::Object ^ arg0);

public virtual void WriteLine(string format, object? arg0);

abstract member WriteLine : string * obj -> unit
override this.WriteLine : string * obj -> unit

Public Overridable Sub WriteLine (format As String, arg0 As Object)

Parametry

format

String

Ciąg formatu złożonego.

arg0

Object

Obiekt do formatowania i zapisu.

Wyjątki

ArgumentNullException

Parametr format ma wartość null.

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

FormatException

format nie jest prawidłowym ciągiem formatu złożonego.

-lub-

Indeks elementu formatu jest mniejszy niż 0 (zero) lub większy lub równy liczbie obiektów do sformatowania (które dla tego przeciążenia metody jest jednym).

Uwagi

Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na jego reprezentację ciągu i osadzić tę reprezentację w ciągu. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

• Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, zobacz Formatowanie złożone.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu liczbowego, zobacz Standardowe ciągi formatu liczbowego i Niestandardowe ciągi formatu liczbowego.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu daty i godziny, zobacz Standardowe ciągi formatu daty i godziny oraz niestandardowe ciągi formatu daty i godziny.

• Aby uzyskać więcej informacji na temat specyfikatorów formatu wyliczenia, zobacz Ciągi formatu wyliczenia.

• Aby uzyskać więcej informacji na temat formatowania, zobacz Typy formatowania.

Parametr format składa się z zera lub większej liczby przebiegów tekstu w połączeniu z zero lub większą większa liczba indeksowanych symboli zastępczych, nazywanych elementami formatu, które odpowiadają obiektowi na liście parametrów tej metody. Proces formatowania zastępuje każdy element formatu ciągiem reprezentującym wartość odpowiedniego obiektu.

Składnia elementu formatu jest następująca:

{index[,length][:formatString]}

Elementy w nawiasach kwadratowych są opcjonalne. W poniższej tabeli opisano każdy element. Aby uzyskać więcej informacji na temat funkcji formatowania złożonego, w tym składni elementu formatu, zobacz Formatowanie złożone.

Pierwiastek	Opis
indeks	Położenie na podstawie zera na liście parametrów obiektu do sformatowania. Jeśli obiekt określony przez indeks to null, element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma tylko jeden obiekt na liście parametrów, wartość indeksu musi zawsze wynosić 0. Jeśli w pozycji indeksu nie ma parametru, FormatException zostanie zgłoszony parametr .
,length	Minimalna liczba znaków w ciągu reprezentującym parametr . Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej.
:formatString	Ciąg formatu standardowego lub niestandardowego obsługiwany przez obiekt do sformatowania. Możliwe wartości parametru formatString są takie same jak wartości obsługiwane przez metodę obiektu ToString(string format) . Jeśli parametr formatString nie jest określony i obiekt, który ma zostać sformatowany, implementuje IFormattable interfejs, null jest przekazywany jako wartość parametru format , który jest używany jako IFormattable.ToString ciąg formatu.

Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w formatelemencie , określ dwa wiodące lub końcowe znaki nawiasu klamrowego, czyli "{{" lub "}}".

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zamienia je na NewLine.

Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(UInt64)

Źródło:

TextWriter.cs

Ważny

To API nie jest zgodne z CLS.

Zapisuje reprezentację tekstu 8-bajtowej liczby całkowitej bez znaku do strumienia tekstowego, a następnie terminator wiersza.

public:
 virtual void WriteLine(System::UInt64 value);

[System.CLSCompliant(false)]
public virtual void WriteLine(ulong value);

[<System.CLSCompliant(false)>]
abstract member WriteLine : uint64 -> unit
override this.WriteLine : uint64 -> unit

Public Overridable Sub WriteLine (value As ULong)

Parametry

value

UInt64

Liczba całkowita bez znaku 8 bajtów do zapisu.

Atrybuty

CLSCompliantAttribute

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie UInt64.ToString metody . Właściwość FormatProvider , jeśli nie null, określa formatowanie specyficzne dla kultury.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(UInt32)

Źródło:

TextWriter.cs

Ważny

To API nie jest zgodne z CLS.

Zapisuje reprezentację tekstu 4-bajtowej liczby całkowitej bez znaku do strumienia tekstowego, a następnie terminator wiersza.

public:
 virtual void WriteLine(System::UInt32 value);

[System.CLSCompliant(false)]
public virtual void WriteLine(uint value);

[<System.CLSCompliant(false)>]
abstract member WriteLine : uint32 -> unit
override this.WriteLine : uint32 -> unit

Public Overridable Sub WriteLine (value As UInteger)

Parametry

value

UInt32

Liczba całkowita bez znaku 4-bajtowa do zapisu.

Atrybuty

CLSCompliantAttribute

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie UInt32.ToString metody . Właściwość FormatProvider , jeśli nie null, określa formatowanie specyficzne dla kultury.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(String)

Źródło:

TextWriter.cs

Zapisuje ciąg w strumieniu tekstowym, po którym następuje terminator wiersza.

public:
 virtual void WriteLine(System::String ^ value);

public virtual void WriteLine(string? value);

abstract member WriteLine : string -> unit
override this.WriteLine : string -> unit

Public Overridable Sub WriteLine (value As String)

Parametry

value

String

Ciąg do zapisania. Jeśli value parametr ma nullwartość , jest zapisywany tylko terminator wiersza.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

To przeciążenie jest równoważne Write(Char[]) przeciążeniu.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zamienia je na NewLine.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(Single)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 4-bajtowej na strumień tekstowy, a następnie terminator wiersza.

public:
 virtual void WriteLine(float value);

public virtual void WriteLine(float value);

abstract member WriteLine : single -> unit
override this.WriteLine : single -> unit

Public Overridable Sub WriteLine (value As Single)

Parametry

value

Single

Wartość zmiennoprzecinkowa 4-bajtowa do zapisu.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Właściwość FormatProvider , jeśli nie null, określa formatowanie specyficzne dla kultury. Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(StringBuilder)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację konstruktora ciągów w strumieniu tekstowym, a następnie terminator wiersza.

public:
 virtual void WriteLine(System::Text::StringBuilder ^ value);

public virtual void WriteLine(System.Text.StringBuilder? value);

abstract member WriteLine : System.Text.StringBuilder -> unit
override this.WriteLine : System.Text.StringBuilder -> unit

Public Overridable Sub WriteLine (value As StringBuilder)

Parametry

value

StringBuilder

Ciąg jako konstruktor ciągów do zapisu w strumieniu tekstowym.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie StringBuilder.ToString metody .

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

WriteLine(Object)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację obiektu w strumieniu tekstowym, wywołując ToString metodę w tym obiekcie, a następnie terminator wiersza.

public:
 virtual void WriteLine(System::Object ^ value);

public virtual void WriteLine(object? value);

abstract member WriteLine : obj -> unit
override this.WriteLine : obj -> unit

Public Overridable Sub WriteLine (value As Object)

Parametry

value

Object

Obiekt do zapisu. Jeśli value parametr ma nullwartość , jest zapisywany tylko terminator wiersza.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

To przeciążenie jest równoważne Write(String, Object) przeciążeniu. Właściwość FormatProvider , jeśli nie null, określa formatowanie specyficzne dla kultury.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(Int64)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację liczby całkowitej ze znakiem 8 bajtów w strumieniu tekstowym, a następnie terminator wiersza.

public:
 virtual void WriteLine(long value);

public virtual void WriteLine(long value);

abstract member WriteLine : int64 -> unit
override this.WriteLine : int64 -> unit

Public Overridable Sub WriteLine (value As Long)

Parametry

value

Int64

Liczba całkowita ze znakiem 8 bajtów do zapisu.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie Int64.ToString metody . Właściwość TextWriter.FormatProvider , jeśli nie null, określa formatowanie specyficzne dla kultury.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(Int32)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację 4-bajtowej liczby całkowitej ze znakiem do strumienia tekstowego, a następnie terminator wiersza.

public:
 virtual void WriteLine(int value);

public virtual void WriteLine(int value);

abstract member WriteLine : int -> unit
override this.WriteLine : int -> unit

Public Overridable Sub WriteLine (value As Integer)

Parametry

value

Int32

Liczba całkowita ze znakiem 4 bajtów do zapisu.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie Int32.ToString metody . Właściwość TextWriter.FormatProvider , jeśli nie null, określa formatowanie specyficzne dla kultury.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(Double)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 8-bajtowej na strumień tekstowy, a następnie terminator wiersza.

public:
 virtual void WriteLine(double value);

public virtual void WriteLine(double value);

abstract member WriteLine : double -> unit
override this.WriteLine : double -> unit

Public Overridable Sub WriteLine (value As Double)

Parametry

value

Double

Wartość zmiennoprzecinkowa 8-bajtowa do zapisu.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Właściwość FormatProvider , jeśli nie null, określa formatowanie specyficzne dla kultury. Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(Decimal)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację wartości dziesiętnej w strumieniu tekstowym, a następnie terminator wiersza.

public:
 virtual void WriteLine(System::Decimal value);

public virtual void WriteLine(decimal value);

abstract member WriteLine : decimal -> unit
override this.WriteLine : decimal -> unit

Public Overridable Sub WriteLine (value As Decimal)

Parametry

value

Decimal

Wartość dziesiętna do zapisu.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Właściwość FormatProvider , jeśli nie null, określa formatowanie specyficzne dla kultury. Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Zobacz także

• StreamWriter
• StringWriter
• IFormatProvider
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(Char[])

Źródło:

TextWriter.cs

Zapisuje tablicę znaków w strumieniu tekstowym, po której następuje terminator wiersza.

public:
 virtual void WriteLine(cli::array <char> ^ buffer);

public virtual void WriteLine(char[]? buffer);

abstract member WriteLine : char[] -> unit
override this.WriteLine : char[] -> unit

Public Overridable Sub WriteLine (buffer As Char())

Parametry

buffer

Char[]

Tablica znaków, z której są odczytywane dane.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Wszystkie znaki w pliku buffer są zapisywane w strumieniu bazowym. Jeśli tablica znaków to null, zapisywany jest tylko terminator wiersza.

To przeciążenie jest równoważne z Write(Char[]) następującym po nim WriteLine() elementem .

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(Char)

Źródło:

TextWriter.cs

Zapisuje znak do strumienia tekstu, po którym następuje terminator wiersza.

public:
 virtual void WriteLine(char value);

public virtual void WriteLine(char value);

abstract member WriteLine : char -> unit
override this.WriteLine : char -> unit

Public Overridable Sub WriteLine (value As Char)

Parametry

value

Char

Znak do zapisu w strumieniu tekstowym.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

To przeciążenie jest równoważne z Write(Char) następującym po nim WriteLine() elementem .

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(Boolean)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację Boolean wartości w strumieniu tekstowym, a następnie terminator wiersza.

public:
 virtual void WriteLine(bool value);

public virtual void WriteLine(bool value);

abstract member WriteLine : bool -> unit
override this.WriteLine : bool -> unit

Public Overridable Sub WriteLine (value As Boolean)

Parametry

value

Boolean

Boolean Wartość do zapisania.

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie Boolean.ToString metody .

Ta metoda zwraca wartość lub Boolean.TrueStringBoolean.FalseString.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine()

Źródło:

TextWriter.cs

Zapisuje terminator wiersza w strumieniu tekstowym.

public:
 virtual void WriteLine();

public virtual void WriteLine();

abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit

Public Overridable Sub WriteLine ()

Wyjątki

ObjectDisposedException

Element TextWriter jest zamknięty.

IOException

Występuje błąd we/wy.

Uwagi

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz także

• StreamWriter
• StringWriter
• Wejście/Wyjście plików i strumieni
• Instrukcje: odczytywanie tekstu z pliku
• Instrukcje: zapisywanie tekstu w pliku

WriteLine(ReadOnlySpan<Char>)

Źródło:

TextWriter.cs

Zapisuje tekstową reprezentację zakresu znaków w strumieniu tekstowym, po którym następuje terminator wiersza.

public:
 virtual void WriteLine(ReadOnlySpan<char> buffer);

public virtual void WriteLine(ReadOnlySpan<char> buffer);

abstract member WriteLine : ReadOnlySpan<char> -> unit
override this.WriteLine : ReadOnlySpan<char> -> unit

Public Overridable Sub WriteLine (buffer As ReadOnlySpan(Of Char))

Parametry

buffer

ReadOnlySpan<Char>

Wartość zakresu znaków do zapisu w strumieniu tekstowym.

Uwagi

Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie funkcji ReadOnlySpan<Char>. ToString , metoda.

Terminator wiersza jest definiowany CoreNewLine przez pole .

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.