UTF7Encoding Sınıf

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Text.Encoding.Extensions.dll

Kaynak:

UTF7Encoding.cs

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

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

public class UTF7Encoding : System.Text.Encoding

type UTF7Encoding = class
    inherit Encoding

Public Class UTF7Encoding
Inherits Encoding

Devralma

Object

Encoding

UTF7Encoding

Örnekler

Aşağıdaki kod örneği, Unicode karakter dizesini kodlamak ve bunları bir bayt dizisinde depolamak için nasıl kullanılacağını UTF7Encoding gösterir. Bayt dizisinin kodu bir dizeye geri döndürüldüyse veri kaybı yaşanmaz.

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

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 kodlamaya izin vermediğinden, UTF-8 normalde UTF-7 için tercih edilmelidir.

Not

UTF7Encoding hata algılama sağlamaz. Güvenlik nedeniyle, uygulama , UnicodeEncodingveya UTF32Encoding kullanmalı UTF8Encodingve hata algılamayı etkinleştirmelidir.

UTF'ler ve tarafından System.Textdesteklenen diğer kodlamalar hakkında daha fazla bilgi için, .NET Framework karakter kodlama bölümüne bakın.

GetByteCount yöntemi, bir Unicode karakter kümesini kodlamanın kaç baytla sonuçlandığını GetBytes belirler ve yöntem gerçek kodlamayı gerçekleştirir.

Benzer şekilde yöntemi, GetCharCount bayt dizisinin kodunun çö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.

Not

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

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

Özellikler

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 Encoding nesnenin DecoderFallback nesnesini alır veya ayarlar. (Devralındığı yer: Encoding)
EncoderFallback	Geçerli Encoding nesnenin EncoderFallback 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 insan tarafından 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ılabilen 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 içeriği görüntülemek için tarayıcı istemcileri tarafından 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)
Preamble	Türetilmiş bir sınıfta geçersiz kılındığında, kullanılan kodlamayı belirten bayt dizisini içeren bir span döndürür. (Devralındığı yer: Encoding)
WebName	Türetilmiş bir sınıfta geçersiz kılındığında, geçerli kodlama için İnternet Atanmış 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 kod sayfasını alır. (Devralındığı yer: Encoding)

Yöntemler

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)	Belirtilen karakter işaretçisinde başlayan bir karakter kümesini 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, Int32)	Belirtilen karakter dizisinden bir karakter kümesi kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(ReadOnlySpan<Char>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen karakter aralığındaki karakterleri kodlayarak üretilen bayt sayısını hesaplar. (Devralındığı yer: Encoding)
GetByteCount(String)	Belirtilen String nesnedeki karakterleri kodlayarak üretilen bayt sayısını hesaplar.
GetByteCount(String, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizeden bir karakter kümesi kodlayarak üretilen bayt sayısını hesaplar. (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(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, 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[], Int32, Int32, Byte[], Int32)	Belirtilen karakter dizisinden bir dizi karakteri belirtilen bayt dizisine kodlar.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen salt okunur yayılma alanından bir karakter kümesi bayt aralığına kodlar. (Devralındığı yer: Encoding)
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)
GetBytes(String, Int32, Int32)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizede tarafından count belirtilen karakter sayısını belirtilenden başlayarak bayt dizisine indexkodlar. (Devralındığı yer: Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Belirtilenden bir karakter kümesini belirtilen String bayt dizisine kodlar.
GetCharCount(Byte*, Int32)	Belirtilen bayt işaretçisinde başlayan 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, Int32)	Belirtilen bayt dizisinden bir bayt dizisinin kodunu çözerek üretilen karakter sayısını hesaplar.
GetCharCount(ReadOnlySpan<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, sağlanan salt okunur bayt aralığının kodunu çözerek üretilen karakter sayısını hesaplar. (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.
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, 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[], Int32, Int32, Char[], Int32)	Belirtilen bayt dizisinden belirtilen karakter dizisine bayt dizisinin kodunu çözer.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen salt okunur bayt aralığındaki tüm baytların kodunu bir karakter aralığına çözer. (Devralındığı yer: Encoding)
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)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen adresten başlayan belirtilen bayt sayısının kodunu bir dizeye çözer. (Devralındığı yer: Encoding)
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, Int32)	Bayt dizisinden dizeye bayt aralığının kodunu çözer.
GetString(ReadOnlySpan<Byte>)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen bayt aralığındaki tüm baytların kodunu bir dizeye çözer. (Devralındığı yer: Encoding)
GetType()	Type Geçerli örneğini 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 Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Hedef yeterince büyükse, belirtilen salt okunur span'dan bir dizi karakter içeren bayt aralığına kodlar. (Devralındığı yer: Encoding)
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Hedef yeterince büyükse, belirtilen salt okunur yayılma alanından bir dizi karakter aralığına kod çözer. (Devralındığı yer: Encoding)

Uzantı Metotları

GetBytes(Encoding, ReadOnlySequence<Char>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak bir Byte diziye kodlar Encoding.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak Encoding öğesinin bytekodunu çözer ve sonucu öğesine writeryazar.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak Encoding öğesini olarak bytekodlar ve sonucu olarak bytesdöndürür.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Belirtilen ReadOnlySpan<T> öğesini kullanarak Encoding öğesini olarak bytekodlar ve sonucu öğesine writeryazar.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak Encoding öğesinin charkodunu çözer ve sonucu öğesine writeryazar.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Belirtilen ReadOnlySequence<T>charöğesini kullanarak Encoding öğesinin kodunu çözer ve sonucu olarak charsdöndürür.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Belirtilen ReadOnlySpan<T> öğesini kullanarak Encoding öğesinin charkodunu çözer ve sonucu öğesine writeryazar.
GetString(Encoding, ReadOnlySequence<Byte>)	Belirtilen ReadOnlySequence<T> öğesini kullanarak öğesinin kodunu bir String içine Encodingçözer.

Ayrıca bkz.

• Decoder
• Encoder
• Kodlamaları Anlama