UTF8Encoding.GetBytes メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
文字のセットをバイト シーケンスにエンコードします。
オーバーロード
| GetBytes(String) |
指定した String オブジェクトに含まれる文字をバイト シーケンスにエンコードします。 |
| GetBytes(ReadOnlySpan<Char>, Span<Byte>) |
指定された文字スパンを指定されたバイト スパンにエンコードします。 |
| GetBytes(Char*, Int32, Byte*, Int32) |
指定した文字ポインターで始まる文字のセットを、指定したバイト ポインターを開始位置として格納されるバイト シーケンスにエンコードします。 |
| GetBytes(Char[], Int32, Int32, Byte[], Int32) |
指定した文字配列に格納されている文字のセットを指定したバイト配列にエンコードします。 |
| GetBytes(String, Int32, Int32, Byte[], Int32) |
指定した String の文字セットを、指定したバイト配列にエンコードします。 |
GetBytes(String)
指定した String オブジェクトに含まれる文字をバイト シーケンスにエンコードします。
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()パラメーター
- s
- String
エンコードする文字列。
戻り値
s パラメーターで指定された文字列内のエンコードされた文字が格納されているバイト配列。
適用対象
GetBytes(ReadOnlySpan<Char>, Span<Byte>)
- Source:
- UTF8Encoding.cs
- Source:
- UTF8Encoding.cs
- Source:
- UTF8Encoding.cs
指定された文字スパンを指定されたバイト スパンにエンコードします。
public:
override int GetBytes(ReadOnlySpan<char> chars, Span<System::Byte> bytes);public override int GetBytes (ReadOnlySpan<char> chars, Span<byte> bytes);override this.GetBytes : ReadOnlySpan<char> * Span<byte> -> intPublic Overrides Function GetBytes (chars As ReadOnlySpan(Of Char), bytes As Span(Of Byte)) As Integerパラメーター
- chars
- ReadOnlySpan<Char>
エンコードする文字スパン。
戻り値
bytes に書き込まれた実際のバイト数。
注釈
結果のバイトを格納するために 必要 GetBytes な正確なサイズを計算するには、 メソッドを GetByteCount 呼び出します。 最大サイズを計算するには、 メソッドを呼び出します GetMaxByteCount 。 メソッドは通常、割り当てるメモリが少なくなりますが、メソッドの実行速度は GetByteCount 一般に GetMaxByteCount 速くなります。
エラー検出では、無効なシーケンスにより、このメソッドによって例外が ArgumentException スローされます。 エラー検出がないと、無効なシーケンスは無視され、例外はスローされません。
ストリームから読み取られたデータなど、変換するデータは、シーケンシャル ブロックでのみ使用できます。 この場合、またはデータの量が大きくて小さいブロックに分割する必要がある場合は、 メソッドまたは メソッドによってGetDecoder返される または GetEncoderEncoder をそれぞれ使用Decoderします。
エンコードされたバイトがファイルまたはストリームとして保存されるときに正しくデコードされるようにするには、エンコードされたバイトのストリームの前にプリアンブルを付けることができます。 バイト ストリームの先頭 (ファイルに書き込まれる一連のバイトの先頭など) にプリアンブルを挿入することは、開発者の責任です。 メソッドは GetBytes 、エンコードされたバイトのシーケンスの先頭にプリアンブルを付加しません。
適用対象
GetBytes(Char*, Int32, Byte*, Int32)
- Source:
- UTF8Encoding.cs
- Source:
- UTF8Encoding.cs
- Source:
- UTF8Encoding.cs
重要
この API は CLS 準拠ではありません。
指定した文字ポインターで始まる文字のセットを、指定したバイト ポインターを開始位置として格納されるバイト シーケンスにエンコードします。
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パラメーター
- chars
- Char*
エンコードする最初の文字へのポインター。
- charCount
- Int32
エンコードする文字数。
- bytes
- Byte*
結果のバイト シーケンスの書き込みを開始する位置へのポインター。
- byteCount
- Int32
書き込む最大バイト数。
戻り値
bytes によって示される位置に書き込まれる実際のバイト数。
- 属性
例外
charCount または byteCount が 0 未満です。
注釈
結果のバイトを格納するために 必要な正確な GetBytes 配列サイズを計算するには、 メソッドを GetByteCount 呼び出します。 配列の最大サイズを計算するには、 メソッドを呼び出します GetMaxByteCount 。 メソッドは通常、割り当てるメモリが少なくなりますが、メソッドの実行速度は GetByteCount 一般に GetMaxByteCount 速くなります。
エラー検出では、無効なシーケンスにより、このメソッドによって例外が ArgumentException スローされます。 エラー検出がないと、無効なシーケンスは無視され、例外はスローされません。
ストリームから読み取られたデータなど、変換するデータは、シーケンシャル ブロックでのみ使用できます。 この場合、またはデータの量が大きくて小さいブロックに分割する必要がある場合は、 メソッドまたは メソッドによってGetDecoder返される または GetEncoderEncoder をそれぞれ使用Decoderします。
エンコードされたバイトがファイルまたはストリームとして保存されるときに正しくデコードされるようにするには、エンコードされたバイトのストリームの前にプリアンブルを付けることができます。 バイト ストリームの先頭 (ファイルに書き込まれる一連のバイトの先頭など) にプリアンブルを挿入することは、開発者の責任です。 メソッドは GetBytes 、エンコードされたバイトのシーケンスの先頭にプリアンブルを付加しません。
こちらもご覧ください
適用対象
GetBytes(Char[], Int32, Int32, Byte[], Int32)
- Source:
- UTF8Encoding.cs
- Source:
- UTF8Encoding.cs
- Source:
- UTF8Encoding.cs
指定した文字配列に格納されている文字のセットを指定したバイト配列にエンコードします。
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 -> intPublic Overrides Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integerパラメーター
- chars
- Char[]
エンコード対象の文字のセットを格納している文字配列。
- charIndex
- Int32
エンコードする最初の文字のインデックス。
- charCount
- Int32
エンコードする文字数。
- bytes
- Byte[]
結果のバイト シーケンスを格納するバイト配列。
- byteIndex
- Int32
結果のバイト シーケンスを書き込む開始位置のインデックス。
戻り値
bytes に書き込まれた実際のバイト数。
例外
charIndex、charCount、または byteIndex が 0 未満です。
または
charIndex および charCount は charsにおいて有効な範囲を表していません。
または
byteIndex が bytes の有効なインデックスではありません。
エラーの検出が有効になり、chars に無効な文字のシーケンスが含まれています。
または
bytes には、byteIndex から配列の末尾までに十分なサイズがなく、結果のバイトを格納できません。
例
次の例では、 メソッドを GetBytes 使用して文字列から文字の範囲をエンコードし、エンコードされたバイトをバイト配列内の要素の範囲に格納します。
using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
array<Byte>^bytes;
String^ chars = "UTF8 Encoding Example";
UTF8Encoding^ utf8 = gcnew UTF8Encoding;
int byteCount = utf8->GetByteCount( chars->ToCharArray(), 0, 13 );
bytes = gcnew array<Byte>(byteCount);
int bytesEncodedCount = utf8->GetBytes( chars, 0, 13, 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 UTF8EncodingExample {
public static void Main() {
Byte[] bytes;
String chars = "UTF8 Encoding Example";
UTF8Encoding utf8 = new UTF8Encoding();
int byteCount = utf8.GetByteCount(chars.ToCharArray(), 0, 13);
bytes = new Byte[byteCount];
int bytesEncodedCount = utf8.GetBytes(chars, 0, 13, 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 UTF8EncodingExample
Public Shared Sub Main()
Dim bytes() As Byte
Dim chars As String = "UTF8 Encoding Example"
Dim utf8 As New UTF8Encoding()
Dim byteCount As Integer = utf8.GetByteCount(chars.ToCharArray(), 0, 13)
bytes = New Byte(byteCount - 1) {}
Dim bytesEncodedCount As Integer = utf8.GetBytes(chars, 0, 13, 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
注釈
結果のバイトを格納するために 必要な正確な GetBytes 配列サイズを計算するには、 メソッドを GetByteCount 呼び出します。 配列の最大サイズを計算するには、 メソッドを呼び出します GetMaxByteCount 。 メソッドは通常、割り当てるメモリが少なくなりますが、メソッドの実行速度は GetByteCount 一般に GetMaxByteCount 速くなります。
エラー検出では、無効なシーケンスにより、このメソッドによって例外が ArgumentException スローされます。 エラー検出がないと、無効なシーケンスは無視され、例外はスローされません。
ストリームから読み取られたデータなど、変換するデータは、シーケンシャル ブロックでのみ使用できます。 この場合、またはデータの量が大きくて小さいブロックに分割する必要がある場合は、 メソッドまたは メソッドによって提供される GetDecoder または EncoderGetEncoder をそれぞれ使用Decoderします。
エンコードされたバイトがファイルまたはストリームとして保存されるときに正しくデコードされるようにするには、エンコードされたバイトのストリームの前にプリアンブルを付けることができます。 バイト ストリームの先頭 (ファイルに書き込まれる一連のバイトの先頭など) にプリアンブルを挿入することは、開発者の責任です。 メソッドは GetBytes 、エンコードされたバイトのシーケンスの先頭にプリアンブルを付加しません。
こちらもご覧ください
適用対象
GetBytes(String, Int32, Int32, Byte[], Int32)
- Source:
- UTF8Encoding.cs
- Source:
- UTF8Encoding.cs
- Source:
- UTF8Encoding.cs
指定した String の文字セットを、指定したバイト配列にエンコードします。
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 -> intPublic Overrides Function GetBytes (s As String, charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integerパラメーター
- charIndex
- Int32
エンコードする最初の文字のインデックス。
- charCount
- Int32
エンコードする文字数。
- bytes
- Byte[]
結果のバイト シーケンスを格納するバイト配列。
- byteIndex
- Int32
結果のバイト シーケンスを書き込む開始位置のインデックス。
戻り値
bytes に書き込まれた実際のバイト数。
例外
charIndex、charCount、または byteIndex が 0 未満です。
または
charIndex および charCount は charsにおいて有効な範囲を表していません。
または
byteIndex が bytes の有効なインデックスではありません。
エラーの検出が有効になり、s に無効な文字のシーケンスが含まれています。
または
bytes には、byteIndex から配列の末尾までに十分なサイズがなく、結果のバイトを格納できません。
例
次の例では、 メソッドを GetBytes 使用して Unicode 文字配列から要素の範囲をエンコードし、エンコードされたバイトをバイト配列内の要素の範囲に格納します。
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'};
UTF8Encoding^ utf8 = gcnew UTF8Encoding;
int byteCount = utf8->GetByteCount( chars, 1, 2 );
bytes = gcnew array<Byte>(byteCount);
int bytesEncodedCount = utf8->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 UTF8EncodingExample {
public static void Main() {
Byte[] bytes;
// Unicode characters.
Char[] chars = new Char[] {
'\u0023', // #
'\u0025', // %
'\u03a0', // Pi
'\u03a3' // Sigma
};
UTF8Encoding utf8 = new UTF8Encoding();
int byteCount = utf8.GetByteCount(chars, 1, 2);
bytes = new Byte[byteCount];
int bytesEncodedCount = utf8.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 UTF8EncodingExample
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 utf8 As New UTF8Encoding()
Dim byteCount As Integer = utf8.GetByteCount(chars, 1, 2)
bytes = New Byte(byteCount - 1) {}
Dim bytesEncodedCount As Integer = utf8.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
注釈
結果のバイトを格納するために 必要 GetBytes な配列サイズを正確に計算するには、 メソッドを GetByteCount 呼び出します。 配列の最大サイズを計算するには、 メソッドを呼び出します GetMaxByteCount 。 メソッドは通常、割り当てるメモリが少なくなりますが、メソッドの実行速度は GetByteCount 一般に GetMaxByteCount 速くなります。
エラー検出では、無効なシーケンスにより、このメソッドによって例外が ArgumentException スローされます。 エラー検出がないと、無効なシーケンスは無視され、例外はスローされません。
ストリームから読み取られたデータなど、変換するデータは、シーケンシャル ブロックでのみ使用できます。 この場合、またはデータの量が大きくて小さいブロックに分割する必要がある場合は、 メソッドまたは メソッドによってGetDecoder提供される または GetEncoderEncoder をそれぞれ使用Decoderします。
エンコードされたバイトがファイルまたはストリームとして保存されるときに正しくデコードされるようにするには、エンコードされたバイトのストリームの前にプリアンブルを付けます。 バイト ストリームの先頭 (ファイルに書き込まれる一連のバイトの先頭など) にプリアンブルを挿入することは、開発者の責任です。 メソッドは GetBytes 、エンコードされたバイトシーケンスの先頭にプリアンブルを付加しません。
こちらもご覧ください
適用対象
.NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示