String Конструкторы

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Инициализирует новый экземпляр класса 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*)

Исходный код:

String.cs

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр класса String значением, определенным указателем на массив знаков Юникода.

public:
 String(char* value);

[System.CLSCompliant(false)]
public String (char* value);

[<System.CLSCompliant(false)>]
new string : nativeptr<char> -> string

Параметры

value

Char*

Указатель на строку знаков в кодировке Юникод, завершающуюся нулевым значением.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

Текущий процесс не имеет доступа на чтение ко всем рассматриваемым символам.

ArgumentException

value указывает массив, содержащий недопустимый символ Юникода, или value определяет адрес меньше 64 000.

Комментарии

Примечание

Примеры и подробные сведения об использовании этой и других String перегрузок конструктора см. в сводке по конструктору String .

String(Char[])

Исходный код:

String.cs

Инициализирует новый экземпляр класса String символами Юникода, заданными в виде массива символов.

public:
 String(cli::array <char> ^ value);

public String (char[]? value);

new string : char[] -> string

Public Sub New (value As Char())

Параметры

value

Char[]

Массив знаков Юникода.

Комментарии

Примечание

Примеры и подробные сведения об использовании этой и других String перегрузок конструктора см. в сводке по конструктору String .

String(ReadOnlySpan<Char>)

Исходный код:

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

Исходный код:

String.cs

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр класса String значением, определенным указателем на массив 8-разрядных целых чисел со знаком.

public:
 String(System::SByte* value);

[System.CLSCompliant(false)]
public String (sbyte* value);

[<System.CLSCompliant(false)>]
new string : nativeptr<sbyte> -> string

Параметры

value

SByte*

Указатель на массив 8-разрядных целых чисел со знаком, завершающийся нулевым значением. Целые числа интерпретируются с использованием текущей системы кодировки страницы системным кодом (то есть, кодировки, заданной Default).

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

value имеет значение null.

ArgumentException

Не удалось инициализировать новый экземпляр String с помощью value, если предполагается, что value представлен в кодировке ANSI.

ArgumentOutOfRangeException

Длина новой инициализируемой строки, определяемая символом, завершающимся нулевым значением value, слишком велика для выделения.

AccessViolationException

value указывает недопустимый адрес.

Комментарии

Примечание

Примеры и подробные сведения об использовании этой и других String перегрузок конструктора см. в сводке по конструктору String .

String(Char, Int32)

Исходный код:

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 меньше нуля.

Комментарии

Примечание

Примеры и подробные сведения об использовании этой и других String перегрузок конструктора см. в сводке по конструктору String .

String(Char*, Int32, Int32)

Исходный код:

String.cs

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр класса String значением, которое определяется заданным указателем на массив знаков Юникода, начальной позицией знака в этом массиве и длиной.

public:
 String(char* value, int startIndex, int length);

[System.CLSCompliant(false)]
public String (char* value, int startIndex, int length);

[<System.CLSCompliant(false)>]
new string : nativeptr<char> * int * int -> string

Параметры

value

Char*

Указатель на массив знаков Юникода.

startIndex

Int32

Начальная позиция в value.

length

Int32

Используемое количество знаков в value.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

startIndex или length меньше нуля, value + startIndex приводит к переполнению указателя, или текущий процесс не имеет доступа на чтение ко всем адресуемым символам.

ArgumentException

value указывает массив, содержащий недопустимый символ Юникода, или value + startIndex определяет адрес меньше 64 000.

Комментарии

Примечание

Примеры и подробные сведения об использовании этой и других String перегрузок конструктора см. в сводке по конструктору String .

String(Char[], Int32, Int32)

Исходный код:

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 меньше нуля.

-или-

Сумма startIndex и length больше, чем число элементов в value.

Комментарии

Примечание

Примеры и подробные сведения об использовании этой и других String перегрузок конструктора см. в сводке по конструктору String .

String(SByte*, Int32, Int32)

Исходный код:

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)>]
new string : nativeptr<sbyte> * int * int -> string

Параметры

value

SByte*

Указатель на массив 8-разрядных целых чисел со знаком. Целые числа интерпретируются с использованием текущей системы кодировки страницы системным кодом (то есть, кодировки, заданной Default).

startIndex

Int32

Начальная позиция в value.

length

Int32

Используемое количество знаков в value.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

value имеет значение null.

ArgumentOutOfRangeException

Значение параметра startIndex или length меньше нуля.

-или-

Адрес, указанный значениями value + startIndex, слишком велик для текущей платформы, то есть при вычислении адреса произошло переполнение.

-или-

Длина новой инициализируемой строки слишком велика для выделения.

ArgumentException

Адрес, указанный значениями value + startIndex, меньше 64 000.

-или-

Не удалось инициализировать новый экземпляр String с помощью value, исходя из предположения, что значение value представлено в кодировке ANSI.

AccessViolationException

value, startIndex и length совместно определяют недопустимый адрес.

Комментарии

Примечание

Примеры и подробные сведения об использовании этой и других String перегрузок конструктора см. в сводке по конструктору String .

String(SByte*, Int32, Int32, Encoding)

Исходный код:

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)>]
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

Исключения

ArgumentNullException

value имеет значение null.

ArgumentOutOfRangeException

Значение параметра startIndex или length меньше нуля.

-или-

Адрес, указанный значениями value + startIndex, слишком велик для текущей платформы, то есть при вычислении адреса произошло переполнение.

-или-

Длина новой инициализируемой строки слишком велика для выделения.

ArgumentException

Адрес, указанный значениями value + startIndex, меньше 64 000.

-или-

Не удалось инициализировать новый экземпляр String с помощью value, если предполагается, что value представлен в кодировке enc.

AccessViolationException

value, startIndex и length совместно определяют недопустимый адрес.

Комментарии

Примечание

Примеры и подробные сведения об использовании этой и других String перегрузок конструктора см. в String сводке конструктора.