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

Определение

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

System

Сборки:

netstandard.dll, 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.

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*

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

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentOutOfRangeException

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

ArgumentException

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

Комментарии

Note

Примеры и исчерпывающие сведения об этом и других 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[]

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

Комментарии

Note

Примеры и исчерпывающие сведения об этом и других 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*

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

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

value равно null.

ArgumentException

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

ArgumentOutOfRangeException

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

AccessViolationException

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

Комментарии

Note

Примеры и исчерпывающие сведения об этом и других 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 меньше нуля.

Комментарии

Note

Примеры и исчерпывающие сведения об этом и других 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 задает адрес меньше 64000.

Комментарии

Note

Примеры и исчерпывающие сведения об этом и других 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.

Комментарии

Note

Примеры и исчерпывающие сведения об этом и других 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-разрядных целых чисел со знаком. Целые числа интерпретируются с помощью текущей кодировки системной кодовой страницы на Windows (называемой CP_ACP) и кодировкой UTF-8 в не Windows.

startIndex

Int32

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

length

Int32

Количество используемых байтов value .

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

value равно null.

ArgumentOutOfRangeException

startIndex или length меньше нуля.

–или–

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

–или–

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

ArgumentException

Адрес, указанный value + startIndex менее 64K.

–или–

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

AccessViolationException

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

Комментарии

Note

Примеры и исчерпывающие сведения об этом и других 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 ссылается ссылка, закодирован. В противном случае encnullпредполагается кодировка ANSI.

Атрибуты

CLSCompliantAttribute

Исключения

ArgumentNullException

value равно null.

ArgumentOutOfRangeException

startIndex или length меньше нуля.

–или–

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

–или–

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

ArgumentException

Адрес, указанный value + startIndex менее 64K.

–или–

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

AccessViolationException

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

Комментарии

Note

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