Text.ToBinary

Sintassi

Text.ToBinary(
    text as nullable text,
    optional encoding as nullable number,
    optional includeByteOrderMark as nullable logical
) as nullable binary

Informazioni su

Codifica un valore di testo in un valore binario usando la codifica specificata.

• text: testo da codificare.
• encoding: (Facoltativo) Codifica utilizzata per convertire il testo in binario. Usare BinaryEncoding.Type per specificare il tipo di codifica. Se questo valore non viene specificato, il valore predefinito è BinaryEncoding.Utf8.
• includeByteOrderMark: (Facoltativo) Determina se un byte Order Mark (BOM) deve essere incluso all'inizio dell'output binario. Impostare su true per includere automaticamente il BOM, in caso contrario false. Se questo valore non viene specificato, il valore predefinito è false.

Esempio 1

Codificare il testo in formato binario, produrre una stringa Base64 visualizzabile, quindi decodificarla di nuovo in testo.

Utilizzo

let
    originalText = "Testing 1-2-3",

    // Default UTF-8 binary
    binaryData = Text.ToBinary(originalText),

    // Convert binary to viewable Base64 string
    encodedText = Binary.ToText(binaryData, BinaryEncoding.Base64),

    // Decode back to text
    decodedText = Text.FromBinary(binaryData),

    result = [
        OriginalText = originalText,
        BinaryBase64 = encodedText,
        DecodedText = decodedText
    ]
in
    result

Risultato

[
    OriginalText = "Testing 1-2-3",
    BinaryEncoded = "VGVzdGluZyAxLTItMw==",
    DecodedText = "Testing 1-2-3"
]

Esempio 2

Codificare il testo in formato binario con un byte Order Mark (BOM), produrre una stringa esadecimale visualizzabile, quindi decodificarla di nuovo nel testo.

Utilizzo

let
    originalText = "Testing 1-2-3",

    // Convert to binary with BOM
    binaryData = Text.ToBinary(originalText, TextEncoding.Utf16, true),

    // Show binary as hex to demonstrate presence of BOM (fffe)
    binaryAsHex = Binary.ToText(binaryData, BinaryEncoding.Hex),

    // Decode back to text
    decodedText = Text.FromBinary(binaryData, TextEncoding.Utf16),

    // Compare original text and decoded text
    isIdentical = originalText = decodedText,

    result = [
        OriginalText = originalText,
        BinaryHex = binaryAsHex,
        DecodedText = decodedText,
        IsIdentical = isIdentical
    ]
in
    result

Risultato

[
    OriginalText = "Testing 1-2-3", 
    DecodedText = "fffe540065007300740069006e006700200031002d0032002d003300",
    DecodedText = "Testing 1-2-3", 
    IsIdentical = true 
]