UTF7Encoding Kelas

Definisi

Ruang nama:

System.Text

Rakitan:

System.Text.Encoding.Extensions.dll

Sumber:

UTF7Encoding.cs

Mewakili pengodean UTF-7 dari karakter Unicode.

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

public class UTF7Encoding : System.Text.Encoding

type UTF7Encoding = class
    inherit Encoding

Public Class UTF7Encoding
Inherits Encoding

Warisan

Object

Encoding

UTF7Encoding

Contoh

Contoh kode berikut menunjukkan cara menggunakan UTF7Encoding untuk mengodekan string karakter Unicode dan menyimpannya dalam array byte. Perhatikan bahwa ketika array byte didekodekan kembali ke string, tidak ada data yang hilang.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   
   // Create a UTF-7 encoding.
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   
   // A Unicode string with two characters outside a 7-bit code range.
   String^ unicodeString = L"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.
   array<Byte>^encodedBytes = utf7->GetBytes( unicodeString );
   Console::WriteLine();
   Console::WriteLine( "Encoded bytes:" );
   IEnumerator^ myEnum = encodedBytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      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 );
}

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

Keterangan

Pengodean adalah proses mengubah sekumpulan karakter Unicode menjadi urutan byte. Decoding adalah proses mengubah urutan byte yang dikodekan menjadi satu set karakter Unicode.

Pengodean UTF-7 mewakili karakter Unicode sebagai urutan karakter ASCII 7-bit. Pengodean ini mendukung protokol tertentu yang diperlukan, paling sering protokol email atau grup berita. Karena UTF-7 tidak terlalu aman atau kuat, dan sebagian besar sistem modern memungkinkan pengodean 8-bit, UTF-8 biasanya harus lebih disukai daripada UTF-7.

Catatan

UTF7Encoding tidak memberikan deteksi kesalahan. Untuk alasan keamanan, aplikasi harus menggunakan UTF8Encoding, , UnicodeEncodingatau UTF32Encoding dan mengaktifkan deteksi kesalahan.

Untuk informasi selengkapnya tentang UTF dan pengodean lainnya yang didukung oleh System.Text, lihat Pengodean Karakter di .NET Framework.

Metode ini GetByteCount menentukan berapa banyak byte yang menghasilkan pengodean sekumpulan karakter Unicode, dan GetBytes metode melakukan pengodean aktual.

Demikian juga, GetCharCount metode menentukan berapa banyak karakter yang menghasilkan pendekodean urutan byte, dan GetChars metode dan GetString melakukan decoding aktual.

UTF7Encoding sesuai dengan halaman kode Windows 65000.

Catatan

Status objek yang dikodekan UTF-7 tidak dipertahankan jika objek diserialisasikan dan dideserialisasi menggunakan versi .NET Framework yang berbeda.

Konstruktor

UTF7Encoding()	Kedaluwarsa. Menginisialisasi instans baru kelas UTF7Encoding.
UTF7Encoding(Boolean)	Kedaluwarsa. Menginisialisasi instans baru kelas UTF7Encoding. Parameter menentukan apakah akan mengizinkan karakter opsional.

Properti

BodyName	Ketika ditimpa di kelas turunan, mendapatkan nama untuk pengodean saat ini yang dapat digunakan dengan tag isi agen email. (Diperoleh dari Encoding)
CodePage	Ketika ditimpa di kelas turunan, mendapatkan pengidentifikasi halaman kode dari saat ini Encoding. (Diperoleh dari Encoding)
DecoderFallback	Mendapatkan atau mengatur DecoderFallback objek untuk objek saat ini Encoding . (Diperoleh dari Encoding)
EncoderFallback	Mendapatkan atau mengatur EncoderFallback objek untuk objek saat ini Encoding . (Diperoleh dari Encoding)
EncodingName	Ketika ditimpa di kelas turunan, mendapatkan deskripsi yang dapat dibaca manusia dari pengodean saat ini. (Diperoleh dari Encoding)
HeaderName	Ketika ditimpa di kelas turunan, mendapatkan nama untuk pengodean saat ini yang dapat digunakan dengan tag header agen email. (Diperoleh dari Encoding)
IsBrowserDisplay	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien browser untuk menampilkan konten. (Diperoleh dari Encoding)
IsBrowserSave	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien browser untuk menyimpan konten. (Diperoleh dari Encoding)
IsMailNewsDisplay	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien email dan berita untuk menampilkan konten. (Diperoleh dari Encoding)
IsMailNewsSave	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini dapat digunakan oleh klien email dan berita untuk menyimpan konten. (Diperoleh dari Encoding)
IsReadOnly	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini bersifat baca-saja. (Diperoleh dari Encoding)
IsSingleByte	Saat ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini menggunakan titik kode byte tunggal. (Diperoleh dari Encoding)
Preamble	Saat ditimpa di kelas turunan, mengembalikan rentang yang berisi urutan byte yang menentukan pengodean yang digunakan. (Diperoleh dari Encoding)
WebName	Ketika ditimpa di kelas turunan, mendapatkan nama yang terdaftar di Internet Assigned Numbers Authority (IANA) untuk pengodean saat ini. (Diperoleh dari Encoding)
WindowsCodePage	Ketika ditimpa di kelas turunan, mendapatkan halaman kode sistem operasi Windows yang paling sesuai dengan pengodean saat ini. (Diperoleh dari Encoding)

Metode

Clone()	Ketika ditimpa di kelas turunan, membuat salinan dangkal dari objek saat ini Encoding . (Diperoleh dari Encoding)
Equals(Object)	Mendapatkan nilai yang menunjukkan apakah objek yang ditentukan sama dengan objek saat ini UTF7Encoding .
GetByteCount(Char*, Int32)	Menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter yang dimulai pada penunjuk karakter yang ditentukan.
GetByteCount(Char[])	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan semua karakter dalam array karakter yang ditentukan. (Diperoleh dari Encoding)
GetByteCount(Char[], Int32, Int32)	Menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari array karakter yang ditentukan.
GetByteCount(ReadOnlySpan<Char>)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan karakter dalam rentang karakter yang ditentukan. (Diperoleh dari Encoding)
GetByteCount(String)	Menghitung jumlah byte yang dihasilkan dengan mengodekan karakter dalam objek yang ditentukan String .
GetByteCount(String, Int32, Int32)	Saat ditimpa dalam kelas turunan, menghitung jumlah byte yang dihasilkan dengan mengodekan sekumpulan karakter dari string yang ditentukan. (Diperoleh dari Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	Mengodekan sekumpulan karakter yang dimulai pada penunjuk karakter yang ditentukan ke dalam urutan byte yang disimpan mulai dari penunjuk byte yang ditentukan.
GetBytes(Char[])	Saat ditimpa di kelas turunan, mengodekan semua karakter dalam array karakter yang ditentukan ke dalam urutan byte. (Diperoleh dari Encoding)
GetBytes(Char[], Int32, Int32)	Saat ditimpa di kelas turunan, mengodekan sekumpulan karakter dari array karakter yang ditentukan ke dalam urutan byte. (Diperoleh dari Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Mengodekan sekumpulan karakter dari array karakter yang ditentukan ke dalam array byte yang ditentukan.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Ketika ditimpa dalam kelas turunan, mengodekan ke dalam rentang byte satu set karakter dari rentang baca-saja yang ditentukan. (Diperoleh dari Encoding)
GetBytes(String)	Saat ditimpa di kelas turunan, mengodekan semua karakter dalam string yang ditentukan menjadi urutan byte. (Diperoleh dari Encoding)
GetBytes(String, Int32, Int32)	Ketika ditimpa dalam kelas turunan, mengodekan ke dalam array byte jumlah karakter yang ditentukan oleh count dalam string yang ditentukan, dimulai dari yang ditentukan index. (Diperoleh dari Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Mengodekan sekumpulan karakter dari yang ditentukan String ke dalam array byte yang ditentukan.
GetCharCount(Byte*, Int32)	Menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte yang dimulai pada penunjuk byte yang ditentukan.
GetCharCount(Byte[])	Saat ditimpa dalam kelas turunan, menghitung jumlah karakter yang dihasilkan dengan mendekode semua byte dalam array byte yang ditentukan. (Diperoleh dari Encoding)
GetCharCount(Byte[], Int32, Int32)	Menghitung jumlah karakter yang dihasilkan dengan mendekode urutan byte dari array byte yang ditentukan.
GetCharCount(ReadOnlySpan<Byte>)	Ketika ditimpa dalam kelas turunan, menghitung jumlah karakter yang dihasilkan dengan mendekode rentang byte baca-saja yang disediakan. (Diperoleh dari Encoding)
GetChars(Byte*, Int32, Char*, Int32)	Mendekode urutan byte yang dimulai pada penunjuk byte yang ditentukan ke dalam sekumpulan karakter yang disimpan mulai dari penunjuk karakter yang ditentukan.
GetChars(Byte[])	Saat ditimpa dalam kelas turunan, dekode semua byte dalam array byte yang ditentukan menjadi sekumpulan karakter. (Diperoleh dari Encoding)
GetChars(Byte[], Int32, Int32)	Saat ditimpa di kelas turunan, dekode urutan byte dari array byte yang ditentukan menjadi sekumpulan karakter. (Diperoleh dari Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Mendekode urutan byte dari array byte yang ditentukan ke dalam array karakter yang ditentukan.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Saat ditimpa dalam kelas turunan, dekode semua byte dalam rentang byte baca-saja yang ditentukan menjadi rentang karakter. (Diperoleh dari Encoding)
GetDecoder()	Mendapatkan decoder yang mengonversi urutan byte yang dikodekan UTF-7 menjadi urutan karakter Unicode.
GetEncoder()	Mendapatkan encoder yang mengonversi urutan karakter Unicode menjadi urutan byte yang dikodekan UTF-7.
GetHashCode()	Mengembalikan kode hash untuk objek saat ini UTF7Encoding .
GetMaxByteCount(Int32)	Menghitung jumlah maksimum byte yang dihasilkan dengan mengodekan jumlah karakter yang ditentukan.
GetMaxCharCount(Int32)	Menghitung jumlah maksimum karakter yang dihasilkan dengan mendekode jumlah byte yang ditentukan.
GetPreamble()	Saat ditimpa di kelas turunan, mengembalikan urutan byte yang menentukan pengodean yang digunakan. (Diperoleh dari Encoding)
GetString(Byte*, Int32)	Saat ditimpa di kelas turunan, mendekode sejumlah byte tertentu yang dimulai pada alamat tertentu menjadi string. (Diperoleh dari Encoding)
GetString(Byte[])	Saat ditimpa di kelas turunan, dekode semua byte dalam array byte yang ditentukan menjadi string. (Diperoleh dari Encoding)
GetString(Byte[], Int32, Int32)	Mendekode rentang byte dari array byte menjadi string.
GetString(ReadOnlySpan<Byte>)	Saat ditimpa dalam kelas turunan, dekode semua byte dalam rentang byte yang ditentukan menjadi string. (Diperoleh dari Encoding)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IsAlwaysNormalized()	Mendapatkan nilai yang menunjukkan apakah pengodean saat ini selalu dinormalisasi, menggunakan formulir normalisasi default. (Diperoleh dari Encoding)
IsAlwaysNormalized(NormalizationForm)	Ketika ditimpa di kelas turunan, mendapatkan nilai yang menunjukkan apakah pengodean saat ini selalu dinormalisasi, menggunakan bentuk normalisasi yang ditentukan. (Diperoleh dari Encoding)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Mengodekan ke dalam rentang byte sekumpulan karakter dari rentang baca-saja yang ditentukan jika tujuannya cukup besar. (Diperoleh dari Encoding)
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Mendekode ke dalam rentang karakter satu set byte dari rentang baca-saja yang ditentukan jika tujuannya cukup besar. (Diperoleh dari Encoding)

Metode Ekstensi

GetBytes(Encoding, ReadOnlySequence<Char>)	Mengodekan yang ditentukan ReadOnlySequence<T> ke dalam Byte array menggunakan Encoding.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Mendekode yang ditentukan ReadOnlySequence<T> ke bytes menggunakan yang ditentukan Encoding dan menulis hasilnya ke writer.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Mengodekan yang ditentukan ReadOnlySequence<T> ke bytes menggunakan yang ditentukan Encoding dan menghasilkan hasilnya ke bytes.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Mengodekan yang ditentukan ReadOnlySpan<T> ke bytes menggunakan yang ditentukan Encoding dan menulis hasilnya ke writer.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Mendekode yang ditentukan ReadOnlySequence<T> ke chars menggunakan yang ditentukan Encoding dan menulis hasilnya ke writer.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Mendekode yang ditentukan ReadOnlySequence<T> ke chars menggunakan yang ditentukan Encoding dan menghasilkan hasilnya ke chars.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Mendekode yang ditentukan ReadOnlySpan<T> ke chars menggunakan yang ditentukan Encoding dan menulis hasilnya ke writer.
GetString(Encoding, ReadOnlySequence<Byte>)	Mendekode yang ditentukan ReadOnlySequence<T> ke dalam String menggunakan yang ditentukan Encoding.

Lihat juga

• Decoder
• Encoder
• Memahami Pengodean