String 생성자
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
String 클래스의 새 인스턴스를 초기화합니다.
오버로드
| String(Char*) |
유니코드 문자 배열에 대한 지정된 포인터가 가리키는 값으로 String 클래스의 새 인스턴스를 초기화합니다. |
| String(Char[]) |
지정된 문자 배열에서 나타내는 유니코드 문자로 String 클래스의 새 인스턴스를 초기화합니다. |
| String(ReadOnlySpan<Char>) |
지정된 읽기 전용 범위에서 나타내는 유니코드 문자로 String 클래스의 새 인스턴스를 초기화합니다. |
| String(SByte*) |
8비트 부호 있는 정수 배열에 대한 포인터가 나타내는 값으로 String 클래스의 새 인스턴스를 초기화합니다. |
| String(Char, Int32) |
지정한 횟수만큼 반복되는 지정된 유니코드 문자가 나타내는 값으로 String 클래스의 새 인스턴스를 초기화합니다. |
| String(Char*, Int32, Int32) |
유니코드 문자 배열에 대한 지정된 포인터가 나타내는 값, 해당 배열 내의 시작 문자 위치 및 길이로 String 클래스의 새 인스턴스를 초기화합니다. |
| String(Char[], Int32, Int32) |
유니코드 문자 배열에서 나타내는 값, 해당 배열 내의 시작 문자 위치 및 길이로 String 클래스의 새 인스턴스를 초기화합니다. |
| String(SByte*, Int32, Int32) |
8비트 부호 있는 정수 배열에 대한 지정된 포인터가 나타내는 값, 해당 배열 내의 시작 위치 및 길이로 String 클래스의 새 인스턴스를 초기화합니다. |
| String(SByte*, Int32, Int32, Encoding) |
8비트 부호 있는 정수 배열에 대한 지정된 포인터가 나타내는 값, 해당 배열 내의 시작 문자 위치, 길이 및 String 개체로 Encoding 클래스의 새 인스턴스를 초기화합니다. |
설명
이 API에 대한 자세한 내용은 String 생성자에 대한 추가 API 설명을 참조하세요.
String(Char*)
중요
이 API는 CLS 규격이 아닙니다.
유니코드 문자 배열에 대한 지정된 포인터가 가리키는 값으로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(char* value);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String (char* value);[System.CLSCompliant(false)]
public String (char* value);[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<char> -> string[<System.CLSCompliant(false)>]
new string : nativeptr<char> -> string매개 변수
- value
- Char*
null로 끝나는 유니코드 문자 배열에 대한 포인터입니다.
- 특성
예외
현재 프로세스에 주소가 지정된 모든 문자에 대한 읽기 액세스 권한이 있는 것은 아닙니다.
value는 잘못된 유니코드 문자가 포함된 배열을 지정하거나 value가 64000보다 작은 주소를 지정합니다.
설명
참고
이 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
String(Char[])
지정된 문자 배열에서 나타내는 유니코드 문자로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(cli::array <char> ^ value);public String (char[] value);public String (char[]? value);new string : char[] -> stringPublic Sub New (value As Char())매개 변수
- value
- Char[]
유니코드 문자 배열입니다.
설명
참고
이 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
String(ReadOnlySpan<Char>)
지정된 읽기 전용 범위에서 나타내는 유니코드 문자로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(ReadOnlySpan<char> value);public String (ReadOnlySpan<char> value);new string : ReadOnlySpan<char> -> stringPublic Sub New (value As ReadOnlySpan(Of Char))매개 변수
- value
- ReadOnlySpan<Char>
유니코드 문자의 읽기 전용 범위입니다.
적용 대상
String(SByte*)
중요
이 API는 CLS 규격이 아닙니다.
8비트 부호 있는 정수 배열에 대한 포인터가 나타내는 값으로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(System::SByte* value);[System.CLSCompliant(false)]
public String (sbyte* value);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String (sbyte* value);[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> -> string[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<sbyte> -> string매개 변수
- value
- SByte*
null로 끝나는 8비트 부호 있는 정수 배열에 대한 포인터입니다. 정수는 현재 시스템 코드 페이지 인코딩(즉, Default로 지정된 인코딩)을 사용하여 해석됩니다.
- 특성
예외
value은 null입니다.
value가 ANSI로 인코딩되었다고 가정하고 String의 새 인스턴스를 value를 사용하여 초기화할 수 없습니다.
value의 null 종결 문자로 결정되는 초기화할 새 문자열의 길이가 너무 커서 할당할 수 없습니다.
value가 잘못된 주소를 지정합니다.
설명
참고
이 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
String(Char, Int32)
지정한 횟수만큼 반복되는 지정된 유니코드 문자가 나타내는 값으로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(char c, int count);public String (char c, int count);new string : char * int -> stringPublic Sub New (c As Char, count As Integer)매개 변수
- c
- Char
유니코드 문자입니다.
- count
- Int32
c가 발생하는 횟수입니다.
예외
count가 0보다 작은 경우
설명
참고
이 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
String(Char*, Int32, Int32)
중요
이 API는 CLS 규격이 아닙니다.
유니코드 문자 배열에 대한 지정된 포인터가 나타내는 값, 해당 배열 내의 시작 문자 위치 및 길이로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(char* value, int startIndex, int length);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String (char* value, int startIndex, int length);[System.CLSCompliant(false)]
public String (char* value, int startIndex, int length);[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<char> * int * int -> string[<System.CLSCompliant(false)>]
new string : nativeptr<char> * int * int -> string매개 변수
- value
- Char*
유니코드 문자 배열에 대한 포인터입니다.
- startIndex
- Int32
value 내의 시작 위치입니다.
- length
- Int32
value 내에서 사용할 문자의 수입니다.
- 특성
예외
startIndex 또는 length가 0보다 작거나 value + startIndex로 인해 포인터 오버플로가 발생하거나, 현재 프로세스에서 주소가 지정된 모든 문자에 대한 읽기 액세스 권한을 갖지는 않습니다.
value는 잘못된 유니코드 문자가 포함된 배열을 지정하거나 value + startIndex가 64000보다 작은 주소를 지정합니다.
설명
참고
이 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
String(Char[], Int32, Int32)
유니코드 문자 배열에서 나타내는 값, 해당 배열 내의 시작 문자 위치 및 길이로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(cli::array <char> ^ value, int startIndex, int length);public String (char[] value, int startIndex, int length);new string : char[] * int * int -> stringPublic Sub New (value As Char(), startIndex As Integer, length As Integer)매개 변수
- value
- Char[]
유니코드 문자 배열입니다.
- startIndex
- Int32
value 내의 시작 위치입니다.
- length
- Int32
value 내에서 사용할 문자의 수입니다.
예외
value은 null입니다.
startIndex 또는 length가 0보다 작습니다.
또는
startIndex와 length의 합계가 value의 요소 수보다 큽니다.
설명
참고
이 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
String(SByte*, Int32, Int32)
중요
이 API는 CLS 규격이 아닙니다.
8비트 부호 있는 정수 배열에 대한 지정된 포인터가 나타내는 값, 해당 배열 내의 시작 위치 및 길이로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(System::SByte* value, int startIndex, int length);[System.CLSCompliant(false)]
public String (sbyte* value, int startIndex, int length);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String (sbyte* value, int startIndex, int length);[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int -> string[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<sbyte> * int * int -> string매개 변수
- startIndex
- Int32
value 내의 시작 위치입니다.
- length
- Int32
value 내에서 사용할 문자의 수입니다.
- 특성
예외
value은 null입니다.
startIndex 또는 length가 0보다 작습니다.
또는
value + startIndex로 지정된 주소가 현재 플랫폼에 비해 너무 큽니다. 즉, 주소 계산이 오버플로됩니다.
또는
초기화할 새 문자열의 길이가 너무 커서 할당할 수 없습니다.
value + startIndex로 지정된 주소가 64K 미만입니다.
또는
value가 ANSI로 인코딩되었다고 가정하고 String의 새 인스턴스를 value를 사용하여 초기화할 수 없습니다.
value, startIndex 및 length가 전체적으로 잘못된 주소를 지정합니다.
설명
참고
이 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
String(SByte*, Int32, Int32, Encoding)
중요
이 API는 CLS 규격이 아닙니다.
public:
String(System::SByte* value, int startIndex, int length, System::Text::Encoding ^ enc);[System.CLSCompliant(false)]
public String (sbyte* value, int startIndex, int length, System.Text.Encoding enc);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public String (sbyte* value, int startIndex, int length, System.Text.Encoding enc);[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> * int * int * System.Text.Encoding -> string[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
new string : nativeptr<sbyte> * int * int * System.Text.Encoding -> string매개 변수
- value
- SByte*
8비트 부호 있는 정수에 대한 포인터입니다.
- startIndex
- Int32
value 내의 시작 위치입니다.
- length
- Int32
value 내에서 사용할 문자의 수입니다.
- enc
- Encoding
value에서 참조하는 배열이 인코딩되는 방법을 지정하는 개체입니다. enc가 null이면 ANSI 인코딩으로 간주됩니다.
- 특성
예외
value은 null입니다.
startIndex 또는 length가 0보다 작습니다.
또는
value + startIndex로 지정된 주소가 현재 플랫폼에 비해 너무 큽니다. 즉, 주소 계산이 오버플로됩니다.
또는
초기화할 새 문자열의 길이가 너무 커서 할당할 수 없습니다.
value + startIndex로 지정된 주소가 64K 미만입니다.
또는
value가 enc로 지정된 대로 인코딩되었다고 가정하고 String의 새 인스턴스를 value를 사용하여 초기화할 수 없습니다.
value, startIndex 및 length가 전체적으로 잘못된 주소를 지정합니다.
설명
참고
이 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
.NET
피드백
출시 예정: 2024년 내내 콘텐츠 피드백 메커니즘인 GitHub 문제를 단계적으로 폐지하고 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 https://aka.ms/ContentUserFeedback을 참조하세요.
다음에 대한 사용자 의견 제출 및 보기