Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


File.WriteAllBytes 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.

Przeciążenia

WriteAllBytes(String, Byte[])

Tworzy nowy plik, zapisuje określoną tablicę bajtów w pliku, a następnie zamyka plik. Jeśli plik docelowy już istnieje, zostanie obcięty i zastąpiony.

WriteAllBytes(String, ReadOnlySpan<Byte>)

Tworzy nowy plik, zapisuje określoną tablicę bajtów w pliku, a następnie zamyka plik. Jeśli plik docelowy już istnieje, zostanie obcięty i zastąpiony.

WriteAllBytes(String, Byte[])

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Tworzy nowy plik, zapisuje określoną tablicę bajtów w pliku, a następnie zamyka plik. Jeśli plik docelowy już istnieje, zostanie obcięty i zastąpiony.

C#
public static void WriteAllBytes(string path, byte[] bytes);

Parametry

path
String

Plik do zapisu.

bytes
Byte[]

Bajty do zapisu w pliku.

Wyjątki

Wersje .NET Framework i .NET Core starsze niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera co najmniej jeden nieprawidłowy znak. Zapytanie o nieprawidłowe znaki można wykonać przy użyciu metody GetInvalidPathChars().

path jest null lub tablica bajtów jest pusta.

Określona ścieżka, nazwa pliku lub obie metody przekraczają maksymalną długość zdefiniowaną przez system.

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

Wystąpił błąd we/wy podczas otwierania pliku.

path określony plik, który jest tylko do odczytu.

-lub-

path określony plik, który jest ukryty.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

-lub-

path określony katalog.

-lub-

Obiekt wywołujący nie ma wymaganych uprawnień.

path jest w nieprawidłowym formacie.

Obiekt wywołujący nie ma wymaganych uprawnień.

Uwagi

Biorąc pod uwagę tablicę bajtów i ścieżkę pliku, ta metoda otwiera określony plik, zapisuje zawartość tablicy bajtów w pliku, a następnie zamyka plik.

Dotyczy

.NET 10 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

WriteAllBytes(String, ReadOnlySpan<Byte>)

Tworzy nowy plik, zapisuje określoną tablicę bajtów w pliku, a następnie zamyka plik. Jeśli plik docelowy już istnieje, zostanie obcięty i zastąpiony.

C#
public static void WriteAllBytes(string path, ReadOnlySpan<byte> bytes);

Parametry

path
String

Plik do zapisu.

bytes
ReadOnlySpan<Byte>

Bajty do zapisu w pliku.

Wyjątki

path jest null.

path jest pusta.

Określona ścieżka, nazwa pliku lub obie metody przekraczają maksymalną długość zdefiniowaną przez system.

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

Wystąpił błąd we/wy podczas otwierania pliku.

path określony plik, który jest tylko do odczytu.

-lub-

path określony plik, który jest ukryty.

-lub-

path określony katalog.

-lub-

Obiekt wywołujący nie ma wymaganych uprawnień.

-lub-

Ta operacja nie jest obsługiwana na bieżącej platformie.

path jest w nieprawidłowym formacie.

Dotyczy

.NET 10 i .NET 9
Produkt Wersje
.NET 9, 10