FileSystemProxy.WriteAllText Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic.MyServices

Zestaw:: Microsoft.VisualBasic.dll

Zestaw:: Microsoft.VisualBasic.Forms.dll

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 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)

Zapisuje tekst w pliku.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append);

public void WriteAllText (string file, string text, bool append);

member this.WriteAllText : string * string * bool -> unit

Public Sub WriteAllText (file As String, text As String, append As Boolean)

Parametry

file: String

Plik do zapisania.

text: String

Tekst, który ma zostać zapisany w pliku.

append: Boolean

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

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ę 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, aby zapisać ciąg w buforze.

SecurityException

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

Przykłady

W tym przykładzie jest zapisywany wiersz "This is new text to be added." do pliku Test.txt, zastępując dowolny 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 Documents and Settings są zapisywane nazwy plików w folderze , FileList.txtwstawiając wózek powrotny między poszczególnymi w celu uzyskania 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 używający WriteAllText metody jest prostszy niż kod, który używa StreamWriter obiektu. Jeśli jednak dodasz ciągi do pliku przy użyciu pętli, obiekt może zapewnić lepszą wydajność, StreamWriter ponieważ wystarczy otworzyć i zamknąć plik jednorazowo. 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	Instrukcje: Zapisywanie tekstu w plikach
Dołączanie tekstu do pliku	Instrukcje: Dołączanie do plików tekstowych

Zobacz też

Dotyczy

WriteAllText(String, String, Boolean, Encoding)

Zapisuje tekst w pliku.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);

public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);

member this.WriteAllText : string * string * bool * System.Text.Encoding -> unit

Public Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

Parametry

file: String

Plik do zapisania.

text: String

Tekst, który ma zostać zapisany w pliku.

append: Boolean

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

encoding: Encoding

Jakiego kodowania używać podczas zapisywania w pliku. Wartość domyślna to UTF-8.

Wyjątki

ArgumentException

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, aby zapisać ciąg w buforze.

SecurityException

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

Przykłady

W tym przykładzie jest zapisywany wiersz "This is new text to be added." do pliku Test.txt, zastępując dowolny 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 Documents and Settings są zapisywane nazwy plików w folderze , FileList.txtwstawiając wózek powrotny między poszczególnymi w celu uzyskania 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

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

Działanie	Zobacz
Zapisywanie tekstu w pliku	Instrukcje: Zapisywanie tekstu w plikach
Dołączanie tekstu do pliku	Instrukcje: Dołączanie do plików tekstowych

Zobacz też

Dotyczy

Udostępnij za pośrednictwem

FileSystemProxy.WriteAllText Metoda

Definicja

Przeciążenia

WriteAllText(String, String, Boolean)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

WriteAllText(String, String, Boolean, Encoding)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby