Base64Url.DecodeFromChars 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| DecodeFromChars(ReadOnlySpan<Char>) |
將以Base64Url表示的 Unicode ASCII 字元範圍譯碼為二進位數據。 |
| DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>) |
將以Base64Url表示的 Unicode ASCII 字元範圍譯碼為二進位數據。 |
| DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>, Int32, Int32, Boolean) |
將以Base64Url表示的 Unicode ASCII 字元範圍譯碼為二進位數據。 |
DecodeFromChars(ReadOnlySpan<Char>)
將以Base64Url表示的 Unicode ASCII 字元範圍譯碼為二進位數據。
public:
static cli::array <System::Byte> ^ DecodeFromChars(ReadOnlySpan<char> source);
public static byte[] DecodeFromChars(ReadOnlySpan<char> source);
static member DecodeFromChars : ReadOnlySpan<char> -> byte[]
Public Shared Function DecodeFromChars (source As ReadOnlySpan(Of Char)) As Byte()
參數
- source
- ReadOnlySpan<Char>
輸入範圍,其中包含Base64Url中需要譯碼的ASCII字元。
傳回
位元組陣列,其中包含譯碼作業的結果。
例外狀況
適用於
DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>)
將以Base64Url表示的 Unicode ASCII 字元範圍譯碼為二進位數據。
public:
static int DecodeFromChars(ReadOnlySpan<char> source, Span<System::Byte> destination);
public static int DecodeFromChars(ReadOnlySpan<char> source, Span<byte> destination);
static member DecodeFromChars : ReadOnlySpan<char> * Span<byte> -> int
Public Shared Function DecodeFromChars (source As ReadOnlySpan(Of Char), destination As Span(Of Byte)) As Integer
參數
- source
- ReadOnlySpan<Char>
輸入範圍,其中包含Base64Url中需要譯碼的ASCII字元。
傳回
寫入輸出範圍的位元組數目。 如有必要,這可用來為後續呼叫配量輸出。
例外狀況
destination 中的緩衝區太小,無法保存編碼的輸出。
適用於
DecodeFromChars(ReadOnlySpan<Char>, Span<Byte>, Int32, Int32, Boolean)
將以Base64Url表示的 Unicode ASCII 字元範圍譯碼為二進位數據。
public static System.Buffers.OperationStatus DecodeFromChars(ReadOnlySpan<char> source, Span<byte> destination, out int charsConsumed, out int bytesWritten, bool isFinalBlock = true);
static member DecodeFromChars : ReadOnlySpan<char> * Span<byte> * int * int * bool -> System.Buffers.OperationStatus
Public Shared Function DecodeFromChars (source As ReadOnlySpan(Of Char), destination As Span(Of Byte), ByRef charsConsumed As Integer, ByRef bytesWritten As Integer, Optional isFinalBlock As Boolean = true) As OperationStatus
參數
- source
- ReadOnlySpan<Char>
輸入範圍,其中包含Base64Url中需要譯碼的Unicode ASCII字元。
- charsConsumed
- Int32
當這個方法傳回時,會包含作業期間所取用的輸入字元數目。 如有必要,這可以用來為後續呼叫配量輸入。 此參數會被視為未初始化。
- bytesWritten
- Int32
當這個方法傳回時,會包含寫入輸出範圍的位元元組數目。 如有必要,這可用來為後續呼叫配量輸出。 此參數會被視為未初始化。
- isFinalBlock
- Boolean
當輸入範圍包含要編碼的完整數據時,true;false 可能會追蹤更多數據時,
例如,在迴圈中呼叫 時。 使用 false 的呼叫應該跟著另一個呼叫,其中此參數是 true 呼叫。 預設值為 true。
傳回
其中一個列舉值,指出作業的成功或失敗。
備註
因為Base64Url的填補是選擇性的,即使 isFinalBlocktrue,source 長度不需要為4的倍數。
如果 source 長度不是 4 的倍數,且 isFinalBlocktrue 會據以譯碼的餘數:
- 其餘 3 個字元 - 譯碼為 2 個字節數據,譯碼成功。
- 其餘 2 個字元 - 譯碼為 1 個字節數據。 譯碼成功。
- 其餘 1 個字元 - 將會導致 OperationStatus.InvalidData 結果。