정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

Path.ChangeExtension 메서드

2013-12-13

경로 문자열의 확장명을 변경합니다.

Namespace:  System.IO
어셈블리:  mscorlib(mscorlib.dll)

public static string ChangeExtension(
	string path,
	string extension
)

매개 변수

path
형식: System.String
수정할 경로 정보입니다. 경로에는 GetInvalidPathChars에 정의된 문자가 있을 수 없습니다.
extension
형식: System.String
앞에 마침표가 있는 새 확장명입니다. path에서 기존 확장명을 제거하려면 null을 지정하세요.

반환 값

형식: System.String
수정된 경로 정보가 들어 있는 문자열입니다.
Windows 기반 데스크톱 플랫폼에서 pathnull이거나 빈 문자열("")이면 경로 정보가 수정되지 않고 반환됩니다. extensionnull이면 반환된 문자열에 확장명이 제거된 지정된 경로가 들어 있습니다. path에 확장명이 없고 extensionnull이 아니면 반환된 경로 문자열에 path 끝에 추가된 extension이 들어 있습니다.

예외조건
ArgumentException

pathGetInvalidPathChars에 정의된 잘못된 문자가 하나 이상 포함되어 있는 경우

pathextension에 마침표(.)가 없는 경우 ChangeExtension에서 마침표를 추가합니다.

extension 매개 변수에는 여러 개의 마침표와 유효한 경로 문자가 들어 있을 수 있으며 길이에 제한이 없습니다. extensionnull이면 반환된 문자열에 마지막 마침표와 그 뒤에 나오는 모든 문자가 제거된 path의 내용이 들어 있습니다.

extension이 빈 문자열이면 반환된 경로 문자열에 마지막 마침표 다음에 나오는 모든 문자를 포함한 path의 내용이 들어 있습니다.

path에 확장명이 없고 extensionnull이 아니면 반환된 문자열에 pathextension이 들어 있습니다.

extensionnull이 아니고 앞에 마침표가 없으면 마침표가 추가됩니다.

path에 여러 개의 마침표로 구분된 여러 개의 확장명이 들어 있으면 반환된 문자열에 마지막 마침표 다음에 extension으로 대체된 모든 문자를 포함하는 path의 내용이 들어 있습니다. 예를 들어, path가 "\Dir1\examples\pathtests.csx.txt"이고 extension이 "cs"이면 수정된 경로는 "\Dir1\examples\pathtests.csx.cs"입니다.

모든 경우에 반환된 결과가 유효한지 확인할 수 있는 것은 아닙니다. 예를 들어, path가 비어 있으면 extension이 추가됩니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

표시: