String 생성자

참조

정의

네임스페이스:: System

어셈블리:: System.Runtime.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. 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에 대한 자세한 내용은 문자열 생성자대한 추가 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로 끝나는 유니코드 문자 배열에 대한 포인터입니다.

특성: CLSCompliantAttribute SecurityCriticalAttribute

예외

ArgumentOutOfRangeException

현재 프로세스에는 주소가 지정된 모든 문자에 대한 읽기 권한이 없습니다.

ArgumentException

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 규격이 아닙니다.

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 인코딩으로 해석됩니다.

특성: CLSCompliantAttribute SecurityCriticalAttribute

예외

ArgumentNullException

value null.

ArgumentException

value ANSI로 인코딩된 경우 value사용하여 String 새 인스턴스를 초기화할 수 없습니다.

ArgumentOutOfRangeException

valuenull 종료 문자에 의해 결정되는 초기화할 새 문자열의 길이가 너무 커서 할당할 수 없습니다.

AccessViolationException

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 발생 횟수입니다.

예외

ArgumentOutOfRangeException

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 내의 문자 수입니다.

특성: CLSCompliantAttribute SecurityCriticalAttribute

예외

ArgumentOutOfRangeException

startIndex 또는 length 0보다 작거나 포인터 오버플로가 발생할 value + startIndex 현재 프로세스에 주소가 지정된 모든 문자에 대한 읽기 권한이 없습니다.

ArgumentException

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 내의 문자 수입니다.

예외

ArgumentNullException

value null.

ArgumentOutOfRangeException

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 내의 문자 수입니다.

특성: CLSCompliantAttribute SecurityCriticalAttribute

예외

ArgumentNullException

value null.

ArgumentOutOfRangeException

startIndex 또는 length 0보다 작습니다.

-또는-

value + startIndex 지정한 주소가 현재 플랫폼에 비해 너무 큽니다. 즉, 주소 계산이 오버플로되었습니다.

-또는-

초기화할 새 문자열의 길이가 너무 커서 할당할 수 없습니다.

ArgumentException

value + startIndex 지정한 주소가 64K 미만입니다.

-또는-

value ANSI로 인코딩된 경우 value사용하여 String 새 인스턴스를 초기화할 수 없습니다.

AccessViolationException

value, startIndex및 length 전체적으로 잘못된 주소를 지정합니다.

설명

메모

이 생성자 오버로드 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 String 생성자 요약을 참조하세요.

적용 대상

String(SByte*, Int32, Int32, Encoding)

Source:: String.cs

Source:: String.cs

Source:: String.cs

중요

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

String 클래스의 새 인스턴스를 8비트 부가 정수 배열, 해당 배열 내의 시작 위치, 길이 및 Encoding 개체의 배열에 대한 지정한 포인터로 표시된 값으로 초기화합니다.

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 인코딩을 가정합니다.

특성: CLSCompliantAttribute SecurityCriticalAttribute

예외

ArgumentNullException

value null.

ArgumentOutOfRangeException

startIndex 또는 length 0보다 작습니다.

-또는-

value + startIndex 지정한 주소가 현재 플랫폼에 비해 너무 큽니다. 즉, 주소 계산이 오버플로되었습니다.

-또는-

초기화할 새 문자열의 길이가 너무 커서 할당할 수 없습니다.

ArgumentException

value + startIndex 지정한 주소가 64K 미만입니다.

-또는-

enc지정된 대로 value 인코딩되었다고 가정하면 value사용하여 String 새 인스턴스를 초기화할 수 없습니다.

AccessViolationException

value, startIndex및 length 전체적으로 잘못된 주소를 지정합니다.

설명

메모

이 생성자 오버로드 및 기타 String 생성자 오버로드에 대한 예제 및 포괄적인 사용 정보는 String 생성자 요약을 참조하세요.

적용 대상

다음을 통해 공유

String 생성자

정의

오버로드

설명

String(Char*)

매개 변수

예외

설명

적용 대상

String(Char[])

매개 변수

설명

적용 대상

String(ReadOnlySpan<Char>)

매개 변수

적용 대상

String(SByte*)

매개 변수

예외

설명

적용 대상

String(Char, Int32)

매개 변수

예외

설명

적용 대상

String(Char*, Int32, Int32)

매개 변수

예외

설명

적용 대상

String(Char[], Int32, Int32)

매개 변수

예외

설명

적용 대상

String(SByte*, Int32, Int32)

매개 변수

예외

설명

적용 대상

String(SByte*, Int32, Int32, Encoding)

매개 변수

예외

설명

적용 대상

추가 리소스