Język

WebUtility.UrlEncodeToBytes(Byte[], Int32, Int32) Metoda

Definicja

Przestrzeń nazw:
System.Net
Zestawy:
System.dll, System.Runtime.Extensions.dll
Zestawy:
netstandard.dll, System.Runtime.dll
Zestaw:
System.Runtime.Extensions.dll
Zestaw:
System.dll
Zestaw:
netstandard.dll
Źródło:
WebUtility.cs
Źródło:
WebUtility.cs
Źródło:
WebUtility.cs
Źródło:
WebUtility.cs
Źródło:
WebUtility.cs

Konwertuje tablicę bajtów na tablicę bajtów zakodowaną w adresie URL.

public:
 static cli::array <System::Byte> ^ UrlEncodeToBytes(cli::array <System::Byte> ^ value, int offset, int count);
public static byte[] UrlEncodeToBytes(byte[] value, int offset, int count);
public static byte[]? UrlEncodeToBytes(byte[]? value, int offset, int count);
static member UrlEncodeToBytes : byte[] * int * int -> byte[]
Public Shared Function UrlEncodeToBytes (value As Byte(), offset As Integer, count As Integer) As Byte()

Parametry

value
Byte[]

Tablica Byte do kodu URL.

offset
Int32

Przesunięcie w bajtach od początku tablicy Byte do kodowania.

count
Int32

Liczba w bajtach do kodowania z tablicy Byte .

Zwraca

Byte[]

Zakodowana Byte tablica.

Uwagi

Jeśli znaki takie jak puste i interpunkcyjne są przekazywane w strumieniu HTTP, mogą być błędnie interpretowane na końcu odbierania. Kodowanie adresu URL zastępuje znaki niedozwolone w adresie URL odpowiednikami jednostki znaków składającymi się z szesnastkowej sekwencji ucieczki. Oczekuje się, że przekonwertowany ciąg będzie zgodny z formatem UTF-8.

Kodowanie adresów URL zastępuje wszystkie kody znaków, z wyjątkiem liter, cyfr i następujących znaków interpunkcyjnych:

  • - (znak minus)

  • _ (podkreślenie)

  • . (okres)

  • ! (wykrzyknik)

  • * (gwiazdka)

  • ' (pojedynczy cudzysłów)

  • ( i ) (nawiasy otwierające i zamykające)

Każdy znak ' (spacja) jest konwertowany na + znak (plus).

Note

Zastępowanie znaku "" (spacja) znakiem "+" (plus) jest oczekiwane tylko w części zapytania identyfikatora URI (zgodnie z konwencją, a nie standardową) lub w application/x-www-form-urlencoded zawartości HTTP. Ponadto wymieniona powyżej lista znaków, które nie są zastępowane, nie odpowiada specyfikacji adresu URL ani identyfikatorowi URI RFC 3986. Służy EscapeDataString do przekształcania zgodnego ze standardem RFC.

Na przykład w przypadku osadzeni w bloku tekstu, który ma być przesyłany w adresie URL, znaki < i > są kodowane jako %3c i %3e.

Metoda UrlDecodeToBytes odwraca kodowanie.

Dotyczy