UnicodeEncoding Oluşturucular

Başvuru

Tanım

Ad Alanı:: System.Text

Bütünleştirilmiş Kod:: System.Text.Encoding.Extensions.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Aşırı Yüklemeler

UnicodeEncoding()	UnicodeEncoding sınıfının yeni bir örneğini başlatır.
UnicodeEncoding(Boolean, Boolean)	UnicodeEncoding sınıfının yeni bir örneğini başlatır. Parametreler, büyük endian bayt sırasının kullanılıp kullanılmayacağını ve yöntemin GetPreamble() Unicode bayt sırası işareti döndürip döndürmediğini belirtir.
UnicodeEncoding(Boolean, Boolean, Boolean)	UnicodeEncoding sınıfının yeni bir örneğini başlatır. Parametreler, büyük endian bayt sırasının kullanılıp kullanılmayacağını, Unicode bayt sırası işaretinin sağlanıp sağlanmayacağını ve geçersiz kodlama algılandığında özel durum oluşturulup oluşturulmayacağını belirtir.

UnicodeEncoding()

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

public:
 UnicodeEncoding();

public UnicodeEncoding ();

Public Sub New ()

Örnekler

Aşağıdaki örnekte yeni UnicodeEncoding bir örneğin nasıl oluşturulacağı ve kodlamanın adı nasıl görüntüleneceği gösterilmektedir.

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

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        UnicodeEncoding unicode = new UnicodeEncoding();
        String encodingName = unicode.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}

Imports System.Text

Class UnicodeEncodingExample

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

Açıklamalar

Bu oluşturucu, küçük endian bayt sırasını kullanan, Unicode bayt sırası işareti sağlayan ve geçersiz bir kodlama algılandığında özel durum oluşturmayan bir örnek oluşturur.

Dikkat

Güvenlik nedeniyle, oluşturucuyu çağırarak ve bağımsız değişkenini UnicodeEncoding(Boolean, Boolean, Boolean) olarak ayarlayarak hata algılamayı throwOnInvalidBytes trueetkinleştirmeniz gerekir.

Şunlara uygulanır

UnicodeEncoding(Boolean, Boolean)

UnicodeEncoding sınıfının yeni bir örneğini başlatır. Parametreler, büyük endian bayt sırasının kullanılıp kullanılmayacağını ve yöntemin GetPreamble() Unicode bayt sırası işareti döndürip döndürmediğini belirtir.

public:
 UnicodeEncoding(bool bigEndian, bool byteOrderMark);

public UnicodeEncoding (bool bigEndian, bool byteOrderMark);

new System.Text.UnicodeEncoding : bool * bool -> System.Text.UnicodeEncoding

Public Sub New (bigEndian As Boolean, byteOrderMark As Boolean)

Parametreler

bigEndian: Boolean

true büyük endian bayt sırasını (önce en önemli bayt) veya false küçük endian bayt sırasını (önce en az önemli bayt) kullanmak için.

byteOrderMark: Boolean

true yönteminin GetPreamble() Unicode bayt sırası işareti döndürdüğünü belirtmek için; aksi takdirde , false.

Örnekler

Aşağıdaki örnekte, küçük endian veya büyük endian bayt sıralamasını ve Unicode bayt sıralama işaretinin desteklenip desteklemeyeceğini belirten yeni UnicodeEncoding bir örneğin nasıl oluşturulacağı gösterilmektedir.

using namespace System;
using namespace System::Text;
void DescribeEquivalence( Boolean isEquivalent )
{
   Console::WriteLine( " {0} equivalent encoding.", (isEquivalent ? (String^)"An" : "Not an") );
}

