UTF7Encoding Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

mscorlib.dll

Unicode karakterlerinin UTF-7 kodlamalarını temsil eder.

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

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class UTF7Encoding : System.Text.Encoding

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UTF7Encoding = class
    inherit Encoding

Public Class UTF7Encoding
Inherits Encoding

Devralma

Object

Encoding

UTF7Encoding

Öznitelikler

SerializableAttribute ComVisibleAttribute

Örnekler

Aşağıdaki kod örneği, UTF7Encoding Unicode karakter dizesini kodlamak ve bunları bayt dizisinde depolamak için nasıl kullanılacağını gösterir. Bayt dizisinin kodunu bir dizeye geri döndürdüğünüzde hiçbir verinin kaybolmadığını fark edin.

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

Açıklamalar

Kodlama, bir Unicode karakter kümesini bayt dizisine dönüştürme işlemidir. Kod çözme, kodlanmış bayt dizisini unicode karakter kümesine dönüştürme işlemidir.

UTF-7 kodlaması, Unicode karakterleri 7 bit ASCII karakter dizileri olarak temsil eder. Bu kodlama, çoğu zaman e-posta veya haber grubu protokolleri gibi gerekli olduğu belirli protokolleri destekler. UTF-7 özellikle güvenli veya sağlam olmadığından ve çoğu modern sistem 8 bit kodlamalara izin vermediğinden, UTF-8 normalde UTF-7'ye tercih edilmelidir.

Note

UTF7Encoding hata algılama sağlamaz. Güvenlik nedeniyle, uygulamanın , UnicodeEncodingveya UTF32Encoding kullanması UTF8Encodingve hata algılamayı etkinleştirmesi gerekir.

UTF'ler ve tarafından System.Textdesteklenen diğer kodlamalar hakkında daha fazla bilgi için bkz. .NET Framework'te Karakter Kodlama.

GetByteCount yöntemi, kaç bayt sonucunun bir Unicode karakter kümesini kodlamaya GetBytes neden olduğunu belirler ve yöntem gerçek kodlamayı gerçekleştirir.

Benzer şekilde yöntemi, GetCharCount bayt dizisinin çözülmesiyle sonuçlanan karakter sayısını belirler ve GetChars ve GetString yöntemleri gerçek kod çözme işlemini gerçekleştirir.

UTF7Encoding, 65000 Windows kod sayfasına karşılık gelir.

Note

UtF-7 kodlanmış nesnesinin durumu, nesne farklı .NET Framework sürümleri kullanılarak seri hale getirilir ve seri durumdan çıkarılırsa korunmaz.

Oluşturucular

Name	Description
UTF7Encoding()	UTF7Encoding sınıfının yeni bir örneğini başlatır.
UTF7Encoding(Boolean)	UTF7Encoding sınıfının yeni bir örneğini başlatır. Parametresi, isteğe bağlı karakterlere izin verilip verilmeyeceğini belirtir.

Özellikler

Name	Description
BodyName	Türetilmiş bir sınıfta geçersiz kılındığında, posta aracısı gövde etiketleriyle kullanılabilen geçerli kodlama için bir ad alır. (Devralındığı yer: Encoding)
CodePage	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli Encodingöğesinin kod sayfası tanımlayıcısını alır. (Devralındığı yer: Encoding)
DecoderFallback	Geçerli DecoderFallback nesnenin Encoding nesnesini alır veya ayarlar. (Devralındığı yer: Encoding)
EncoderFallback	Geçerli EncoderFallback nesnenin Encoding nesnesini alır veya ayarlar. (Devralındığı yer: Encoding)
EncodingName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın okunabilir açıklamasını alır. (Devralındığı yer: Encoding)
HeaderName	Türetilmiş bir sınıfta geçersiz kılındığında, posta aracısı üst bilgi etiketleriyle kullanılabilecek geçerli kodlama için bir ad alır. (Devralındığı yer: Encoding)
IsBrowserDisplay	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın tarayıcı istemcileri tarafından içeriği görüntülemek için kullanılıp kullanılamayacağını belirten bir değer alır. (Devralındığı yer: Encoding)
IsBrowserSave	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın içeriği kaydetmek için tarayıcı istemcileri tarafından kullanılıp kullanılamayacağını belirten bir değer alır. (Devralındığı yer: Encoding)
IsMailNewsDisplay	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın posta ve haber istemcileri tarafından içerik görüntülemek için kullanılıp kullanılamayacağını belirten bir değer alır. (Devralındığı yer: Encoding)
IsMailNewsSave	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın içeriği kaydetmek için posta ve haber istemcileri tarafından kullanılıp kullanılamayacağını belirten bir değer alır. (Devralındığı yer: Encoding)
IsReadOnly	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın salt okunur olup olmadığını belirten bir değer alır. (Devralındığı yer: Encoding)
IsSingleByte	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamanın tek bayt kod noktaları kullanıp kullanmadığını belirten bir değer alır. (Devralındığı yer: Encoding)
WebName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlama için İnternet Atanan Numaralar Yetkilisi'ne (IANA) kaydedilen adı alır. (Devralındığı yer: Encoding)
WindowsCodePage	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlamaya en yakın olan Windows işletim sistemi kodu sayfasını alır. (Devralındığı yer: Encoding)

Yöntemler

Name	Description
Clone()	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli Encoding nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: Encoding)
Equals(Object)	Belirtilen nesnenin geçerli UTF7Encoding nesneye eşit olup olmadığını belirten bir değer alır.
GetByteCount(Char[], Int32, Int32)	Belirtilen karakter dizisinden bir karakter kümesi kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri kodlayarak üretilen bayt sayısını hesaplar. (Devralındığı yer: Encoding)
GetByteCount(Char*, Int32)	Belirtilen karakter işaretçisinde başlayan bir karakter kümesini kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(String)	Belirtilen String nesnedeki karakterleri kodlayarak üretilen bayt sayısını hesaplar.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Belirtilen karakter dizisinden bir dizi karakteri belirtilen bayt dizisine kodlar.
GetBytes(Char[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki bir karakter kümesini bayt dizisine kodlar. (Devralındığı yer: Encoding)
GetBytes(Char[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter dizisindeki tüm karakterleri bayt dizisine kodlar. (Devralındığı yer: Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	Belirtilen karakter işaretçisinde başlayan bir karakter kümesini, belirtilen bayt işaretçisinde başlayan bir bayt dizisine kodlar.
GetBytes(String, Int32, Int32, Byte[], Int32)	Belirtilenden bir dizi karakteri belirtilen String bayt dizisine kodlar.
GetBytes(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizedeki tüm karakterleri bir bayt dizisine kodlar. (Devralındığı yer: Encoding)
GetCharCount(Byte[], Int32, Int32)	Belirtilen bayt dizisinden bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu çözerek üretilen karakter sayısını hesaplar. (Devralındığı yer: Encoding)
GetCharCount(Byte*, Int32)	Belirtilen bayt işaretçisinde başlayan bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Belirtilen bayt dizisinden belirtilen karakter dizisine bayt dizisinin kodunu çözer.
GetChars(Byte[], Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki bayt dizisinin kodunu bir karakter kümesine çözer. (Devralındığı yer: Encoding)
GetChars(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu bir karakter kümesine çözer. (Devralındığı yer: Encoding)
GetChars(Byte*, Int32, Char*, Int32)	Belirtilen bayt işaretçisinde başlayan bayt dizisinin kodunu, belirtilen karakter işaretçisinde başlayan bir dizi karaktere dönüştürür.
GetDecoder()	UTF-7 kodlanmış bayt dizisini Unicode karakter dizisine dönüştüren bir kod çözücü alır.
GetEncoder()	Unicode karakter dizisini UTF-7 kodlanmış bayt dizisine dönüştüren bir kodlayıcı alır.
GetHashCode()	Geçerli UTF7Encoding nesnenin karma kodunu döndürür.
GetMaxByteCount(Int32)	Belirtilen karakter sayısını kodlayarak üretilen en fazla bayt sayısını hesaplar.
GetMaxCharCount(Int32)	Belirtilen bayt sayısının kodunu çözerek üretilen en fazla karakter sayısını hesaplar.
GetPreamble()	Türetilmiş bir sınıfta geçersiz kılındığında, kullanılan kodlamayı belirten bir bayt dizisi döndürür. (Devralındığı yer: Encoding)
GetString(Byte[], Int32, Int32)	Bayt dizisinden dizeye bayt aralığının kodunu çözer.
GetString(Byte[])	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt dizisindeki tüm baytların kodunu bir dizeye çözer. (Devralındığı yer: Encoding)
GetString(Byte*, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bir adresten başlayan belirtilen sayıda bayt kodunu bir dizeye çözer. (Devralındığı yer: Encoding)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsAlwaysNormalized()	Varsayılan normalleştirme formunu kullanarak geçerli kodlamanın her zaman normalleştirilip normalleştirilmediğini belirten bir değer alır. (Devralındığı yer: Encoding)
IsAlwaysNormalized(NormalizationForm)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen normalleştirme formunu kullanarak geçerli kodlamanın her zaman normalleştirilip normalleştirilmediğini belirten bir değer alır. (Devralındığı yer: Encoding)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• Decoder
• Encoder
• Kodlamaları Anlama