UTF7Encoding.GetBytes Yöntem
Tanım
Ö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.
Bir karakter kümesini bayt dizisine kodlar.
Aşırı Yüklemeler
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) |
Belirtilen karakter dizisinden bir dizi karakteri belirtilen bayt dizisine kodlar. |
GetBytes(String, Int32, Int32, Byte[], Int32) |
Belirtilen karakter kümesinden belirtilen String bayt dizisine kodlar. |
GetBytes(Char*, Int32, Byte*, Int32)
- Kaynak:
- UTF7Encoding.cs
- Kaynak:
- UTF7Encoding.cs
- Kaynak:
- UTF7Encoding.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)]
[System.Security.SecurityCritical]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
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)>]
[<System.Security.SecurityCritical>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
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*
Kodlanacak ilk karakterin işaretçisi.
- charCount
- Int32
Kodlanacak karakter sayısı.
- bytes
- Byte*
Elde edilen bayt sırasını yazmaya başlanması gereken konuma yönelik bir işaretçi.
- byteCount
- Int32
Yazacak en fazla bayt sayısı.
Döndürülenler
tarafından bytes
belirtilen konumda yazılan gerçek bayt sayısı.
- Öznitelikler
Özel durumlar
charCount
veya byteCount
sıfırdan küçüktür.
byteCount
elde edilen bayt sayısından küçüktür.
Bir geri dönüş oluştu (daha ayrıntılı bir açıklama için bkz . .NET'te Karakter Kodlaması ).
-Ve-
EncoderFallback olarak ayarlanır EncoderExceptionFallback.
Açıklamalar
Uygulama, sonuç baytlarını depolamak için gereken GetBytes dizi boyutunu tam olarak hesaplamak için kullanır GetByteCount. En büyük dizi boyutunu hesaplamak için uygulamanın kullanması GetMaxByteCountgerekir. GetByteCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxByteCount yöntem genellikle daha hızlı yürütülür.
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 GetEncoder yöntemi tarafından GetDecoder sağlanan öğesini Encoder kullanmalıdırDecoder.
Not
UTF7Encoding hata algılama sağlamaz. Geçersiz karakterler değiştirilmiş temel 64 karakter olarak kodlanmış. Güvenlik nedeniyle, uygulamalarınızın , UnicodeEncodingveya UTF32Encoding kullanmaları UTF8Encodingve hata algılamayı etkinleştirmeleri önerilir.
Ayrıca bkz.
Şunlara uygulanır
GetBytes(Char[], Int32, Int32, Byte[], Int32)
- Kaynak:
- UTF7Encoding.cs
- Kaynak:
- UTF7Encoding.cs
- Kaynak:
- UTF7Encoding.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
Kodlanacak 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şlanması gereken dizin.
Döndürülenler
içine bytes
yazılan gerçek bayt sayısı.
Özel durumlar
charIndex
veya charCount
byteIndex
sıfırdan küçüktür.
-veya-
charIndex
ve charCount
içinde chars
geçerli bir aralığı ifade etmeyin.
-veya-
byteIndex
içinde bytes
geçerli bir dizin değil.
bytes
dizinin sonundan elde edilen baytları barındırmak için yeterli kapasiteye byteIndex
sahip değildir.
Bir geri dönüş oluştu (daha ayrıntılı bir açıklama için bkz . .NET'te Karakter Kodlaması ).
-Ve-
EncoderFallback olarak ayarlanır EncoderExceptionFallback.
Örnekler
Aşağıdaki kod örneği, bir karakter String aralığını kodlamak ve kodlanmış baytları bayt 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;
// Unicode characters.
// Pi
// Sigma
array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
UTF7Encoding^ utf7 = gcnew UTF7Encoding;
int byteCount = utf7->GetByteCount( chars, 1, 2 );
bytes = gcnew array<Byte>(byteCount);
int bytesEncodedCount = utf7->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 UTF7EncodingExample {
public static void Main() {
Byte[] bytes;
// Unicode characters.
Char[] chars = new Char[] {
'\u0023', // #
'\u0025', // %
'\u03a0', // Pi
'\u03a3' // Sigma
};
UTF7Encoding utf7 = new UTF7Encoding();
int byteCount = utf7.GetByteCount(chars, 1, 2);
bytes = new Byte[byteCount];
int bytesEncodedCount = utf7.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 UTF7EncodingExample
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 utf7 As New UTF7Encoding()
Dim byteCount As Integer = utf7.GetByteCount(chars, 1, 2)
bytes = New Byte(byteCount - 1) {}
Dim bytesEncodedCount As Integer = utf7.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
Uygulama, sonuç baytlarını depolamak için gereken GetBytes dizi boyutunu tam olarak hesaplamak için kullanır GetByteCount. En büyük dizi boyutunu hesaplamak için uygulamanın kullanması GetMaxByteCountgerekir. GetByteCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxByteCount yöntem genellikle daha hızlı yürütülür.
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 GetEncoder yöntemi tarafından GetDecoder sağlanan öğesini Encoder kullanmalıdırDecoder.
Not
UTF7Encoding hata algılama sağlamaz. Geçersiz karakterler değiştirilmiş temel 64 karakter olarak kodlanmış. Güvenlik nedeniyle, uygulamalarınızın , UnicodeEncodingveya UTF32Encoding kullanmaları UTF8Encodingve hata algılamayı etkinleştirmeleri önerilir.
Ayrıca bkz.
Şunlara uygulanır
GetBytes(String, Int32, Int32, Byte[], Int32)
- Kaynak:
- UTF7Encoding.cs
- Kaynak:
- UTF7Encoding.cs
- Kaynak:
- UTF7Encoding.cs
Belirtilen karakter kümesinden 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);
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (string s, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : string * int * int * byte[] * int -> int
[<System.Runtime.InteropServices.ComVisible(false)>]
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
- charIndex
- Int32
Kodlanacak 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şlanması gereken dizin.
Döndürülenler
içine bytes
yazılan gerçek bayt sayısı.
- Öznitelikler
Özel durumlar
charIndex
veya charCount
byteIndex
sıfırdan küçüktür.
-veya-
charIndex
ve charCount
içinde chars
geçerli bir aralığı ifade etmeyin.
-veya-
byteIndex
içinde bytes
geçerli bir dizin değil.
bytes
dizinin sonundan elde edilen baytları barındırmak için yeterli kapasiteye byteIndex
sahip değildir.
Bir geri dönüş oluştu (daha ayrıntılı bir açıklama için bkz . .NET'te Karakter Kodlaması ).
-Ve-
EncoderFallback olarak ayarlanır EncoderExceptionFallback.
Örnekler
Aşağıdaki kod örneği, bir Unicode karakter dizisindeki öğe aralığını kodlamak ve kodlanmış baytları bayt 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;
// Unicode characters.
// Pi
// Sigma
array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
UTF7Encoding^ utf7 = gcnew UTF7Encoding;
int byteCount = utf7->GetByteCount( chars, 1, 2 );
bytes = gcnew array<Byte>(byteCount);
int bytesEncodedCount = utf7->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 UTF7EncodingExample {
public static void Main() {
Byte[] bytes;
// Unicode characters.
Char[] chars = new Char[] {
'\u0023', // #
'\u0025', // %
'\u03a0', // Pi
'\u03a3' // Sigma
};
UTF7Encoding utf7 = new UTF7Encoding();
int byteCount = utf7.GetByteCount(chars, 1, 2);
bytes = new Byte[byteCount];
int bytesEncodedCount = utf7.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 UTF7EncodingExample
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 utf7 As New UTF7Encoding()
Dim byteCount As Integer = utf7.GetByteCount(chars, 1, 2)
bytes = New Byte(byteCount - 1) {}
Dim bytesEncodedCount As Integer = utf7.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
Uygulama, sonuç baytlarını depolamak için gereken GetBytes dizi boyutunu tam olarak hesaplamak için kullanır GetByteCount. En büyük dizi boyutunu hesaplamak için uygulamanın kullanması GetMaxByteCountgerekir. GetByteCount yöntemi genellikle daha az bellek ayırmaya izin verirken, GetMaxByteCount yöntem genellikle daha hızlı yürütülür.
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 GetEncoder yöntemi tarafından GetDecoder sağlanan öğesini Encoder kullanmalıdırDecoder.
Not
UTF7Encoding hata algılama sağlamaz. Geçersiz karakterler değiştirilmiş temel 64 karakter olarak kodlanmış. Güvenlik nedeniyle, uygulamalarınızın , UnicodeEncodingveya UTF32Encoding kullanmaları UTF8Encodingve hata algılamayı etkinleştirmeleri önerilir.
Ayrıca bkz.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin