UTF7Encoding Osztály

Definíció

Névtér:

System.Text

Szerelvények:

netstandard.dll, System.Text.Encoding.Extensions.dll

Forrás:

UTF7Encoding.cs

Unicode-karakterek UTF-7 kódolását jelöli.

public ref class UTF7Encoding : System::Text::Encoding

public class UTF7Encoding : System.Text.Encoding

type UTF7Encoding = class
    inherit Encoding

Public Class UTF7Encoding
Inherits Encoding

Öröklődés

Object

Encoding

UTF7Encoding

Példák

Az alábbi példakód bemutatja, hogyan kódolhat UTF7Encoding Unicode-karakterekből álló sztringeket, és hogyan tárolhatja őket egy bájttömbben. Figyelje meg, hogy ha a bájttömb vissza van állítva egy sztringre, a függvény nem veszt el adatokat.

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        // Create a UTF-7 encoding.
        UTF7Encoding utf7 = new UTF7Encoding();
        
        // A Unicode string with two characters outside a 7-bit code range.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside a 7-bit code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = utf7.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = utf7.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        ' Create a UTF-7 encoding.
        Dim utf7 As New UTF7Encoding()
        
        ' A Unicode string with two characters outside a 7-bit code range.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside a 7-bit code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte() = utf7.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In  encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
        
        ' Decode bytes back to string.
        ' Notice Pi and Sigma characters are still present.
        Dim decodedString As String = utf7.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class

Megjegyzések

A kódolás a Unicode-karakterek halmazának bájtok sorozatává alakításának folyamata. A dekódolás a kódolt bájtok sorozatának Unicode-karakterekből álló készletté alakításának folyamata.

Az UTF-7 kódolás unicode karaktereket jelöl 7 bites ASCII-karakterek sorozataként. Ez a kódolás támogatja azokat a protokollokat, amelyekre szükség van, leggyakrabban e-mail- vagy hírcsoport-protokollokat. Mivel az UTF-7 nem különösen biztonságos vagy robusztus, és a legtöbb modern rendszer 8 bites kódolást engedélyez, az UTF-8-at általában előnyben kell részesíteni az UTF-7-nek.

Note

UTF7Encoding nem biztosít hibaészlelést. Biztonsági okokból az alkalmazásnak használnia UTF8EncodingUnicodeEncodingUTF32Encoding vagy engedélyeznie kell a hibaészlelést.

Az System.Text által támogatott UTF-ekről és más kódolásokról további információt a Acharacter kódolása a .NET-keretrendszerben talál.

A GetByteCount metódus meghatározza, hogy hány bájtot eredményez egy Unicode-karakterkészlet kódolása, és a GetBytes metódus végrehajtja a tényleges kódolást.

Hasonlóképpen, a GetCharCount metódus meghatározza, hogy hány karakter okozza a bájtok sorozatának dekódolását, és a GetCharsGetString metódusok elvégzik a tényleges dekódolást.

UTF7Encoding a 65000-Windows kódlapnak felel meg.

Note

Az UTF-7 kódolású objektumok állapota nem marad meg, ha az objektum szerializálva és deszerializálva van különböző .NET Framework-verziók használatával.

Konstruktorok

Name	Description
UTF7Encoding()	Elavult. Inicializálja a UTF7Encoding osztály új példányát.
UTF7Encoding(Boolean)	Elavult. Inicializálja a UTF7Encoding osztály új példányát. A paraméter megadja, hogy engedélyezi-e a választható karaktereket.

Tulajdonságok

Name	Description
BodyName	Ha felül van bírálva egy származtatott osztályban, megkapja az aktuális kódolás nevét, amely a levelezési ügynök törzscímkéivel használható. (Öröklődés forrása Encoding)
CodePage	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális Encodingkódlap azonosítóját. (Öröklődés forrása Encoding)
DecoderFallback	Lekéri vagy beállítja az DecoderFallback aktuális Encoding objektum objektumát. (Öröklődés forrása Encoding)
EncoderFallback	Lekéri vagy beállítja az EncoderFallback aktuális Encoding objektum objektumát. (Öröklődés forrása Encoding)
EncodingName	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális kódolás ember által olvasható leírását. (Öröklődés forrása Encoding)
HeaderName	Ha felül van bírálva egy származtatott osztályban, lekéri az aktuális kódolás nevét, amely a levelezési ügynök fejléccímkéivel használható. (Öröklődés forrása Encoding)
IsBrowserDisplay	Ha egy származtatott osztályban felül van bírálva, egy értéket kap, amely jelzi, hogy a böngészőügyfelek használhatják-e az aktuális kódolást a tartalom megjelenítéséhez. (Öröklődés forrása Encoding)
IsBrowserSave	Ha egy származtatott osztályban felül van bírálva, egy értéket kap, amely jelzi, hogy a böngészőügyfelek használhatják-e az aktuális kódolást a tartalom mentéséhez. (Öröklődés forrása Encoding)
IsMailNewsDisplay	Ha egy származtatott osztályban felül van bírálva, a rendszer egy értéket kap, amely jelzi, hogy az aktuális kódolás használható-e a levelezési és híralkalmazások számára a tartalom megjelenítéséhez. (Öröklődés forrása Encoding)
IsMailNewsSave	Ha felül van bírálva egy származtatott osztályban, egy értéket kap, amely jelzi, hogy az aktuális kódolás használható-e a levelezési és híralkalmazások számára a tartalom mentéséhez. (Öröklődés forrása Encoding)
IsReadOnly	Ha egy származtatott osztályban felül van bírálva, egy értéket kap, amely jelzi, hogy az aktuális kódolás írásvédett-e. (Öröklődés forrása Encoding)
IsSingleByte	Ha egy származtatott osztályban felül van bírálva, egy értéket kap, amely jelzi, hogy az aktuális kódolás egy bájtos kódpontokat használ-e. (Öröklődés forrása Encoding)
Preamble	Ha egy származtatott osztályban felülbírált, a használt kódolást meghatározó bájtok sorozatát tartalmazó spant ad vissza. (Öröklődés forrása Encoding)
WebName	Ha felül van bírálva egy származtatott osztályban, az aktuális kódoláshoz az Internet Assigned Numbers Authority (IANA) regisztrálja a nevet. (Öröklődés forrása Encoding)
WindowsCodePage	Ha felül van bírálva egy származtatott osztályban, lekéri a Windows operációs rendszer kódlapját, amely a leginkább megfelel az aktuális kódolásnak. (Öröklődés forrása Encoding)

Metódusok

Name	Description
Clone()	Ha felül van bírálva egy származtatott osztályban, létrehozza az aktuális Encoding objektum sekély másolatát. (Öröklődés forrása Encoding)
Equals(Object)	Beolvas egy értéket, amely jelzi, hogy a megadott objektum egyenlő-e az aktuális UTF7Encoding objektummal.
GetByteCount(Char[], Int32, Int32)	Kiszámítja a megadott karaktertömbből származó karakterkészlet kódolásával előállított bájtok számát.
GetByteCount(Char[])	Származtatott osztályban felülbírálva kiszámítja a megadott karaktertömb összes karakterének kódolásával előállított bájtok számát. (Öröklődés forrása Encoding)
GetByteCount(Char*, Int32)	Kiszámítja a megadott karaktermutatótól kezdődő karakterkészlet kódolásával előállított bájtok számát.
GetByteCount(ReadOnlySpan<Char>)	Származtatott osztályban felülbírálva kiszámítja a megadott karaktertartományban lévő karakterek kódolásával előállított bájtok számát. (Öröklődés forrása Encoding)
GetByteCount(String, Int32, Int32)	Származtatott osztályban felülbírálva kiszámítja a megadott sztring egy karakterkészletének kódolásával előállított bájtok számát. (Öröklődés forrása Encoding)
GetByteCount(String)	Kiszámítja a megadott String objektumban lévő karakterek kódolásával előállított bájtok számát.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Egy karakterkészletet kódol a megadott karaktertömbből a megadott bájttömbbe.
GetBytes(Char[], Int32, Int32)	Ha egy származtatott osztályban felülbírált, a megadott karaktertömb karakterkészletét bájtok sorozatába kódolja. (Öröklődés forrása Encoding)
GetBytes(Char[])	Ha felülbírált egy származtatott osztályban, a megadott karaktertömb összes karakterét bájtok sorozatába kódolja. (Öröklődés forrása Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	A megadott karaktermutatótól kezdődő karakterkészletet bájtok sorozatába kódolja, amelyek a megadott bájtmutatótól kezdve vannak tárolva.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Ha egy származtatott osztályban felülbírált, bájtok közötti tartományba kódolja a megadott írásvédett tartomány karakterkészletét. (Öröklődés forrása Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	A megadott String bájttömbbe kódol egy karakterkészletet.
GetBytes(String, Int32, Int32)	Ha egy származtatott osztályban felülbírált, bájtokból álló tömbbe kódolja a megadott sztringben megadott count karakterek számát a megadott indexkarakterláncból kiindulva. (Öröklődés forrása Encoding)
GetBytes(String)	Ha felülbírált egy származtatott osztályban, a megadott sztringben szereplő összes karaktert bájtok sorozatába kódolja. (Öröklődés forrása Encoding)
GetCharCount(Byte[], Int32, Int32)	A megadott bájttömbből származó bájtsorozat dekódolásával előállított karakterek számát számítja ki.
GetCharCount(Byte[])	Származtatott osztályban felülbírálva kiszámítja a megadott bájttömb összes bájtjának dekódolásával előállított karakterek számát. (Öröklődés forrása Encoding)
GetCharCount(Byte*, Int32)	A megadott bájtmutatótól kezdődő bájtsor dekódolásával előállított karakterek számát számítja ki.
GetCharCount(ReadOnlySpan<Byte>)	Ha egy származtatott osztályban felül van bírálva, kiszámítja a megadott írásvédett bájttartomány dekódolásával előállított karakterek számát. (Öröklődés forrása Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Bájtok sorozatát dekódolja a megadott bájttömbből a megadott karaktertömbbe.
GetChars(Byte[], Int32, Int32)	Ha egy származtatott osztályban felülbírál, a megadott bájttömbből származó bájtok sorozatát karakterkészletté dekódolja. (Öröklődés forrása Encoding)
GetChars(Byte[])	Származtatott osztályban felülbírálva a megadott bájttömb összes bájtját karakterkészletté alakítja. (Öröklődés forrása Encoding)
GetChars(Byte*, Int32, Char*, Int32)	A megadott bájtmutatótól kezdve a bájtok sorozatát a megadott karaktermutatótól kezdődően tárolt karakterkészletté dekódolja.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Ha egy származtatott osztályban felülbírál, a megadott írásvédett bájttartományban lévő összes bájtot karakterskávé alakítja. (Öröklődés forrása Encoding)
GetDecoder()	Lekér egy dekódolót, amely UTF-7 kódolású bájtok sorozatát Unicode-karakterek sorozatává alakítja.
GetEncoder()	Beolvas egy kódolót, amely Unicode-karakterek sorozatát UTF-7 kódolású bájtok sorozatává alakítja.
GetHashCode()	Az aktuális UTF7Encoding objektum kivonatkódját adja vissza.
GetMaxByteCount(Int32)	Kiszámítja a megadott számú karakter kódolásával előállított bájtok maximális számát.
GetMaxCharCount(Int32)	Kiszámítja a megadott bájtszám dekódolásával előállított karakterek maximális számát.
GetPreamble()	Ha felülbírált egy származtatott osztályban, a használt kódolást meghatározó bájtok sorozatát adja vissza. (Öröklődés forrása Encoding)
GetString(Byte[], Int32, Int32)	Bájttartományt kódol egy bájttömbből egy sztringbe.
GetString(Byte[])	Származtatott osztályban felülbírálva a megadott bájttömb összes bájtját sztringgé alakítja. (Öröklődés forrása Encoding)
GetString(Byte*, Int32)	Ha egy származtatott osztályban felülbírál, egy megadott címtől kezdődően megadott számú bájtot kódol sztringgé. (Öröklődés forrása Encoding)
GetString(ReadOnlySpan<Byte>)	Származtatott osztályban felülbírálva a megadott bájttartomány összes bájtját sztringgé alakítja. (Öröklődés forrása Encoding)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsAlwaysNormalized()	Beolvas egy értéket, amely jelzi, hogy az aktuális kódolás mindig normalizálva van-e az alapértelmezett normalizálási űrlap használatával. (Öröklődés forrása Encoding)
IsAlwaysNormalized(NormalizationForm)	Ha egy származtatott osztályban felül van bírálva, egy értéket kap, amely jelzi, hogy az aktuális kódolás mindig normalizálva van-e a megadott normalizálási űrlap használatával. (Öröklődés forrása Encoding)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	A megadott írásvédett tartományból származó karaktereket bájtok halmazára kódolja, ha a cél elég nagy. (Öröklődés forrása Encoding)
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	A megadott írásvédett tartományból származó bájtok halmazát dekódolja, ha a cél elég nagy. (Öröklődés forrása Encoding)

Bővítő metódusok

Name	Description
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Dekódolja a megadott ReadOnlySequence<T> értéket a megadott értékrebyte, és az eredményt a következőre writerEncoding írja: .
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	A megadott értéket kódolja a megadott ReadOnlySequence<T> értékrebyte, és az eredményt a következőre bytesEncoding adja ki: .
GetBytes(Encoding, ReadOnlySequence<Char>)	A megadott tömbbe Byte kódolja a megadott .ReadOnlySequence<T>Encoding
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Kódolja a megadott ReadOnlySpan<T> értéket a megadott értékrebyte, és az eredményt a következőre writerEncoding írja: .
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Dekódolja a megadott ReadOnlySequence<T> értéket a megadott értékrechar, és az eredményt a következőre writerEncoding írja: .
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Dekódolja a megadott ReadOnlySequence<T> értéket a megadott értékrechar, és az eredményt a következőre charsEncoding adja ki: .
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Dekódolja a megadott ReadOnlySpan<T> értéket a megadott értékrechar, és az eredményt a következőre writerEncoding írja: .
GetString(Encoding, ReadOnlySequence<Byte>)	A megadott kód dekódolása a String megadott ReadOnlySequence<T>Encodinghasználatával.

Lásd még

• Decoder
• Encoder
• A kódolások ismertetése