String 생성자

정의

네임스페이스:
System
어셈블리:
mscorlib.dll, System.Runtime.dll
어셈블리:
netstandard.dll, System.Runtime.dll
어셈블리:
System.Runtime.dll
어셈블리:
mscorlib.dll
어셈블리:
netstandard.dll

String 클래스의 새 인스턴스를 초기화합니다.

오버로드

Name Description
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)

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

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

설명

이 API에 대한 자세한 내용은 문자열 생성자에 대한 추가 API 비고를 참조하세요.

String(Char*)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Important

이 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
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
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
Source:
String.cs
Source:
String.cs

Important

이 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*

8비트 부가 정수의 null로 끝나는 배열에 대한 포인터입니다. 정수는 Windows 현재 시스템 코드 페이지 인코딩(CP_ACP이라고 함) 및 비 Windows UTF-8 인코딩을 사용하여 해석됩니다.

특성
CLSCompliantAttribute SecurityCriticalAttribute

예외

ArgumentNullException

value은 null입니다.

ArgumentException

ANSI에서 인코딩된 것으로 가정하여 String 새 인스턴스 value 를 사용하여 value초기화할 수 없습니다.

ArgumentOutOfRangeException

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

AccessViolationException

value 은 잘못된 주소를 지정합니다.

설명

메모

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

적용 대상

String(Char, Int32)

Source:
String.cs
Source:
String.cs
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
Source:
String.cs
Source:
String.cs

Important

이 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
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
Source:
String.cs
Source:
String.cs

Important

이 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 미만입니다.

-또는-

ANSI에서 인코딩된 것으로 가정하여 String 새 인스턴스 value 를 사용하여 value초기화할 수 없습니다.

AccessViolationException

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

설명

메모

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

적용 대상

String(SByte*, Int32, Int32, Encoding)

Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs
Source:
String.cs

Important

이 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 미만입니다.

-또는-

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

AccessViolationException

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

설명

메모

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

적용 대상