TextWriter.WriteLine Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zapisuje dane w strumieniu tekstowym, a następnie terminator wiersza.
Przeciążenia
WriteLine(String, Object, Object) |
Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej semantyki co metoda Format(String, Object, Object). |
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 tekstu przy użyciu tej samej semantyki co Format(String, ReadOnlySpan<Object>). |
WriteLine(String, Object[]) |
Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu 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 metoda Format(String, Object). |
WriteLine(UInt64) |
Zapisuje reprezentację tekstu 8-bajtowej liczby całkowitej bez znaku do strumienia tekstowego, a następnie terminator wiersza. |
WriteLine(String, Object, Object, Object) |
Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej semantyki co Format(String, Object). |
WriteLine(UInt32) |
Zapisuje reprezentację tekstu 4-bajtowej liczby całkowitej bez znaku do strumienia tekstowego, a następnie terminator wiersza. |
WriteLine(StringBuilder) |
Zapisuje tekstową reprezentację konstruktora ciągów w strumieniu tekstowym, 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(Double) |
Zapisuje tekstową reprezentację wartości zmiennoprzecinkowej 8-bajtowej na strumień tekstowy, a następnie terminator wiersza. |
WriteLine(Object) |
Zapisuje reprezentację tekstu obiektu w strumieniu tekstowym, wywołując metodę |
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(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ę wartości |
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)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej semantyki co metoda Format(String, Object, Object).
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public virtual void WriteLine (string format, object arg0, 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
format
jest null
.
TextWriter jest zamknięty.
Występuje błąd we/wy.
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 Złożone formatowanie.
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 i 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[,długość][: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 index jest null , element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma dwa obiekty na liście parametrów, wartość indeksu zawsze musi wynosić 0 lub 1. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException. |
długości | 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 formatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu. Jeśli nie określono formatString i obiekt, który ma zostać sformatowany, implementuje interfejs IFormattable, null jest przekazywany jako wartość parametru format , który jest używany jako ciąg formatu IFormattable.ToString. |
Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
, określ dwa znaki nawiasu klamrowego wiodącego lub końcowego; czyli "{{" lub "}}".
Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je NewLine.
Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Char[], Int32, Int32)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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
, w którym należy rozpocząć odczytywanie danych.
- count
- Int32
Maksymalna liczba znaków do zapisania.
Wyjątki
Długość buforu minus index
jest mniejsza niż count
.
Parametr buffer
jest null
.
index
lub count
jest ujemna.
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
Ta metoda zapisuje count
znaków danych w tym TextWriter
z tablicy znaków buffer
rozpoczynającej się od pozycji index
.
To przeciążenie jest równoważne wywołaniu metody Write(Char[]), po której następuje WriteLine dla każdego znaku w buffer
między index
i (index
+ count
).
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(String, ReadOnlySpan<Object>)
Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu 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.
Dotyczy
WriteLine(String, Object[])
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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).
public:
virtual void WriteLine(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public virtual void WriteLine (string format, params 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
Ciąg lub obiekt jest przekazywany jako null
.
TextWriter jest zamknięty.
Występuje błąd we/wy.
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 tablicy arg
.
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 Złożone formatowanie.
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 i 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[,długość][: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 index jest 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 nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException. |
długości | 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 formatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu. Jeśli nie określono formatString i obiekt, który ma zostać sformatowany, implementuje interfejs IFormattable, null jest przekazywany jako wartość parametru format , który jest używany jako ciąg formatu IFormattable.ToString. |
Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
, określ dwa znaki nawiasu klamrowego wiodącego lub końcowego; czyli "{{" lub "}}".
Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je NewLine.
Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(String, Object)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
Zapisuje sformatowany ciąg i nowy wiersz do strumienia tekstu przy użyciu tej samej semantyki co metoda Format(String, Object).
public:
virtual void WriteLine(System::String ^ format, System::Object ^ arg0);
public virtual void WriteLine (string format, 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
format
jest null
.
TextWriter jest zamknięty.
Występuje błąd we/wy.
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 Złożone formatowanie.
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 i 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[,długość][: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 index jest null , element formatu zostanie zastąpiony przez String.Empty. Ponieważ to przeciążenie ma tylko jeden obiekt na liście parametrów, wartość indeksu zawsze musi wynosić 0. Jeśli nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException. |
długości | 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 formatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu. Jeśli nie określono formatString i obiekt, który ma zostać sformatowany, implementuje interfejs IFormattable, null jest przekazywany jako wartość parametru format , który jest używany jako ciąg formatu IFormattable.ToString. |
Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
, określ dwa znaki nawiasu klamrowego wiodącego lub końcowego; czyli "{{" lub "}}".
Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je NewLine.
Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(UInt64)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
Ważne
Ten interfejs API nie jest zgodny ze specyfikacją 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
Wyjątki
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody UInt64.ToString. Właściwość FormatProvider, jeśli nie null
, określa formatowanie specyficzne dla kultury.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(String, Object, Object, Object)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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).
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);
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
format
jest null
.
TextWriter jest zamknięty.
Występuje błąd we/wy.
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 Złożone formatowanie.
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 i 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[,długość][: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 index jest 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 nie ma parametru w pozycji indeksu , zostanie zgłoszony FormatException. |
długości | 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 formatString są takie same jak wartości obsługiwane przez metodę ToString(string format) obiektu. Jeśli nie określono formatString i obiekt, który ma zostać sformatowany, implementuje interfejs IFormattable, null jest przekazywany jako wartość parametru format , który jest używany jako ciąg formatu IFormattable.ToString. |
Wymagane są znaki wiodące i końcowe, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
, określ dwa znaki nawiasu klamrowego wiodącego lub końcowego; czyli "{{" lub "}}".
Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je NewLine.
Jeśli określony obiekt nie odwołuje się do ciągu formatu, jest ignorowany.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(UInt32)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
Ważne
Ten interfejs API nie jest zgodny ze specyfikacją 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
Wyjątki
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody UInt32.ToString. Właściwość FormatProvider, jeśli nie null
, określa formatowanie specyficzne dla kultury.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(StringBuilder)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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 metody StringBuilder.ToString.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Dotyczy
WriteLine(String)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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);
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
jest null
, zapisywany jest tylko terminator wiersza.
Wyjątki
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
To przeciążenie jest równoważne przeciążeniu Write(Char[]).
Terminator wiersza jest definiowany przez pole CoreNewLine.
Ta metoda nie wyszukuje określonego ciągu dla poszczególnych znaków nowego wiersza (szesnastkowe 0x000a) i zastępuje je NewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Single)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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
TextWriter jest zamknięty.
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 przez pole CoreNewLine.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Double)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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
TextWriter jest zamknięty.
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 przez pole CoreNewLine.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Object)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
Zapisuje reprezentację tekstu obiektu w strumieniu tekstowym, wywołując metodę ToString
dla tego obiektu, a następnie terminator wiersza.
public:
virtual void WriteLine(System::Object ^ value);
public virtual void WriteLine (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
jest null
, zapisywany jest tylko terminator wiersza.
Wyjątki
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
To przeciążenie jest równoważne przeciążeniu Write(String, Object). Właściwość FormatProvider, jeśli nie null
, określa formatowanie specyficzne dla kultury.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Int64)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody Int64.ToString. Właściwość TextWriter.FormatProvider, jeśli nie null
, określa formatowanie specyficzne dla kultury.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Int32)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody Int32.ToString. Właściwość TextWriter.FormatProvider, jeśli nie null
, określa formatowanie specyficzne dla kultury.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Decimal)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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
TextWriter jest zamknięty.
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 przez pole CoreNewLine.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Char[])
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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);
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
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
Wszystkie znaki w buffer
są zapisywane w bazowym strumieniu. Jeśli tablica znaków jest null
, zapisywany jest tylko terminator wiersza.
To przeciążenie jest równoważne Write(Char[]) a następnie WriteLine() .
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Char)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
To przeciążenie jest równoważne Write(Char) a następnie WriteLine() .
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(Boolean)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
Zapisuje tekstową reprezentację wartości Boolean
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
Wartość Boolean
do zapisu.
Wyjątki
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie metody Boolean.ToString.
Ta metoda zwraca dane wyjściowe Boolean.TrueString lub Boolean.FalseString.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine()
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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
TextWriter jest zamknięty.
Występuje błąd we/wy.
Uwagi
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
WriteLine(ReadOnlySpan<Char>)
- Źródło:
- TextWriter.cs
- Źródło:
- TextWriter.cs
- Ź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 ReadOnlySpan<Char>. ToString, metoda.
Terminator wiersza jest definiowany przez pole CoreNewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.