UnicodeEncoding.GetCharCount 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
바이트 시퀀스를 디코딩하여 생성되는 문자 수를 계산합니다.
오버로드
| Name | Description |
|---|---|
| GetCharCount(Byte*, Int32) |
지정된 바이트 포인터에서 시작하는 바이트 시퀀스를 디코딩하여 생성된 문자 수를 계산합니다. |
| GetCharCount(Byte[], Int32, Int32) |
지정된 바이트 배열에서 바이트 시퀀스를 디코딩하여 생성된 문자 수를 계산합니다. |
GetCharCount(Byte*, Int32)
Important
이 API는 CLS 규격이 아닙니다.
지정된 바이트 포인터에서 시작하는 바이트 시퀀스를 디코딩하여 생성된 문자 수를 계산합니다.
public:
override int GetCharCount(System::Byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public override int GetCharCount(byte* bytes, int count);
[System.CLSCompliant(false)]
public override int GetCharCount(byte* bytes, int count);
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int
매개 변수
- bytes
- Byte*
디코딩할 첫 번째 바이트에 대한 포인터입니다.
- count
- Int32
디코딩할 바이트 수입니다.
반품
지정된 바이트 시퀀스를 디코딩하여 생성된 문자 수입니다.
- 특성
예외
bytes는 (Nothing)입니다 null .
오류 검색을 사용하도록 설정하고 bytes 잘못된 바이트 시퀀스를 포함합니다.
설명
결과 문자를 저장하는 데 필요한 정확한 배열 크기를 GetChars 계산하기 위해 애플리케이션에서 사용합니다 GetCharCount. 최대 배열 크기를 계산하려면 애플리케이션에서 .를 사용해야 GetMaxCharCount합니다. 메서드는 GetCharCount 일반적으로 더 적은 메모리를 할당하지만 메서드는 GetMaxCharCount 일반적으로 더 빠르게 실행됩니다.
오류 검색을 사용하면 잘못된 시퀀스로 인해 이 메서드가 을 throw합니다 ArgumentException. 오류 검색이 없으면 잘못된 시퀀스가 무시되고 예외가 throw되지 않습니다.
추가 정보
적용 대상
GetCharCount(Byte[], Int32, Int32)
지정된 바이트 배열에서 바이트 시퀀스를 디코딩하여 생성된 문자 수를 계산합니다.
public:
override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);
public override int GetCharCount(byte[] bytes, int index, int count);
override this.GetCharCount : byte[] * int * int -> int
Public Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As Integer
매개 변수
- bytes
- Byte[]
디코딩할 바이트 시퀀스를 포함하는 바이트 배열입니다.
- index
- Int32
디코딩할 첫 번째 바이트의 인덱스입니다.
- count
- Int32
디코딩할 바이트 수입니다.
반품
지정된 바이트 시퀀스를 디코딩하여 생성된 문자 수입니다.
예외
bytes는 (Nothing)입니다 null .
index 또는 count 0보다 작습니다.
-또는-
index 에서 count 유효한 범위를 bytes나타내지 않습니다.
-또는-
결과 바이트 수가 정수로 반환될 수 있는 최대 수보다 큽니다.
오류 검색을 사용하도록 설정하고 bytes 잘못된 바이트 시퀀스를 포함합니다.
예제
다음 예제에서는 메서드를 사용하여 GetCharCount 바이트 배열 UnicodeEncoding의 요소 범위를 디코딩하여 생성된 문자 수를 반환하는 방법을 보여 줍니다.
using System;
using System.Text;
class UnicodeEncodingExample {
public static void Main() {
Byte[] bytes = new Byte[] {
85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
};
UnicodeEncoding Unicode = new UnicodeEncoding();
int charCount = Unicode.GetCharCount(bytes, 2, 8);
Console.WriteLine(
"{0} characters needed to decode bytes.", charCount
);
}
}
Imports System.Text
Class UnicodeEncodingExample
Public Shared Sub Main()
Dim bytes() As Byte = {85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0}
Dim uni As New UnicodeEncoding()
Dim charCount As Integer = uni.GetCharCount(bytes, 2, 8)
Console.WriteLine("{0} characters needed to decode bytes.", charCount)
End Sub
End Class
설명
결과 문자를 저장하는 데 필요한 GetChars 정확한 배열 크기를 계산하기 위해 애플리케이션에서 사용합니다 GetCharCount. 최대 배열 크기를 계산하려면 애플리케이션에서 .를 사용해야 GetMaxCharCount합니다. 메서드는 GetCharCount 일반적으로 더 적은 메모리를 할당하지만 메서드는 GetMaxCharCount 일반적으로 더 빠르게 실행됩니다.
오류 검색을 사용하면 잘못된 시퀀스로 인해 이 메서드가 을 throw합니다 ArgumentException. 오류 검색이 없으면 잘못된 시퀀스가 무시되고 예외가 throw되지 않습니다.