UTF8Encoding.GetCharCount 메서드 (Byte*, Int32)

.NET Framework 4.5

다른 버전

지정한 바이트 포인터에서 시작되는 바이트 시퀀스를 디코딩할 경우 생성되는 문자 수를 계산합니다.

이 API는 CLS 규격이 아닙니다.

네임스페이스: System.Text
어셈블리: mscorlib(mscorlib.dll)

구문

C++

[ComVisibleAttribute(false)]
[CLSCompliantAttribute(false)]
public override int GetCharCount(
	byte* bytes,
	int count
)

매개 변수

bytes: 형식: System.Byte*
디코딩할 첫째 바이트를 가리키는 포인터입니다.

count: 형식: System.Int32
디코딩할 바이트 수입니다.

반환 값

형식: System.Int32
지정한 바이트 시퀀스를 디코딩할 경우 생성되는 문자 수입니다.

예외

예외	조건
ArgumentNullException	bytes가 null입니다.
ArgumentOutOfRangeException	count가 0보다 작은 경우 또는 결과 바이트 수가 정수로 반환될 수 있는 최대 숫자보다 큰 경우
ArgumentException	오류 검색 기능을 사용하고 있으며 bytes에 잘못된 바이트 시퀀스가 포함되어 있는 경우
DecoderFallbackException	대체(fallback)가 발생한 경우. 자세한 내용은 .NET Framework의 문자 인코딩를 참조하십시오. -및- DecoderFallback 이 DecoderExceptionFallback로 설정됩니다.

설명

결과 문자를 저장하기 위해 GetChars에 필요한 정확한 배열 크기를 계산하려면 응용 프로그램에서 GetCharCount를 사용합니다. 최대 배열 크기를 계산하려면 응용 프로그램에서 GetMaxCharCount를 사용해야 합니다. 일반적으로 GetCharCount 메서드는 비교적 작은 크기의 메모리만 할당할 수 있는 반면 GetMaxCharCount 메서드는 더 빠르게 실행됩니다.

오류 검색 기능을 사용할 때 잘못된 시퀀스가 있으면 이 메서드가 ArgumentException을 throw합니다. 오류 검색을 사용하지 않으면 잘못된 시퀀스는 무시되고 아무런 예외도 throw되지 않습니다.

버전 정보

.NET Framework

4.5, 4, 3.5, 3.0, 2.0에서 지원

.NET Framework Client Profile

4, 3.5 SP1에서 지원

.NET Framework 보안

SecurityCriticalAttribute
직접 실행 호출자에 대한 완전 신뢰가 필요합니다. 이 멤버는 부분적으로 신뢰할 수 있거나 투명한 코드에서 사용할 수 없습니다.

플랫폼

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(서버 코어 역할은 지원되지 않음), Windows Server 2008 R2(서버 코어 역할은 SP1 이상에서 지원, Itanium은 지원되지 않음)

.NET Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

참고 항목

참조

이 정보가 도움이 되었습니까? 예 아니요

정확하지 않음

내용이 심층적이지 않음

코드 예가 더 필요함

번역에 개선이 필요함

(1500자 남음)

커뮤니티 추가 항목

추가