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*)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
중요
이 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[])
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
지정된 문자 배열에서 나타내는 유니코드 문자로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(cli::array <char> ^ value);
public String (char[] value);
public String (char[]? value);
new string : char[] -> string
Public Sub New (value As Char())
매개 변수
- value
- Char[]
유니코드 문자 배열입니다.
설명
참고
이 및 기타 String
생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
String(ReadOnlySpan<Char>)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
지정된 읽기 전용 범위에서 나타내는 유니코드 문자로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(ReadOnlySpan<char> value);
public String (ReadOnlySpan<char> value);
new string : ReadOnlySpan<char> -> string
Public Sub New (value As ReadOnlySpan(Of Char))
매개 변수
- value
- ReadOnlySpan<Char>
유니코드 문자의 읽기 전용 범위입니다.
적용 대상
String(SByte*)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
중요
이 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)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
지정한 횟수만큼 반복되는 지정된 유니코드 문자가 나타내는 값으로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(char c, int count);
public String (char c, int count);
new string : char * int -> string
Public Sub New (c As Char, count As Integer)
매개 변수
- c
- Char
유니코드 문자입니다.
- count
- Int32
c
가 발생하는 횟수입니다.
예외
count
가 0보다 작은 경우
설명
참고
이 및 기타 String
생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 생성자 요약을 String 참조하세요.
적용 대상
String(Char*, Int32, Int32)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
중요
이 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)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
유니코드 문자 배열에서 나타내는 값, 해당 배열 내의 시작 문자 위치 및 길이로 String 클래스의 새 인스턴스를 초기화합니다.
public:
String(cli::array <char> ^ value, int startIndex, int length);
public String (char[] value, int startIndex, int length);
new string : char[] * int * int -> string
Public 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)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
중요
이 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)
- Source:
- String.cs
- Source:
- String.cs
- Source:
- String.cs
중요
이 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
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기