UnicodeEncoding.GetBytes Yöntem

Tanım

Bir karakter kümesini bayt dizisine kodlar.

Aşırı Yüklemeler

GetBytes(Char[], Int32, Int32, Byte[], Int32)

Belirtilen karakter dizisinden bir dizi karakteri belirtilen bayt dizisine kodlar.

GetBytes(String, Int32, Int32, Byte[], Int32)

Belirtilen içindeki bir karakter kümesini belirtilen String bayt dizisine kodlar.

GetBytes(String)

Belirtilen dizedeki bir karakter kümesini belirtilen bayt dizisine kodlar.

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[], Int32, Int32, Byte[], Int32)

Kaynak:
UnicodeEncoding.cs
Kaynak:
UnicodeEncoding.cs
Kaynak:
UnicodeEncoding.cs

Belirtilen karakter dizisinden bir dizi karakteri belirtilen bayt dizisine kodlar.

public:
 override int GetBytes(cli::array <char> ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes (char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : char[] * int * int * byte[] * int -> int
Public Overrides Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Parametreler

chars
Char[]

Kodlanması gereken karakter kümesini içeren karakter dizisi.

charIndex
Int32

Kodlanan ilk karakterin dizini.

charCount
Int32

Kodlanacak karakter sayısı.

bytes
Byte[]

Elde edilen bayt dizisini içeren bayt dizisi.

byteIndex
Int32

Elde edilen bayt sırasını yazmaya başlayabileceğiniz dizin.

Döndürülenler

içine bytesyazılan gerçek bayt sayısı.

Özel durumlar

chars is null (Nothing).

-veya-

bytes is null (Nothing).

charIndex veya charCountbyteIndex sıfırdan küçüktür.

-veya-

charIndex ve charCount içinde charsgeçerli bir aralığı ifade etmeyin.

-veya-

byteIndex içinde bytesgeçerli bir dizin değil.

Hata algılama etkinleştirildi ve chars geçersiz karakter dizisi içeriyor.

-veya-

bytes , sonuçta elde edilen baytları barındırmak için dizinin sonuna kadar yeterli kapasiteye byteIndex sahip değildir.

Bir geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-Ve-

EncoderFallback olarak ayarlanır EncoderExceptionFallback.

Örnekler

Aşağıdaki örnek, bir karakter aralığını kodlamak ve kodlanmış baytları bayt String dizisindeki bir öğe aralığında depolamak için yönteminin nasıl kullanılacağını GetBytes gösterir.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   String^ chars = "Unicode Encoding Example";
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int byteCount = Unicode->GetByteCount( chars->ToCharArray(), 8, 8 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = Unicode->GetBytes( chars, 8, 8, bytes, 0 );
   Console::WriteLine( "{0} bytes used to encode string.", bytesEncodedCount );
   Console::Write( "Encoded bytes: " );
   IEnumerator^ myEnum = bytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
}
using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        String chars = "Unicode Encoding Example";
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars.ToCharArray(), 8, 8);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.GetBytes(chars, 8, 8, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode string.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}
Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte
        Dim chars As String = "Unicode Encoding Example"
        
        Dim uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars.ToCharArray(), 8, 8)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.GetBytes(chars, 8, 8, bytes, 0)
        
        Console.WriteLine("{0} bytes used to encode string.", bytesEncodedCount)
        
        Console.Write("Encoded bytes: ")
        Dim b As Byte
        For Each b In  bytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
    End Sub
End Class

Açıklamalar

Sonucu elde edilen baytları depolamak için gereken GetBytes dizi boyutunu tam olarak hesaplamak için yöntemini çağırırsınız GetByteCount . En büyük dizi boyutunu hesaplamak için yöntemini çağırırsınız GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırırkenGetMaxByteCount, yöntem genellikle daha hızlı yürütülür.

Hata algılama ile geçersiz bir dizi bu yöntemin oluşturmasına ArgumentExceptionneden olur. Hata algılama olmadan geçersiz diziler yoksayılır ve özel durum oluşmaz.

Bir akıştan okunan veriler gibi dönüştürülecek veriler yalnızca sıralı bloklarda kullanılabilir. Bu durumda veya veri miktarı daha küçük bloklara bölünmesi gereken kadar büyükse, uygulama sırasıyla yöntemi veya yöntemi tarafından GetDecoder sağlanan öğesini kullanmalıdır.DecoderEncoderGetEncoder

Önemli

Kodlanmış baytların dosya veya akış olarak kaydedildiğinde düzgün bir şekilde kodunun çözülmesini sağlamak için, kodlanmış bayt akışının önüne bir ön ek ekleyebilirsiniz. Bir bayt akışının başına (örneğin, bir dosyaya yazılacak bir bayt dizisinin başında) ön belleği eklemek geliştiricinin sorumluluğundadır. GetBytes yöntemi, kodlanmış bayt dizisinin başına bir ön ek ekleme yapmaz.

Ayrıca bkz.

Şunlara uygulanır

GetBytes(String, Int32, Int32, Byte[], Int32)

Kaynak:
UnicodeEncoding.cs
Kaynak:
UnicodeEncoding.cs
Kaynak:
UnicodeEncoding.cs

Belirtilen içindeki bir karakter kümesini belirtilen String bayt dizisine kodlar.

public:
 override int GetBytes(System::String ^ s, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes (string s, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : string * int * int * byte[] * int -> int
Public Overrides Function GetBytes (s As String, charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer

Parametreler

s
String

Kodlanması gereken karakter kümesini içeren dize.

charIndex
Int32

Kodlanan ilk karakterin dizini.

charCount
Int32

Kodlanacak karakter sayısı.

bytes
Byte[]

Elde edilen bayt dizisini içeren bayt dizisi.

byteIndex
Int32

Elde edilen bayt sırasını yazmaya başlayabileceğiniz dizin.

Döndürülenler

içine bytesyazılan gerçek bayt sayısı.

Özel durumlar

s, null değeridir.

-veya-

bytes is null (Nothing).

charIndex veya charCountbyteIndex sıfırdan küçüktür.

-veya-

charIndex ve charCount içinde charsgeçerli bir aralığı ifade etmeyin.

-veya-

byteIndex içinde bytesgeçerli bir dizin değil.

Hata algılama etkinleştirildi ve s geçersiz karakter dizisi içeriyor.

-veya-

bytes , sonuçta elde edilen baytları barındırmak için dizinin sonuna kadar yeterli kapasiteye byteIndex sahip değildir.

Bir geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-Ve-

EncoderFallback olarak ayarlanır EncoderExceptionFallback.

Örnekler

Aşağıdaki örnek, Unicode karakter dizisindeki bir öğe aralığını kodlamayı ve kodlanmış baytları bayt dizisindeki bir öğe aralığında depolamayı gösterir.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Byte>^bytes;
   
   // Unicode characters.
   
   // Pi
   // Sigma
   array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
   UnicodeEncoding^ Unicode = gcnew UnicodeEncoding;
   int byteCount = Unicode->GetByteCount( chars, 1, 2 );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = Unicode->GetBytes( chars, 1, 2, bytes, 0 );
   Console::WriteLine( "{0} bytes used to encode characters.", bytesEncodedCount );
   Console::Write( "Encoded bytes: " );
   IEnumerator^ myEnum = bytes->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Byte b = safe_cast<Byte>(myEnum->Current);
      Console::Write( "[{0}]", b );
   }

   Console::WriteLine();
}
using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        UnicodeEncoding Unicode = new UnicodeEncoding();
        
        int byteCount = Unicode.GetByteCount(chars, 1, 2);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = Unicode.GetBytes(chars, 1, 2, bytes, 0);
        
        Console.WriteLine(
            "{0} bytes used to encode characters.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}
Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim bytes() As Byte

        ' Unicode characters.
        ' ChrW(35)  = #
        ' ChrW(37)  = %
        ' ChrW(928) = Pi
        ' ChrW(931) = Sigma
        Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}

        Dim uni As New UnicodeEncoding()
        
        Dim byteCount As Integer = uni.GetByteCount(chars, 1, 2)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = uni.GetBytes(chars, 1, 2, bytes, 0)
        
        Console.WriteLine("{0} bytes used to encode characters.", bytesEncodedCount)
        
        Console.Write("Encoded bytes: ")
        Dim b As Byte
        For Each b In  bytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
    End Sub
End Class

Açıklamalar

Sonucu elde edilen baytları depolamak için gereken GetBytes dizi boyutunu tam olarak hesaplamak için yöntemini çağırırsınız GetByteCount . En büyük dizi boyutunu hesaplamak için yöntemini çağırırsınız GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırırkenGetMaxByteCount, yöntem genellikle daha hızlı yürütülür.

Hata algılama ile geçersiz bir dizi bu yöntemin oluşturmasına ArgumentExceptionneden olur. Hata algılama olmadan geçersiz diziler yoksayılır ve özel durum oluşmaz.

Bir akıştan okunan veriler gibi dönüştürülecek veriler yalnızca sıralı bloklarda kullanılabilir. Bu durumda veya veri miktarı daha küçük bloklara bölünmesi gereken kadar büyükse, uygulama sırasıyla yöntemi veya yöntemi tarafından GetDecoder sağlanan öğesini kullanmalıdır.DecoderEncoderGetEncoder

Önemli

Kodlanmış baytların dosya veya akış olarak kaydedildiğinde düzgün bir şekilde kodunun çözülmesini sağlamak için, kodlanmış bayt akışının önüne bir ön ek ekleyebilirsiniz. Bir bayt akışının başına (örneğin, bir dosyaya yazılacak bir bayt dizisinin başında) ön belleği eklemek geliştiricinin sorumluluğundadır. GetBytes yöntemi, kodlanmış bayt dizisinin başına bir ön ek ekleme yapmaz.

Ayrıca bkz.

Şunlara uygulanır

GetBytes(String)

Belirtilen dizedeki bir karakter kümesini belirtilen bayt dizisine kodlar.

public:
 override cli::array <System::Byte> ^ GetBytes(System::String ^ s);
public override byte[] GetBytes (string s);
override this.GetBytes : string -> byte[]
Public Overrides Function GetBytes (s As String) As Byte()

Parametreler

s
String

Döndürülenler

Byte[]

Şunlara uygulanır

GetBytes(Char*, Int32, Byte*, Int32)

Kaynak:
UnicodeEncoding.cs
Kaynak:
UnicodeEncoding.cs
Kaynak:
UnicodeEncoding.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen karakter işaretçisinde başlayan bir karakter kümesini, belirtilen bayt işaretçisinde başlayan bir bayt dizisine kodlar.

public:
 override int GetBytes(char* chars, int charCount, System::Byte* bytes, int byteCount);
[System.CLSCompliant(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[<System.CLSCompliant(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int

Parametreler

chars
Char*

Kodlanan ilk karakterin işaretçisi.

charCount
Int32

Kodlanacak karakter sayısı.

bytes
Byte*

Elde edilen bayt sırasını yazmaya başlayabileceğiniz konumun işaretçisi.

byteCount
Int32

Yazacak bayt sayısı üst sınırı.

Döndürülenler

parametresi tarafından bytes belirtilen konumda yazılan gerçek bayt sayısı.

Öznitelikler

Özel durumlar

chars is null (Nothing).

-veya-

bytes is null (Nothing).

charCount veya byteCount sıfırdan küçüktür.

Hata algılama etkinleştirildi ve chars geçersiz karakter dizisi içeriyor.

-veya-

byteCount elde edilen bayt sayısından küçüktür.

Bir geri dönüş oluştu (daha fazla bilgi için bkz. .NET'te Karakter Kodlama)

-Ve-

EncoderFallback olarak ayarlanır EncoderExceptionFallback.

Açıklamalar

Elde edilen baytların depolanmasını gerektiren GetBytes dizi boyutunu tam olarak hesaplamak için yöntemini çağırırsınız GetByteCount . En büyük dizi boyutunu hesaplamak için yöntemini çağırırsınız GetMaxByteCount . GetByteCount yöntemi genellikle daha az bellek ayırırkenGetMaxByteCount, yöntem genellikle daha hızlı yürütülür.

Hata algılama ile geçersiz bir dizi bu yöntemin oluşturmasına ArgumentExceptionneden olur. Hata algılama olmadan geçersiz diziler yoksayılır ve özel durum oluşmaz.

Bir akıştan okunan veriler gibi dönüştürülecek veriler yalnızca sıralı bloklarda kullanılabilir. Bu durumda veya veri miktarı daha küçük bloklara bölünmesi gereken kadar büyükse, uygulama sırasıyla veya yöntemi tarafından GetDecoder sağlanan veya GetEncoder nesnesini kullanmalıdırDecoder.Encoder

Önemli

Kodlanmış baytların dosya veya akış olarak kaydedildiğinde düzgün bir şekilde kodunun çözülmesini sağlamak için, kodlanmış bayt akışının önüne bir ön ek ekleyebilirsiniz. Bir bayt akışının başına (örneğin, bir dosyaya yazılacak bir bayt dizisinin başında) ön belleği eklemek geliştiricinin sorumluluğundadır. GetBytes yöntemi, kodlanmış bayt dizisinin başına bir ön ek ekleme yapmaz.

Ayrıca bkz.

Şunlara uygulanır