String Конструкторы
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса 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
- Исходный код:
- String.cs
- Исходный код:
- 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*
Указатель на строку знаков в кодировке Юникод, завершающуюся нулевым значением.
- Атрибуты
Исключения
Текущий процесс не имеет доступа на чтение ко всем рассматриваемым символам.
value
указывает массив, содержащий недопустимый символ Юникода, или value
определяет адрес меньше 64 000.
Комментарии
Примечание
Примеры и подробные сведения об использовании этой и других String
перегрузок конструктора см. в сводке по конструктору String .
Применяется к
String(Char[])
- Исходный код:
- String.cs
- Исходный код:
- String.cs
- Исходный код:
- 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>)
- Исходный код:
- String.cs
- Исходный код:
- String.cs
- Исходный код:
- 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
- Исходный код:
- String.cs
- Исходный код:
- 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-разрядных целых чисел со знаком, завершающийся нулевым значением. Целые числа интерпретируются с использованием текущей системы кодировки страницы системным кодом (то есть, кодировки, заданной Default).
- Атрибуты
Исключения
value
имеет значение null
.
Не удалось инициализировать новый экземпляр String с помощью value
, если предполагается, что value
представлен в кодировке ANSI.
Длина новой инициализируемой строки, определяемая символом, завершающимся нулевым значением value
, слишком велика для выделения.
value
указывает недопустимый адрес.
Комментарии
Примечание
Примеры и подробные сведения об использовании этой и других String
перегрузок конструктора см. в сводке по конструктору String .
Применяется к
String(Char, Int32)
- Исходный код:
- String.cs
- Исходный код:
- String.cs
- Исходный код:
- 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
.
Исключения
Значение параметра count
меньше нуля.
Комментарии
Примечание
Примеры и подробные сведения об использовании этой и других String
перегрузок конструктора см. в сводке по конструктору String .
Применяется к
String(Char*, Int32, Int32)
- Исходный код:
- String.cs
- Исходный код:
- String.cs
- Исходный код:
- 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
меньше нуля, value
+ startIndex
приводит к переполнению указателя, или текущий процесс не имеет доступа на чтение ко всем адресуемым символам.
value
указывает массив, содержащий недопустимый символ Юникода, или value
+ startIndex
определяет адрес меньше 64 000.
Комментарии
Примечание
Примеры и подробные сведения об использовании этой и других String
перегрузок конструктора см. в сводке по конструктору String .
Применяется к
String(Char[], Int32, Int32)
- Исходный код:
- String.cs
- Исходный код:
- String.cs
- Исходный код:
- 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
.
Исключения
value
имеет значение null
.
Значение параметра startIndex
или length
меньше нуля.
-или-
Сумма startIndex
и length
больше, чем число элементов в value
.
Комментарии
Примечание
Примеры и подробные сведения об использовании этой и других String
перегрузок конструктора см. в сводке по конструктору String .
Применяется к
String(SByte*, Int32, Int32)
- Исходный код:
- String.cs
- Исходный код:
- String.cs
- Исходный код:
- 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-разрядных целых чисел со знаком. Целые числа интерпретируются с использованием текущей системы кодировки страницы системным кодом (то есть, кодировки, заданной Default).
- startIndex
- Int32
Начальная позиция в value
.
- length
- Int32
Используемое количество знаков в value
.
- Атрибуты
Исключения
value
имеет значение null
.
Значение параметра startIndex
или length
меньше нуля.
-или-
Адрес, указанный значениями value
+ startIndex
, слишком велик для текущей платформы, то есть при вычислении адреса произошло переполнение.
-или-
Длина новой инициализируемой строки слишком велика для выделения.
Адрес, указанный значениями value
+ startIndex
, меньше 64 000.
-или-
Не удалось инициализировать новый экземпляр String с помощью value
, исходя из предположения, что значение value
представлено в кодировке ANSI.
value
, startIndex
и length
совместно определяют недопустимый адрес.
Комментарии
Примечание
Примеры и подробные сведения об использовании этой и других String
перегрузок конструктора см. в сводке по конструктору String .
Применяется к
String(SByte*, Int32, Int32, Encoding)
- Исходный код:
- String.cs
- Исходный код:
- String.cs
- Исходный код:
- 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
меньше нуля.
-или-
Адрес, указанный значениями value
+ startIndex
, слишком велик для текущей платформы, то есть при вычислении адреса произошло переполнение.
-или-
Длина новой инициализируемой строки слишком велика для выделения.
Адрес, указанный значениями value
+ startIndex
, меньше 64 000.
-или-
Не удалось инициализировать новый экземпляр String с помощью value
, если предполагается, что value
представлен в кодировке enc
.
value
, startIndex
и length
совместно определяют недопустимый адрес.
Комментарии
Примечание
Примеры и подробные сведения об использовании этой и других String
перегрузок конструктора см. в String сводке конструктора.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по