FileSystem.WriteAllText Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.dll

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

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

ArgumentException

Ś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.

ArgumentNullException

file to Nothing.

FileNotFoundException

Plik nie istnieje.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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ż

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

Ź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

ArgumentException

Ś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.

ArgumentNullException

file to Nothing.

FileNotFoundException

Plik nie istnieje.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

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

SecurityException

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ż

• Encoding