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 Format(String, Object, Object) metoda. |
WriteLine(Char[], Int32, Int32) |
Zapisuje podtablicę znaków do strumienia tekstu, a następnie terminator wiersza. |
WriteLine(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 Format(String, Object) metoda. |
WriteLine(UInt64) |
Zapisuje reprezentację tekstową 8-bajtowej liczby całkowitej bez znaku do strumienia tekstu, 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ę tekstową 4-bajtowej liczby całkowitej bez znaku do strumienia tekstu, a następnie terminator wiersza. |
WriteLine(StringBuilder) |
Zapisuje tekstową reprezentację konstruktora ciągów w strumieniu tekstowym, po którym następuje terminator wiersza. |
WriteLine(String) |
Zapisuje ciąg w strumieniu tekstowym, po którym następuje terminator wiersza. |
WriteLine(Single) |
Zapisuje reprezentację tekstową 4-bajtowej wartości zmiennoprzecinkowej do strumienia tekstowego, a następnie terminator linii. |
WriteLine(Double) |
Zapisuje reprezentację tekstową 8-bajtowej wartości zmiennoprzecinkowej do strumienia tekstowego, a następnie terminator linii. |
WriteLine(Object) |
Zapisuje reprezentację tekstową obiektu w strumieniu tekstowym, wywołując |
WriteLine(Int64) |
Zapisuje reprezentację tekstową 8-bajtowej liczby całkowitej ze znakiem do strumienia tekstu, a następnie terminator wiersza. |
WriteLine(Int32) |
Zapisuje reprezentację tekstową 4-bajtowej liczby całkowitej ze znakiem do strumienia tekstu, a następnie terminator wiersza. |
WriteLine(Decimal) |
Zapisuje reprezentację tekstową wartości dziesiętnej w strumieniu tekstowym, a następnie terminator wiersza. |
WriteLine(Char[]) |
Zapisuje tablicę znaków w strumieniu tekstowym, po którym następuje terminator wiersza. |
WriteLine(Char) |
Zapisuje znak w strumieniu tekstowym, po którym następuje terminator wiersza. |
WriteLine(Boolean) |
Zapisuje reprezentację tekstową |
WriteLine() |
Zapisuje terminator wiersza w strumieniu tekstowym. |
WriteLine(ReadOnlySpan<Char>) |
Zapisuje reprezentację tekstu 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 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);
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 formatu i zapis.
- arg1
- Object
Drugi obiekt do formatu i zapisu.
Wyjątki
format
to null
.
Element TextWriter jest zamknięty.
Wystąpi 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 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 zmieszanego 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 tabeli poniżej 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.
Element | Opis |
---|---|
index | 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 jest zastępowany 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 zgłaszany jest parametr . |
,length | Minimalna liczba znaków w reprezentacji ciągu parametru. Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej. |
:formatString | Standardowy lub niestandardowy ciąg formatu 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 do sformatowania 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ącego i końcowego nawiasu klamrowego "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
pliku , 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 zastępuje je znakiem NewLine.
Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.
Terminator wiersza jest definiowany CoreNewLine przez pole .
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- We/wy plików i Stream
- 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 tekstu, po którym następuje 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
Długość buforu minus index
jest mniejsza niż count
.
Parametr buffer
ma wartość null
.
index
lub count
jest ujemny.
Element TextWriter jest zamknięty.
Wystąpi 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 buffer
między index
i ( + index
count
).
Terminator wiersza jest definiowany CoreNewLine przez pole.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- Plik i Stream we/wy
- Instrukcje: Odczytywanie tekstu z pliku
- Instrukcje: Zapisywanie tekstu w pliku
Dotyczy
WriteLine(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
- arg
- ReadOnlySpan<Object>
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 tych samych 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
.
Element TextWriter jest zamknięty.
Wystąpi 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 reprezentację ciągu i osadzić tę reprezentację w ciągu. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została opisana bardziej szczegółowo 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 formatudaty 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ą częścią 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 tabeli poniżej 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.
Element | Opis |
---|---|
index | 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 nie ma parametru w pozycji indeksu , FormatException jest zgłaszany. |
,length | Minimalna liczba znaków w reprezentacji ciągu parametru. Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej. |
:formatString | Standardowy lub niestandardowy ciąg formatu obsługiwany przez obiekt do sformatowania. Możliwe wartości formatString są takie same jak wartości obsługiwane przez metodę obiektu ToString(string format) . Jeśli formatString nie jest określony i obiekt do sformatowania implementuje IFormattable interfejs, null jest przekazywany jako wartość format parametru, który jest używany jako IFormattable.ToString ciąg formatu. |
Wymagane są znaki nawiasów klamrowych wiodących i końcowych, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
elemencie , 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ąp je znakiem NewLine.
Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.
Terminator wiersza jest definiowany CoreNewLine przez pole.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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 tych samych semantyki co Format(String, Object) metoda.
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
to null
.
Element TextWriter jest zamknięty.
Wystąpi 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 jest jednym).
Uwagi
Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na reprezentację ciągu i osadzić tę reprezentację w ciągu. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została opisana bardziej szczegółowo 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 formatudaty 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ą częścią 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 tabeli poniżej 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.
Element | Opis |
---|---|
index | 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 nie ma parametru w pozycji indeksu , FormatException jest zgłaszany. |
,length | Minimalna liczba znaków w reprezentacji ciągu parametru. Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej. |
:formatString | Standardowy lub niestandardowy ciąg formatu obsługiwany przez obiekt do sformatowania. Możliwe wartości formatString są takie same jak wartości obsługiwane przez metodę obiektu ToString(string format) . Jeśli formatString nie jest określony i obiekt do sformatowania implementuje IFormattable interfejs, null jest przekazywany jako wartość format parametru, który jest używany jako IFormattable.ToString ciąg formatu. |
Wymagane są znaki nawiasów klamrowych wiodących i końcowych, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
elemencie , 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ąp je znakiem NewLine.
Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.
Terminator wiersza jest definiowany CoreNewLine przez pole.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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ę tekstową 8-bajtowej liczby całkowitej bez znaku do strumienia tekstu, 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
Element TextWriter jest zamknięty.
Wystąpi 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 też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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 tych samych 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 formatu i zapis.
- arg1
- Object
Drugi obiekt do formatu i zapisu.
- arg2
- Object
Trzeci obiekt do formatowania i zapisu.
Wyjątki
format
to null
.
Element TextWriter jest zamknięty.
Wystąpi 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 jest trzy).
Uwagi
Ta metoda używa formatowania złożonego, aby przekonwertować wartość obiektu na reprezentację ciągu i osadzić tę reprezentację w ciągu. Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została opisana bardziej szczegółowo 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 formatudaty 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ą częścią 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 tabeli poniżej 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.
Element | Opis |
---|---|
index | 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 nie ma parametru w pozycji indeksu , FormatException jest zgłaszany. |
,length | Minimalna liczba znaków w reprezentacji ciągu parametru. Jeśli jest dodatni, parametr jest wyrównany do prawej; jeśli jest ujemna, jest wyrównana do lewej. |
:formatString | Standardowy lub niestandardowy ciąg formatu obsługiwany przez obiekt do sformatowania. Możliwe wartości formatString są takie same jak wartości obsługiwane przez metodę obiektu ToString(string format) . Jeśli formatString nie jest określony i obiekt do sformatowania implementuje IFormattable interfejs, null jest przekazywany jako wartość format parametru, który jest używany jako IFormattable.ToString ciąg formatu. |
Wymagane są znaki nawiasów klamrowych wiodących i końcowych, "{" i "}". Aby określić pojedynczy znak nawiasu klamrowego literału w format
elemencie , 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ąp je znakiem NewLine.
Jeśli określony obiekt nie jest wywoływany w ciąg formatującym, jest on ignorowany.
Terminator wiersza jest definiowany CoreNewLine przez pole.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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ę tekstową 4-bajtowej liczby całkowitej bez znaku do strumienia tekstowego, po której następuje 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 bajtów do zapisu.
- Atrybuty
Wyjątki
Element TextWriter jest zamknięty.
Wystąpi 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 też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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 StringBuilder.ToString metody .
Terminator wiersza jest definiowany CoreNewLine przez pole.
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 do strumienia tekstu, 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 zapisu. Jeśli value
jest to null
, jest zapisywany tylko terminator wiersza.
Wyjątki
Element TextWriter jest zamknięty.
Wystąpi 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 zastąp je znakiem NewLine.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- Plik i Stream 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 do strumienia tekstowego, po której następuje 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
Element TextWriter jest zamknięty.
Wystąpi 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 też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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 bajtów 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 o wartości 8 bajtów do zapisu.
Wyjątki
Element TextWriter jest zamknięty.
Wystąpi 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 też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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 ToString
metodę na tym obiekcie, 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 zapisania. Jeśli value
jest to null
, jest zapisywany tylko terminator wiersza.
Wyjątki
Element TextWriter jest zamknięty.
Wystąpi 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 też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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 do strumienia tekstu, 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 z podpisem 8 bajtów do zapisu.
Wyjątki
Element TextWriter jest zamknięty.
Wystąpi 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 też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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 reprezentację tekstową 4-bajtowej liczby całkowitej ze znakiem do strumienia tekstowego, po której następuje 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 z podpisem 4 bajtów do zapisu.
Wyjątki
Element TextWriter jest zamknięty.
Wystąpi 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 też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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 do strumienia tekstowego, 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
Element TextWriter jest zamknięty.
Wystąpi 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 też
- StreamWriter
- StringWriter
- IFormatProvider
- Plik i Stream 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 do strumienia tekstu, a następnie 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
Element TextWriter jest zamknięty.
Wystąpi 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 następującemu Write(Char[]) elementowi WriteLine() : .
Terminator wiersza jest definiowany CoreNewLine przez pole.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- Plik i Stream 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 tekstu.
Wyjątki
Element TextWriter jest zamknięty.
Wystąpi błąd We/Wy.
Uwagi
To przeciążenie jest równoważne następującemu Write(Char) elementowi WriteLine() : .
Terminator wiersza jest definiowany CoreNewLine przez pole.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- Plik i Stream 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ę 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
Wartość Boolean
do zapisania.
Wyjątki
Element TextWriter jest zamknięty.
Wystąpi błąd We/Wy.
Uwagi
Tekstowa reprezentacja określonej wartości jest generowany przez wywołanie Boolean.ToString metody .
Ta metoda generuje dane wyjściowe Boolean.TrueString lub Boolean.FalseString.
Terminator wiersza jest definiowany CoreNewLine przez pole.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- StreamWriter
- StringWriter
- Plik i Stream 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 do strumienia tekstu.
public:
virtual void WriteLine();
public virtual void WriteLine ();
abstract member WriteLine : unit -> unit
override this.WriteLine : unit -> unit
Public Overridable Sub WriteLine ()
Wyjątki
Element TextWriter jest zamknięty.
Wystąpi 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 też
- StreamWriter
- StringWriter
- Plik i Stream 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, a następnie 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 elementu ReadOnlySpan<Char>. ToString , metoda.
Terminator wiersza jest definiowany CoreNewLine przez pole.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla