Base64Url.DecodeFromUtf8 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| DecodeFromUtf8(ReadOnlySpan<Byte>) |
將以 Base64Url 表示的 UTF-8 編碼文字範圍解碼為二進位資料。 |
| DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>) |
將以 Base64Url 表示的 UTF-8 編碼文字範圍解碼為二進位資料。 |
| DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean) |
將以 Base64Url 表示的 UTF-8 編碼文字範圍解碼為二進位資料。 |
DecodeFromUtf8(ReadOnlySpan<Byte>)
將以 Base64Url 表示的 UTF-8 編碼文字範圍解碼為二進位資料。
public:
static cli::array <System::Byte> ^ DecodeFromUtf8(ReadOnlySpan<System::Byte> source);public static byte[] DecodeFromUtf8(ReadOnlySpan<byte> source);static member DecodeFromUtf8 : ReadOnlySpan<byte> -> byte[]Public Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte)) As Byte()參數
- source
- ReadOnlySpan<Byte>
輸入區間包含 UTF-8 編碼的 Base64Url 文字，需解碼。
傳回
>一個包含解碼操作結果的位元組陣列。
例外狀況
適用於
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>)
將以 Base64Url 表示的 UTF-8 編碼文字範圍解碼為二進位資料。
public:
static int DecodeFromUtf8(ReadOnlySpan<System::Byte> source, Span<System::Byte> destination);public static int DecodeFromUtf8(ReadOnlySpan<byte> source, Span<byte> destination);static member DecodeFromUtf8 : ReadOnlySpan<byte> * Span<byte> -> intPublic Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte), destination As Span(Of Byte)) As Integer參數
- source
- ReadOnlySpan<Byte>
輸入區間包含 UTF-8 編碼的 Base64Url 文字，需解碼。
傳回
寫入 destination的位元組數。 若有需要，這可用來切片後續呼叫的輸出。
例外狀況
緩 destination 衝區太小，無法容納編碼輸出。
備註
由於 Base64Url source 的填充是可選的，長度不必是 4 的倍數。
若 source 長度不是 4 的倍數，餘數會依此解碼：
- 剩餘的 3 位元組 - 解碼為 2 位元組資料，解碼成功。
- 剩餘的 2 位元組 - 解碼為 1 位元組資料。 解碼成功了。
- 剩餘 1 位元組 - 為無效輸入，導致 FormatException。
適用於
DecodeFromUtf8(ReadOnlySpan<Byte>, Span<Byte>, Int32, Int32, Boolean)
將以 Base64Url 表示的 UTF-8 編碼文字範圍解碼為二進位資料。
public static System.Buffers.OperationStatus DecodeFromUtf8(ReadOnlySpan<byte> source, Span<byte> destination, out int bytesConsumed, out int bytesWritten, bool isFinalBlock = true);static member DecodeFromUtf8 : ReadOnlySpan<byte> * Span<byte> * int * int * bool -> System.Buffers.OperationStatusPublic Shared Function DecodeFromUtf8 (source As ReadOnlySpan(Of Byte), destination As Span(Of Byte), ByRef bytesConsumed As Integer, ByRef bytesWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatus參數
- source
- ReadOnlySpan<Byte>
輸入區間包含 UTF-8 編碼的 Base64Url 文字，需解碼。
- bytesConsumed
- Int32
當此方法回傳時，包含操作過程中消耗的輸入位元組數。 若有需要，這可以用來切片後續呼叫的輸入。 此參數被視為未初始化。
- bytesWritten
- Int32
當此方法回傳時，包含寫入輸出區間的位元組數。 若有需要，這可用來切片後續呼叫的輸出。 此參數被視為未初始化。
- isFinalBlock
- Boolean
true 當輸入區間包含全部需編碼的資料時; false 當更多資料可能跟進時，
例如在迴圈中呼叫時。 呼叫 後 false 應接著另一個呼叫，該參數為 true call。 預設值為 true。
傳回
其中一個列舉值，表示操作的成功或失敗。
備註
由於 Base64Url source 的填充是可選的，長度不必是 4 的倍數，即使 isFinalBlock 。true
若 source 長度不是4的倍數，且 isFinalBlock 餘 true 數可依此解碼：
- 剩餘的 3 位元組 - 解碼為 2 位元組資料，解碼成功。
- 剩餘的 2 位元組 - 解碼為 1 位元組資料。 解碼成功了。
- 剩餘 1 位元組 - 會產生 OperationStatus.InvalidData 結果。
