UTF7Encoding Oluşturucular

Tanım

Ad Alanı:

System.Text

Bütünleştirilmiş Kod:

System.Text.Encoding.Extensions.dll

UTF7Encoding sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

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.

UTF7Encoding()

Kaynak:

UTF7Encoding.cs

Dikkat

The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.

UTF7Encoding sınıfının yeni bir örneğini başlatır.

public:
 UTF7Encoding();

[System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public UTF7Encoding ();

Public Sub New ()

Öznitelikler

ObsoleteAttribute

Örnekler

Aşağıdaki kod örneği, yeni UTF7Encoding bir örneğin nasıl oluşturulacağını ve kodlamanın adını nasıl görüntüleneceğini gösterir.

using namespace System;
using namespace System::Text;
int main()
{
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   String^ encodingName = utf7->EncodingName;
   Console::WriteLine( "Encoding name: {0}", encodingName );
}

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        UTF7Encoding utf7 = new UTF7Encoding();
        String encodingName = utf7.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}

Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim utf7 As New UTF7Encoding()
        Dim encodingName As String = utf7.EncodingName
        Console.WriteLine("Encoding name: " & encodingName)
    End Sub
End Class

Açıklamalar

Bu oluşturucu isteğe bağlı karakterlere izin vermeyen bir örnek oluşturur. Oluşturucuyu UTF7Encoding çağırmak, bir allowOptionals parametre alan oluşturucuyu UTF7Encoding.UTF7Encoding(Boolean) çağırmaya ve bu parametre için belirtmeye false eşdeğerdir.

Örnek isteğe bağlı karakterlere izin veriyorsa, Unicode kod noktaları değiştirilmiş temel 64 karakter yerine karşılık gelen isteğe bağlı karakterle kodlanır. İsteğe bağlı karakterler ünlem işareti ("!"), ters eğik çizgi ("\"), dikey çizgi ("|"), çift tırnak ("""), sayı işareti ("#"), dolar işareti ("$"), yüzde işareti ("%"), ve işareti ("&"), yıldız işareti ("*"), noktalı virgül (";"), sol açılı ayraç ("<"), sağ açılı ayraç (""), sol küme ayracı (">{"), sağ küme ayracı ("}"), sol köşeli ayraç ("["), sağ köşeli ayraç ("]"), eşittir işareti ("="), at işareti ("@"), kare vurgu ("^"), alt çizgi ("_") ve noktalı vurgu ("'").

Not

UTF7Encoding hata algılama sağlamaz. Güvenlik nedeniyle, uygulamalarınızın , UnicodeEncodingveya UTF32Encoding kullanmaları UTF8Encodingve hata algılamayı etkinleştirmeleri önerilir.

UTF7Encoding(Boolean)

Kaynak:

UTF7Encoding.cs

Dikkat

The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.

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

public:
 UTF7Encoding(bool allowOptionals);

[System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public UTF7Encoding (bool allowOptionals);

[<System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Text.UTF7Encoding : bool -> System.Text.UTF7Encoding

Public Sub New (allowOptionals As Boolean)

Parametreler

allowOptionals

Boolean

true isteğe bağlı karakterlere izin verileceğini belirtmek için; aksi takdirde , false.

Öznitelikler

ObsoleteAttribute

Örnekler

Aşağıdaki kod örneği, isteğe bağlı karakterlere izin veren yeni UTF7Encoding bir örneğin nasıl oluşturulacağını gösterir.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
void ShowArray( Array^ theArray )
{
   IEnumerator^ myEnum = theArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Object^ o = safe_cast<Object^>(myEnum->Current);
      Console::Write( "[{0}]", o );
   }

   Console::WriteLine();
}

int main()
{
   
   // A few optional characters.
   String^ chars = "!@#$";
   
   // The default Encoding does not allow optional characters.
   // Alternate Byte values are used.
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   array<Byte>^bytes1 = utf7->GetBytes( chars );
   Console::WriteLine( "Default UTF7 Encoding:" );
   ShowArray( bytes1 );
   
   // Convert back to characters.
   Console::WriteLine( "Characters:" );
   ShowArray( utf7->GetChars( bytes1 ) );
   
   // Now, allow optional characters.
   // Optional characters are encoded with their normal code points.
   UTF7Encoding^ utf7AllowOptionals = gcnew UTF7Encoding( true );
   array<Byte>^bytes2 = utf7AllowOptionals->GetBytes( chars );
   Console::WriteLine( "UTF7 Encoding with optional characters allowed:" );
   ShowArray( bytes2 );
   
   // Convert back to characters.
   Console::WriteLine( "Characters:" );
   ShowArray( utf7AllowOptionals->GetChars( bytes2 ) );
}

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {

        // A few optional characters.
        string chars = "!@#$";

        // The default Encoding does not allow optional characters.
        // Alternate byte values are used.
        UTF7Encoding utf7 = new UTF7Encoding();
        Byte[] bytes1 = utf7.GetBytes(chars);
        
        Console.WriteLine("Default UTF7 Encoding:");
        ShowArray(bytes1);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7.GetChars(bytes1));

        // Now, allow optional characters.
        // Optional characters are encoded with their normal code points.
        UTF7Encoding utf7AllowOptionals = new UTF7Encoding(true);
        Byte[] bytes2 = utf7AllowOptionals.GetBytes(chars);
        
        Console.WriteLine("UTF7 Encoding with optional characters allowed:");
        ShowArray(bytes2);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7AllowOptionals.GetChars(bytes2));
    }

    public static void ShowArray(Array theArray) {
        foreach (Object o in theArray) {
            Console.Write("[{0}]", o);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        
        ' A few optional characters.
        Dim chars As String = "!@#$"
        
        ' The default Encoding does not allow optional characters.
        ' Alternate byte values are used.
        Dim utf7 As New UTF7Encoding()
        Dim bytes1 As Byte() = utf7.GetBytes(chars)
        
        Console.WriteLine("Default UTF7 Encoding:")
        ShowArray(bytes1)
        
        ' Convert back to characters.
        Console.WriteLine("Characters:")
        ShowArray(utf7.GetChars(bytes1))
        
        ' Now, allow optional characters.
        ' Optional characters are encoded with their normal code points.
        Dim utf7AllowOptionals As New UTF7Encoding(True)
        Dim bytes2 As Byte() = utf7AllowOptionals.GetBytes(chars)
        
        Console.WriteLine("UTF7 Encoding with optional characters allowed:")
        ShowArray(bytes2)
        
        ' Convert back to characters.
        Console.WriteLine("Characters:")
        ShowArray(utf7AllowOptionals.GetChars(bytes2))
    End Sub
    
    
    Public Shared Sub ShowArray(theArray As Array)
        Dim o As Object
        For Each o In  theArray
            Console.Write("[{0}]", o)
        Next o
        Console.WriteLine()
    End Sub
End Class

Açıklamalar

Örnek isteğe bağlı karakterlere izin veriyorsa, Unicode kod noktaları değiştirilmiş temel 64 karakter yerine karşılık gelen isteğe bağlı karakterle kodlanır. İsteğe bağlı karakterler ünlem işareti ("!"), ters eğik çizgi ("\"), dikey çizgi ("|"), çift tırnak ("""), sayı işareti ("#"), dolar işareti ("$"), yüzde işareti ("%"), ve işareti ("&"), yıldız işareti ("*"), noktalı virgül (";"), sol açılı ayraç ("<"), sağ açılı ayraç (""), sol küme ayracı (">{"), sağ küme ayracı ("}"), sol köşeli ayraç ("["), sağ köşeli ayraç ("]"), eşittir işareti ("="), at işareti ("@"), kare vurgu ("^"), alt çizgi ("_") ve noktalı vurgu ("'").

Not

UTF7Encoding hata algılama sağlamaz. Güvenlik nedeniyle, uygulamalarınızın , UnicodeEncodingveya UTF32Encoding kullanmaları UTF8Encodingve hata algılamayı etkinleştirmeleri önerilir.