StreamWriter.Write 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.
Przeciążenia
| Write(String, Object, Object, Object) |
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object, Object, Object). |
| Write(String, Object, Object) |
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object, Object). |
| Write(Char[], Int32, Int32) |
Zapisuje podarraj znaków w strumieniu. |
| Write(String, ReadOnlySpan<Object>) |
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co Format(String, ReadOnlySpan<Object>). |
| Write(String, Object[]) |
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object[]). |
| Write(ReadOnlySpan<Char>) |
Zapisuje zakres znaków w strumieniu. |
| Write(String) |
Zapisuje ciąg w strumieniu. |
| Write(Char[]) |
Zapisuje tablicę znaków w strumieniu. |
| Write(Char) |
Zapisuje znak w strumieniu. |
| Write(String, Object) |
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object). |
Write(String, Object, Object, Object)
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object, Object, Object).
public:
override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1, System::Object ^ arg2);
public override void Write (string format, object? arg0, object? arg1, object? arg2);
override this.Write : string * obj * obj * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object, arg2 As Object)
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.
Uwagi
Zobacz Write(String, Object, Object, Object) opis oferowanych możliwości formatowania złożonego.
Dotyczy
Write(String, Object, Object)
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object, Object).
public:
override void Write(System::String ^ format, System::Object ^ arg0, System::Object ^ arg1);
public override void Write (string format, object? arg0, object? arg1);
override this.Write : string * obj * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object, arg1 As Object)
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.
Uwagi
Zobacz Write(String, Object, Object) opis oferowanych możliwości formatowania złożonego.
Dotyczy
Write(Char[], Int32, Int32)
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
Zapisuje podarraj znaków w strumieniu.
public:
override void Write(cli::array <char> ^ buffer, int index, int count);
public override void Write (char[] buffer, int index, int count);
override this.Write : char[] * int * int -> unit
Public Overrides Sub Write (buffer As Char(), index As Integer, count As Integer)
Parametry
- buffer
- Char[]
Tablica znaków zawierająca dane do zapisu.
- index
- Int32
Położenie znaku w buforze, w którym należy rozpocząć odczytywanie danych.
- count
- Int32
Maksymalna liczba znaków do zapisania.
Wyjątki
buffer jest null.
Długość buforu minus index jest mniejsza niż count.
index lub count jest ujemna.
Występuje błąd we/wy.
AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a bieżący zapis jest zamknięty.
AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a zawartość buforu nie może być zapisywana w bazowym strumieniu o stałym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.
Przykłady
W tym przykładzie zapisuje osiem znaków z tablicy 13 elementów do pliku, zaczynając od trzeciego elementu tablicy.
using namespace System;
using namespace System::IO;
int main()
{
FileStream^ sb = gcnew FileStream( "MyFile.txt",FileMode::OpenOrCreate );
array<Char>^b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
StreamWriter^ sw = gcnew StreamWriter( sb );
sw->Write( b, 3, 8 );
sw->Close();
}
using System;
using System.IO;
public class SWBuff
{
public static void Main(String[] args)
{
FileStream sb = new FileStream("MyFile.txt", FileMode.OpenOrCreate);
char[] b = {'a','b','c','d','e','f','g','h','i','j','k','l','m'};
StreamWriter sw = new StreamWriter(sb);
sw.Write(b, 3, 8);
sw.Close();
}
}
Imports System.IO
Public Class SWBuff
Public Shared Sub Main()
Dim sb As New FileStream("MyFile.txt", FileMode.OpenOrCreate)
Dim b As Char() = {"a"c, "b"c, "c"c, "d"c, "e"c, "f"c, "g"c, _
"h"c, "i"c, "j"c, "k"c, "l"c, "m"c}
Dim sw As New StreamWriter(sb)
sw.Write(b, 3, 8)
sw.Close()
End Sub
End Class
Uwagi
Ta metoda zastępuje TextWriter.Write.
Znaki są odczytywane z buffer zaczynając od index i kontynuując index + (count - 1). Wszystkie znaki są zapisywane w strumieniu bazowym, chyba że koniec bazowego strumienia zostanie osiągnięty przedwcześnie.
Flush jest wywoływany automatycznie, jeśli AutoFlush jest true.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
Write(String, ReadOnlySpan<Object>)
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co Format(String, ReadOnlySpan<Object>).
public:
override void Write(System::String ^ format, ReadOnlySpan<System::Object ^> arg);
public override void Write (string format, scoped ReadOnlySpan<object?> arg);
override this.Write : string * ReadOnlySpan<obj> -> unit
Public Overrides Sub Write (format As String, arg As ReadOnlySpan(Of Object))
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
Write(String, Object[])
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object[]).
public:
override void Write(System::String ^ format, ... cli::array <System::Object ^> ^ arg);
public override void Write (string format, params object?[] arg);
override this.Write : string * obj[] -> unit
Public Overrides Sub Write (format As String, ParamArray arg As Object())
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.
Uwagi
Zobacz Write(String, Object[]) opis oferowanych możliwości formatowania złożonego.
Dotyczy
Write(ReadOnlySpan<Char>)
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
Zapisuje zakres znaków w strumieniu.
public:
override void Write(ReadOnlySpan<char> buffer);
public override void Write (ReadOnlySpan<char> buffer);
override this.Write : ReadOnlySpan<char> -> unit
Public Overrides Sub Write (buffer As ReadOnlySpan(Of Char))
Parametry
- buffer
- ReadOnlySpan<Char>
Zakres znaków do zapisu.
Dotyczy
Write(String)
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
Zapisuje ciąg w strumieniu.
public:
override void Write(System::String ^ value);
public override void Write (string value);
public override void Write (string? value);
override this.Write : string -> unit
Public Overrides Sub Write (value As String)
Parametry
- value
- String
Ciąg do zapisu w strumieniu. Jeśli value ma wartość null, nic nie jest zapisywane.
Wyjątki
AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a bieżący zapis jest zamknięty.
AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a zawartość buforu nie może być zapisywana w bazowym strumieniu o stałym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.
Występuje błąd we/wy.
Uwagi
Ta metoda zastępuje TextWriter.Write.
Określony String jest zapisywany do bazowego strumienia, chyba że koniec strumienia zostanie osiągnięty przedwcześnie.
Flush jest wywoływany automatycznie, jeśli AutoFlush jest true. Jeśli value jest null, nie są zapisywane żadne wpisy.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
Write(Char[])
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
Zapisuje tablicę znaków w strumieniu.
public:
override void Write(cli::array <char> ^ buffer);
public override void Write (char[] buffer);
public override void Write (char[]? buffer);
override this.Write : char[] -> unit
Public Overrides Sub Write (buffer As Char())
Parametry
- buffer
- Char[]
Tablica znaków zawierająca dane do zapisania. Jeśli buffer jest null, nic nie jest napisane.
Wyjątki
Występuje błąd we/wy.
AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a bieżący zapis jest zamknięty.
AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a zawartość buforu nie może być zapisywana w bazowym strumieniu o stałym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.
Uwagi
Ta metoda zastępuje TextWriter.Write.
Określone znaki są zapisywane w strumieniu bazowym, chyba że koniec strumienia zostanie osiągnięty przedwcześnie. Jeśli AutoFlush jest true, Flush jest wywoływana automatycznie.
Ta metoda może zapewnić szybszą wydajność niż Write (char[],``int,``int), ponieważ ma mniej argumentów do sprawdzenia.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
Write(Char)
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
Zapisuje znak w strumieniu.
public:
override void Write(char value);
public override void Write (char value);
override this.Write : char -> unit
Public Overrides Sub Write (value As Char)
Parametry
- value
- Char
Znak do zapisu w strumieniu.
Wyjątki
Występuje błąd we/wy.
AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a bieżący zapis jest zamknięty.
AutoFlush ma wartość true lub bufor StreamWriter jest pełny, a zawartość buforu nie może być zapisywana w bazowym strumieniu o stałym rozmiarze, ponieważ StreamWriter znajduje się na końcu strumienia.
Uwagi
Ta metoda zastępuje TextWriter.Write.
Określony znak jest zapisywany w strumieniu bazowym, chyba że koniec strumienia zostanie osiągnięty przedwcześnie. Jeśli AutoFlush jest true, Flush jest wywoływana automatycznie.
Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.
Zobacz też
- plików i strumienia we/wy
- Instrukcje: odczytywanie tekstu z pliku
- Instrukcje: zapisywanie tekstu w pliku
Dotyczy
Write(String, Object)
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
- Źródło:
- StreamWriter.cs
Zapisuje sformatowany ciąg w strumieniu przy użyciu tej samej semantyki co metoda Format(String, Object).
public:
override void Write(System::String ^ format, System::Object ^ arg0);
public override void Write (string format, object? arg0);
override this.Write : string * obj -> unit
Public Overrides Sub Write (format As String, arg0 As Object)
Parametry
- format
- String
Ciąg formatu złożonego.
- arg0
- Object
Obiekt do formatowania i zapisu.
Uwagi
Zobacz Write(String, Object) opis oferowanych możliwości formatowania złożonego.