int main()
{
   
   // Create a UnicodeEncoding without parameters.
   UnicodeEncoding^ unicode = gcnew UnicodeEncoding;
   
   // Create a UnicodeEncoding to support little-endian Byte ordering
   // and include the Unicode Byte order mark.
   UnicodeEncoding^ unicodeLittleEndianBOM = gcnew UnicodeEncoding( false,true );
   
   // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
   DescribeEquivalence( unicode->Equals( unicodeLittleEndianBOM ) );
   
   // Create a UnicodeEncoding to support little-endian Byte ordering
   // and not include the Unicode Byte order mark.
   UnicodeEncoding^ unicodeLittleEndianNoBOM = gcnew UnicodeEncoding( false,false );
   
   // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
   DescribeEquivalence( unicode->Equals( unicodeLittleEndianNoBOM ) );
   
   // Create a UnicodeEncoding to support big-endian Byte ordering
   // and include the Unicode Byte order mark.
   UnicodeEncoding^ unicodeBigEndianBOM = gcnew UnicodeEncoding( true,true );
   
   // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
   DescribeEquivalence( unicode->Equals( unicodeBigEndianBOM ) );
   
   // Create a UnicodeEncoding to support big-endian Byte ordering
   // and not include the Unicode Byte order mark.
   UnicodeEncoding^ unicodeBigEndianNoBOM = gcnew UnicodeEncoding( true,false );
   
   // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
   DescribeEquivalence( unicode->Equals( unicodeBigEndianNoBOM ) );
}

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {

        // Create a UnicodeEncoding without parameters.
        UnicodeEncoding unicode = new UnicodeEncoding();

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianBOM = 
            new UnicodeEncoding(false, true);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianBOM));

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianNoBOM =
            new UnicodeEncoding(false, false);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianNoBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianBOM =
            new UnicodeEncoding(true, true);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianNoBOM =
            new UnicodeEncoding(true, false);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianNoBOM));
    }

    public static void DescribeEquivalence(Boolean isEquivalent) {
        Console.WriteLine(
            "{0} equivalent encoding.", (isEquivalent ? "An" : "Not an")
        );
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()

        ' Create a UnicodeEncoding without parameters.
        Dim unicodeDefault As New UnicodeEncoding()

        ' Create a UnicodeEncoding to support little-endian byte ordering
        ' and include the Unicode byte order mark.        
        Dim unicodeLittleEndianBOM As New UnicodeEncoding(False, True)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeLittleEndianBOM))
        
        ' Create a UnicodeEncoding to support little-endian byte ordering
        ' and not include the Unicode byte order mark.
        Dim unicodeLittleEndianNoBOM As New UnicodeEncoding(False, False)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeLittleEndianNoBOM))
        
        ' Create a UnicodeEncoding to support big-endian byte ordering
        ' and include the Unicode byte order mark.
        Dim unicodeBigEndianBOM As New UnicodeEncoding(True, True)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeBigEndianBOM))
        
        ' Create a UnicodeEncoding to support big-endian byte ordering
        ' and not include the Unicode byte order mark.
        Dim unicodeBigEndianNoBOM As New UnicodeEncoding(True, False)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeBigEndianNoBOM))
    End Sub
    
    
    Public Shared Sub DescribeEquivalence(isEquivalent As Boolean)
        Dim phrase as String
        If isEquivalent Then
            phrase = "An"
        Else
            phrase = "Not an"
        End If
        Console.WriteLine("{0} equivalent encoding.", phrase)
    End Sub
End Class

Açıklamalar

Bu oluşturucu, geçersiz bir kodlama algılandığında özel durum oluşturmayan bir örnek oluşturur.

Dikkat

byteOrderMark parametresi yönteminin GetPreamble çalışmasını denetler. ise trueyöntemi, UTF-16 biçiminde Unicode bayt sırası işaretini (BOM) içeren bir bayt dizisi döndürür. ise falsesıfır uzunlukta bir bayt dizisi döndürür. Ancak ayarı yöntemin byteOrderMark true GetBytes bayt dizisinin başına ürün reçetesi ön eki eklemesine neden olmaz ve yöntemin GetByteCount bayt sayısına ÜR'ye bayt sayısını eklemesine neden olmaz.

Ayrıca bkz.

