Udostępnij za pośrednictwem


FileSystem.WriteAllText Metoda

Definicja

Zapisuje tekst w pliku.

Przeciążenia

WriteAllText(String, String, Boolean)

Zapisuje tekst w pliku.

WriteAllText(String, String, Boolean, Encoding)

Zapisuje tekst w pliku.

WriteAllText(String, String, Boolean)

Źródło:
FileSystem.vb
Źródło:
FileSystem.vb
Źródło:
FileSystem.vb

Zapisuje tekst w pliku.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append);
public static void WriteAllText (string file, string text, bool append);
static member WriteAllText : string * string * bool -> unit
Public Shared Sub WriteAllText (file As String, text As String, append As Boolean)

Parametry

file
String

Plik do zapisania.

text
String

Tekst do zapisania w pliku.

append
Boolean

True w celu dołączenia do zawartości pliku; False aby zastąpić zawartość pliku.

Wyjątki

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\); kończy się końcowym ukośnikiem.

file to Nothing.

Plik nie istnieje.

Plik jest używany przez inny proces lub występuje błąd we/wy.

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

Za mało pamięci do zapisania ciągu do buforu.

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

Przykłady

W tym przykładzie wiersz "This is new text to be added." jest zapisywany w pliku Test.txt, zastępując istniejący tekst w pliku.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

W tym przykładzie zapisuje nazwy plików w folderze Documents and Settings na FileList.txt, wstawiając zwrot karetki między poszczególnymi plikami w celu zapewnienia lepszej czytelności.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Uwagi

Kodowanie UTF-8 służy do zapisywania w pliku. Aby określić inne kodowanie, użyj innego przeciążenia WriteAllText metody .

Jeśli określony plik nie istnieje, zostanie utworzony.

Jeśli określone kodowanie nie jest zgodne z istniejącym kodowaniem pliku, określone kodowanie jest ignorowane.

Uwaga

Metoda WriteAllText otwiera plik, zapisuje go, a następnie zamyka go. Kod korzystający z WriteAllText metody jest prostszy niż kod, który używa StreamWriter obiektu. Jednak w przypadku dodawania ciągów do pliku przy użyciu pętli obiekt może zapewnić lepszą wydajność, StreamWriter ponieważ wystarczy otworzyć i zamknąć plik jeden raz. Aby uzyskać więcej informacji, zobacz metodę OpenTextFileWriter .

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.WriteAllText .

Działanie Zobacz
Zapisywanie tekstu w pliku Porady: zapisywanie tekstu do plików w Visual Basic
Dołączanie tekstu do pliku Porady: łączenie się plikami tekstowymi w Visual Basic

Zobacz też

Dotyczy

WriteAllText(String, String, Boolean, Encoding)

Źródło:
FileSystem.vb
Źródło:
FileSystem.vb
Źródło:
FileSystem.vb

Zapisuje tekst w pliku.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);
public static void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);
static member WriteAllText : string * string * bool * System.Text.Encoding -> unit
Public Shared Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

Parametry

file
String

Plik do zapisania.

text
String

Tekst do zapisania w pliku.

append
Boolean

True w celu dołączenia do zawartości pliku; False aby zastąpić zawartość pliku.

encoding
Encoding

Kodowanie używane podczas zapisywania w pliku.

Wyjątki

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\); kończy się końcowym ukośnikiem.

file to Nothing.

Plik nie istnieje.

Plik jest używany przez inny proces lub występuje błąd we/wy.

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

Za mało pamięci do zapisania ciągu do buforu.

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

Przykłady

W tym przykładzie wiersz "This is new text to be added." jest zapisywany w pliku Test.txt, zastępując istniejący tekst w pliku.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

W tym przykładzie zapisuje nazwy plików w folderze Documents and Settings na FileList.txt, wstawiając zwrot karetki między poszczególnymi plikami w celu zapewnienia lepszej czytelności.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Uwagi

Jeśli określony plik nie istnieje, zostanie utworzony.

Jeśli określone kodowanie nie jest zgodne z istniejącym kodowaniem pliku, określone kodowanie jest ignorowane.

Uwaga

Metoda WriteAllText otwiera plik, zapisuje go, a następnie zamyka go. Kod korzystający z WriteAllText metody jest prostszy niż kod, który używa StreamWriter obiektu. Jednak w przypadku dodawania ciągów do pliku przy użyciu pętli obiekt może zapewnić lepszą wydajność, StreamWriter ponieważ wystarczy otworzyć i zamknąć plik jeden raz. Aby uzyskać więcej informacji, zobacz metodę OpenTextFileWriter .

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.WriteAllText .

Działanie Zobacz
Zapisywanie tekstu w pliku Porady: zapisywanie tekstu do plików w Visual Basic
Dołączanie tekstu do pliku Porady: łączenie się plikami tekstowymi w Visual Basic

Zobacz też

Dotyczy