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