UTF7Encoding.GetBytes 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
문자 집합을 바이트 시퀀스로 인코딩합니다.
오버로드
| Name | Description |
|---|---|
| GetBytes(Char*, Int32, Byte*, Int32) |
지정된 문자 포인터에서 시작하는 문자 집합을 지정된 바이트 포인터에서 시작하여 저장되는 바이트 시퀀스로 인코딩합니다. |
| GetBytes(Char[], Int32, Int32, Byte[], Int32) |
지정된 문자 배열의 문자 집합을 지정된 바이트 배열로 인코딩합니다. |
| GetBytes(String, Int32, Int32, Byte[], Int32) |
지정된 문자 집합을 지정된 String 바이트 배열로 인코딩합니다. |
GetBytes(Char*, Int32, Byte*, Int32)
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
Important
이 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보다 작습니다.
byteCount 는 결과 바이트 수보다 작습니다.
설명
결과 바이트를 저장하는 데 필요한 GetBytes 정확한 배열 크기를 계산하기 위해 애플리케이션에서 사용합니다 GetByteCount. 최대 배열 크기를 계산하려면 애플리케이션에서 .를 사용해야 GetMaxByteCount합니다. 이 메서드는 GetByteCount 일반적으로 메모리를 더 적게 할당할 수 있지만 메서드는 GetMaxByteCount 일반적으로 더 빠르게 실행됩니다.
스트림에서 읽은 데이터와 같이 변환할 데이터는 순차적 블록에서만 사용할 수 있습니다. 이 경우 또는 데이터의 양이 너무 커서 더 작은 블록으로 나누어야 하는 경우 애플리케이션은 메서드 또는 Decoder 메서드 Encoder 에서 제공된 GetDecoder 또는 메서드를 각각 사용해야 GetEncoder 합니다.
메모
UTF7Encoding에서는 오류 감지를 제공하지 않습니다. 잘못된 문자는 수정된 Base 64 문자로 인코딩됩니다. 보안상의 이유로 애플리케이션은 오류 검색을 사용UTF8EncodingUnicodeEncoding하거나 UTF32Encoding 사용하도록 설정하는 것이 좋습니다.
추가 정보
적용 대상
GetBytes(Char[], Int32, Int32, Byte[], Int32)
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.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 -> int
Public 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 또는 charCountbyteIndex 0보다 작습니다.
-또는-
charIndex 에서 charCount 유효한 범위를 chars나타내지 않습니다.
-또는-
byteIndex에서 유효한 인덱스가 아닌 경우 bytes
bytes 에는 결과 바이트를 수용할 수 있는 충분한 용량 byteIndex 이 없습니다.
예제
다음 코드 예제에서는 메서드를 사용하여 GetBytes a의 문자 String 범위를 인코딩하고 인코딩된 바이트를 바이트 배열의 요소 범위에 저장하는 방법을 보여 줍니다.
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
설명
결과 바이트를 저장하는 데 필요한 GetBytes 정확한 배열 크기를 계산하기 위해 애플리케이션에서 사용합니다 GetByteCount. 최대 배열 크기를 계산하려면 애플리케이션에서 .를 사용해야 GetMaxByteCount합니다. 이 메서드는 GetByteCount 일반적으로 메모리를 더 적게 할당할 수 있지만 메서드는 GetMaxByteCount 일반적으로 더 빠르게 실행됩니다.
스트림에서 읽은 데이터와 같이 변환할 데이터는 순차적 블록에서만 사용할 수 있습니다. 이 경우 또는 데이터의 양이 너무 커서 더 작은 블록으로 나누어야 하는 경우 애플리케이션은 메서드 또는 Decoder 메서드 Encoder 에서 제공된 GetDecoder 또는 메서드를 각각 사용해야 GetEncoder 합니다.
메모
UTF7Encoding에서는 오류 감지를 제공하지 않습니다. 잘못된 문자는 수정된 Base 64 문자로 인코딩됩니다. 보안상의 이유로 애플리케이션은 오류 검색을 사용UTF8EncodingUnicodeEncoding하거나 UTF32Encoding 사용하도록 설정하는 것이 좋습니다.
추가 정보
적용 대상
GetBytes(String, Int32, Int32, Byte[], Int32)
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.cs
- Source:
- UTF7Encoding.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);
[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
매개 변수
- charIndex
- Int32
인코딩할 첫 번째 문자의 인덱스입니다.
- charCount
- Int32
인코딩할 문자 수입니다.
- bytes
- Byte[]
결과 바이트 시퀀스를 포함할 바이트 배열입니다.
- byteIndex
- Int32
결과 바이트 시퀀스 작성을 시작할 인덱스입니다.
반품
에 기록된 실제 바이트 수입니다 bytes.
- 특성
예외
charIndex 또는 charCountbyteIndex 0보다 작습니다.
-또는-
charIndex 에서 charCount 유효한 범위를 s나타내지 않습니다.
-또는-
byteIndex에서 유효한 인덱스가 아닌 경우 bytes
bytes 에는 결과 바이트를 수용할 수 있는 충분한 용량 byteIndex 이 없습니다.
예제
다음 코드 예제에서는 메서드를 사용하여 GetBytes 유니코드 문자 배열의 요소 범위를 인코딩하고 인코딩된 바이트를 바이트 배열의 요소 범위에 저장하는 방법을 보여 줍니다.
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
설명
결과 바이트를 저장하는 데 필요한 GetBytes 정확한 배열 크기를 계산하기 위해 애플리케이션에서 사용합니다 GetByteCount. 최대 배열 크기를 계산하려면 애플리케이션에서 .를 사용해야 GetMaxByteCount합니다. 이 메서드는 GetByteCount 일반적으로 메모리를 더 적게 할당할 수 있지만 메서드는 GetMaxByteCount 일반적으로 더 빠르게 실행됩니다.
스트림에서 읽은 데이터와 같이 변환할 데이터는 순차적 블록에서만 사용할 수 있습니다. 이 경우 또는 데이터의 양이 너무 커서 더 작은 블록으로 나누어야 하는 경우 애플리케이션은 메서드 또는 Decoder 메서드 Encoder 에서 제공된 GetDecoder 또는 메서드를 각각 사용해야 GetEncoder 합니다.
메모
UTF7Encoding에서는 오류 감지를 제공하지 않습니다. 잘못된 문자는 수정된 Base 64 문자로 인코딩됩니다. 보안상의 이유로 애플리케이션은 오류 검색을 사용UTF8EncodingUnicodeEncoding하거나 UTF32Encoding 사용하도록 설정하는 것이 좋습니다.