GetPreamble()

Şunlara uygulanır

UnicodeEncoding(Boolean, Boolean, Boolean)

UnicodeEncoding sınıfının yeni bir örneğini başlatır. Parametreler, büyük endian bayt sırasının kullanılıp kullanılmayacağını, Unicode bayt sırası işaretinin sağlanıp sağlanmayacağını ve geçersiz kodlama algılandığında özel durum oluşturulup oluşturulmayacağını belirtir.

public:
 UnicodeEncoding(bool bigEndian, bool byteOrderMark, bool throwOnInvalidBytes);

public UnicodeEncoding (bool bigEndian, bool byteOrderMark, bool throwOnInvalidBytes);

new System.Text.UnicodeEncoding : bool * bool * bool -> System.Text.UnicodeEncoding

Public Sub New (bigEndian As Boolean, byteOrderMark As Boolean, throwOnInvalidBytes As Boolean)

Parametreler

bigEndian: Boolean

true büyük endian bayt sırasını kullanmak (önce en önemli bayt); false küçük endian bayt sırasını kullanmak için (önce en az önemli bayt).

byteOrderMark: Boolean

true yönteminin GetPreamble() Unicode bayt sırası işareti döndürdüğünü belirtmek için; aksi takdirde , false.

throwOnInvalidBytes: Boolean

true geçersiz bir kodlama algılandığında bir özel durum oluşturulacağını belirtmek için; aksi takdirde , false.

Örnekler

Aşağıdaki örnekte, hem hata algılama etkin hem de olmadan davranışını UnicodeEncodinggösterilmektedir.

using namespace System;
using namespace System::Text;
void PrintDecodedString( array<Byte>^bytes, Encoding^ enc );
int main()
{
   
   // Create an instance of UnicodeEncoding using little-endian byte order.
   // This will be used for encoding.
   UnicodeEncoding^ u16LE = gcnew UnicodeEncoding( false,true );
   
   // Create two instances of UnicodeEncoding using big-endian byte order: one with error detection and one without.
   // These will be used for decoding.
   UnicodeEncoding^ u16withED = gcnew UnicodeEncoding( true,true,true );
   UnicodeEncoding^ u16noED = gcnew UnicodeEncoding( true,true,false );
   
   // Create byte arrays from the same string containing the following characters:
   //    Latin Small Letter Z (U+007A)
   //    Latin Small Letter A (U+0061)
   //    Combining Breve (U+0306)
   //    Latin Small Letter AE With Acute (U+01FD)
   //    Greek Small Letter Beta (U+03B2)
   //    Latin Capital Letter U with  Diaeresis (U+00DC)
   String^ myStr = "za\u0306\u01FD\u03B2\u00DC";
   
   // Encode the string using little-endian byte order.
   array<Byte>^myBytes = gcnew array<Byte>(u16LE->GetByteCount( myStr ));
   u16LE->GetBytes( myStr, 0, myStr->Length, myBytes, 0 );
   
   // Decode the byte array with error detection.
   Console::WriteLine( "Decoding with error detection:" );
   PrintDecodedString( myBytes, u16withED );
   
   // Decode the byte array without error detection.
   Console::WriteLine( "Decoding without error detection:" );
   PrintDecodedString( myBytes, u16noED );
}


// Decode the bytes and display the string.
void PrintDecodedString( array<Byte>^bytes, Encoding^ enc )
{
   try
   {
      Console::WriteLine( "   Decoded string: {0}", enc->GetString( bytes, 0, bytes->Length ) );
   }
   catch ( System::ArgumentException^ e ) 
   {
      Console::WriteLine( e );
   }

   Console::WriteLine();
}

using System;
using System.Text;

public class SamplesUnicodeEncoding  {

   public static void Main()  {

      // Create an instance of UnicodeEncoding using little-endian byte order.
      // This will be used for encoding.
      UnicodeEncoding u16LE     = new UnicodeEncoding( false, true );

      // Create two instances of UnicodeEncoding using big-endian byte order: one with error detection and one without.
      // These will be used for decoding.
      UnicodeEncoding u16withED = new UnicodeEncoding( true, true, true );
      UnicodeEncoding u16noED   = new UnicodeEncoding( true, true, false );

      // Create byte arrays from the same string containing the following characters:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    Latin Capital Letter U with  Diaeresis (U+00DC)
      String myStr = "za\u0306\u01FD\u03B2\u00DC";

      // Encode the string using little-endian byte order.
      byte[] myBytes = new byte[u16LE.GetByteCount( myStr )];
      u16LE.GetBytes( myStr, 0, myStr.Length, myBytes, 0 );

      // Decode the byte array with error detection.
      Console.WriteLine( "Decoding with error detection:" );
      PrintDecodedString( myBytes, u16withED );

      // Decode the byte array without error detection.
      Console.WriteLine( "Decoding without error detection:" );
      PrintDecodedString( myBytes, u16noED );
   }

   // Decode the bytes and display the string.
   public static void PrintDecodedString( byte[] bytes, Encoding enc )  {

      try  {
         Console.WriteLine( "   Decoded string: {0}", enc.GetString( bytes, 0, bytes.Length ) );
      }
      catch ( System.ArgumentException e )  {
         Console.WriteLine( e.ToString() );
      }

      Console.WriteLine();
   }
}

Imports System.Text

Public Class SamplesUnicodeEncoding   

   Public Shared Sub Main()

      ' Create an instance of UnicodeEncoding using little-endian byte order.
      ' This will be used for encoding.
      Dim u16LE As New UnicodeEncoding(False, True)

      ' Create two instances of UnicodeEncoding using big-endian byte order: one with error detection and one without.
      ' These will be used for decoding.
      Dim u16withED As New UnicodeEncoding(True, True, True)
      Dim u16noED As New UnicodeEncoding(True, True, False)

      ' Create byte arrays from the same string containing the following characters:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    Latin Capital Letter U with  Diaeresis (U+00DC)
      Dim myStr As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2) & ChrW(&H00DC)

      ' Encode the string using little-endian byte order.
      Dim myBytes(u16LE.GetByteCount(myStr)) As Byte
      u16LE.GetBytes(myStr, 0, myStr.Length, myBytes, 0)

      ' Decode the byte array with error detection.
      Console.WriteLine("Decoding with error detection:")
      PrintDecodedString(myBytes, u16withED)

      ' Decode the byte array without error detection.
      Console.WriteLine("Decoding without error detection:")
      PrintDecodedString(myBytes, u16noED)

   End Sub


   ' Decode the bytes and display the string.
   Public Shared Sub PrintDecodedString(bytes() As Byte, enc As Encoding)

      Try
         Console.WriteLine("   Decoded string: {0}", enc.GetString(bytes, 0, bytes.Length))
      Catch e As System.ArgumentException
         Console.WriteLine(e.ToString())
      End Try

      Console.WriteLine()

   End Sub

End Class

Açıklamalar

throwOnInvalidBytes parametresi isetrue, geçersiz bir bayt dizisi algılayan bir yöntem oluştururSystem.ArgumentException. Aksi takdirde, yöntem bir özel durum oluşturmaz ve geçersiz dizi yoksayılır.

Dikkat

Güvenlik nedenleriyle, sınıfının bir örneğini oluşturmak için bu oluşturucuyu UnicodeEncoding kullanmanız ve olarak ayarlayarak throwOnInvalidBytes hata algılamayı trueaçmanız gerekir.

Ayrıca bkz.

GetPreamble()

Şunlara uygulanır

Aracılığıyla paylaş

UnicodeEncoding Oluşturucular

Tanım

Aşırı Yüklemeler

UnicodeEncoding()

Örnekler

Açıklamalar

Şunlara uygulanır

UnicodeEncoding(Boolean, Boolean)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

UnicodeEncoding(Boolean, Boolean, Boolean)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar