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

Определение

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

Сборки:: mscorlib.dll, System.Runtime.dll

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Runtime.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.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 объект.

Строковые конструкторы делятся на две категории: без параметров указателя, а также те, у которых есть параметры указателя. Конструкторы, использующие указатели, не совместимы с CLS. Кроме того, Visual Basic не поддерживает использование указателей, а для C# требуется код, использующий указатели для выполнения в небезопасном контексте. Дополнительные сведения см. в разделе unsafe.

Дополнительные рекомендации по выбору перегрузки см. в разделе "Какой метод мне вызвать?".

String(Char[] value)
Инициализирует новый экземпляр значением, определённым массивом символов Юникода. Этот конструктор копирует символы Юникода (пример 2. Использование массива символов).

String(Char[] value, Int32 startIndex, Int32 length)
Инициализирует новый экземпляр в значение, указанное массивом символов Юникода, начальной позицией символов в этом массиве и длиной (пример 3. Использование части массива символов и повторение одного символа).

String(Char c, Int32 count)
Инициализирует новый экземпляр со значением, указанным символом Юникода, повторяемым указанное число раз (Пример 3: Использование части массива символов и повторение одного символа).

String(char* value)
(Не соответствует CLS) Инициализирует новый экземпляр значением, указанным указателем на массив символов Юникода, завершающегося символом NULL (U+0000 или \0). (Пример 4. Использование указателя на массив символов).

String(char* value, Int32 startIndex, Int32 length)
(Не соответствует CLS) Инициализирует новый экземпляр, используя значение, указанное указателем на массив символов Юникода, начальную позицию символа в этом массиве и длину. Конструктор копирует символы Юникода из value, начиная с индекса startIndex и заканчивая индексом startIndex + length - 1 (Пример 5: Создание строки из указателя и диапазона массива).

String(SByte* value)
(Не соответствует CLS) Инициализирует новый экземпляр значением, указанным указателем на массив из 8-разрядных целых чисел со знаком. Предполагается, что массив представляет строку, закодированную с помощью текущей системной кодовой страницы (т. е. кодировки, указанной в параметре Encoding.Default). Конструктор обрабатывает символы из value, начиная с места, указанного указателем, до достижения нулевого символа (0x00) (Пример 6: Создание экземпляра строки из указателя на массив знаковых байтов).

String(SByte* value, Int32 startIndex, Int32 length)
(Не соответствует CLS) Инициализирует новый экземпляр значением, указанным указателем на массив 8-разрядных целых чисел со знаком, начальную позицию в этом массиве и длину. Предполагается, что массив представляет строку, закодированную с помощью текущей системной кодовой страницы (т. е. кодировки, указанной в параметре Encoding.Default). Конструктор обрабатывает символы из значения, начиная с startIndex и заканчивая на startIndex + length - 1 (пример 6: Создание экземпляра строки из указателя на массив знаковых байтов).

String(SByte* value, Int32 startIndex, Int32 length, Encoding enc)
(Не соответствует CLS) Инициализирует новый экземпляр до значения, указанного по указателю на массив 8-разрядных целых чисел со знаком, начальную позицию в этом массиве, длину и объект Encoding.

Parameters

Ниже приведен полный список параметров, используемых String конструкторами, которые не включают параметр указателя. Параметры, используемые каждой перегрузкой, см. в приведенном выше синтаксисе перегрузки.

Параметр	Type	Description
`value`	Char[]	Массив знаков Юникода.
`c`	Char	Знак Юникода.
`startIndex`	Int32	Начальная позиция первого `value` символа в новой строке. Значение по умолчанию: 0
`length`	Int32	Число символов в `value`, которые нужно включить в новую строку. Значение по умолчанию: Array.Length
`count`	Int32	Число повторов символа `c` в новой строке. Если `count` равно нулю, значение нового объекта равно String.Emptyнулю.

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

Параметр	Type	Description
`value`	Char* –или– SByte*	Указатель на массив символов Юникода со значением NULL или массив целых чисел со знаком 8 бит. Если `value` массив или `null` пустой, значение новой строки равно String.Empty.
`startIndex`	Int32	Индекс элемента массива, который определяет первый символ в новой строке. Значение по умолчанию: 0
`length`	Int32	Количество элементов массива, используемых для создания новой строки. Если длина равна нулю, конструктор создает строку, значение которой равно String.Empty. Значение по умолчанию: Array.Length
`enc`	Encoding	Объект, указывающий, каким образом закодирован массив `value`. Значение по умолчанию: Encoding.Defaultили текущая кодовая страница ANSI системы

Exceptions

Ниже приведен список исключений, создаваемых конструкторами, которые не включают параметры указателя.

Исключение	Condition	Вызывается
ArgumentNullException	`value` равно `null`.	String(Char[], Int32, Int32)
ArgumentOutOfRangeException	Значение `startIndex`, `length` или `count` меньше нуля. –или– Сумма `startIndex` и `length` больше, чем число элементов в `value`. –или– `count` меньше нуля.	String(Char, Int32) String(Char[], Int32, Int32)

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

Исключение	Condition	Вызывается
ArgumentException	`value` указывает массив, содержащий недопустимый символ Юникода. –или– `value` или `value` + `startIndex` задает адрес, который меньше 64K. –или– Новый String экземпляр не удалось инициализировать из массива `value` байтов, так как `value` не использует кодировку кодовой страницы по умолчанию.	Все конструкторы с указателями.
ArgumentNullException	Параметр `value` имеет значение null.	String(SByte) String(SByte, Int32, Int32) String(SByte*, Int32, Int32, Encoding)
ArgumentOutOfRangeException	Текущий процесс не имеет доступа на чтение ко всем рассматриваемым символам. –или– `startIndex` или `length` меньше нуля, `value` + `startIndex` приводит к переполнению указателя, или текущий процесс не имеет доступа на чтение ко всем адресуемым символам. –или– Длина новой строки слишком велика, чтобы выделить.	Все конструкторы с указателями.
AccessViolationException	`value`, или `value` + `startIndex` + `length` - 1, указывает недопустимый адрес.	String(SByte) String(SByte, Int32, Int32) String(SByte*, Int32, Int32, Encoding)

Какой метод я должен вызвать?

Кому	Вызов или использование
Создайте строку.	Назначение из строкового литерала или существующей строки (Пример 1: Использование присваивания строк)
Создайте строку из всего массива символов.	String(Char[]) (Пример 2. Использование массива символов)
Создайте строку из части массива символов.	String(Char[], Int32, Int32) (Пример 3. Использование части массива символов и повторение одного символа)
Создайте строку, которая повторяет один и тот же символ несколько раз.	String(Char, Int32) (Пример 3. Использование части массива символов и повторение одного символа)
Создайте строку из указателя в юникод или широкий массив символов.	String(Char*)
Создайте строку из части массива символов Юникода или широких символов, используя указатель.	String(Char*, Int32, Int32)
Создайте строку из массива C++ `char` .	String(SByte), String(SByte, Int32, Int32) –или– String(SByte*, Int32, Int32, Encoding)
Создайте строку из символов ASCII.	ASCIIEncoding.GetString

Создание строк

Наиболее часто используемый метод для создания строк программным способом — простое назначение, как показано в примере 1. Класс String также включает четыре типа перегрузки конструктора, которые позволяют создавать строки из следующих значений:

Из массива символов (массив символов в кодировке UTF-16). Вы можете создать объект String из символов во всем массиве или его части. Конструктор String(Char[]) копирует все символы в массиве в новую строку. Конструктор String(Char[], Int32, Int32) копирует символы с индекса startIndex по индекс startIndex + length - 1 в новую строку. Если length значение равно нулю, значение новой строки равно String.Empty.

Если код неоднократно создает экземпляры строк с одинаковым значением, вы можете повысить производительность приложения с помощью альтернативного средства создания строк. Дополнительные сведения см. в разделе "Обработка повторяющихся строк".
С помощью конструктора String(Char, Int32) создается единичный символ, который дублируется ноль, один или несколько раз. Если count значение равно нулю, значение новой строки равно String.Empty.
От указателя на массив символов, завершающийся нулевым символом, с помощью конструктора String(Char*) или конструктора String(Char*, Int32, Int32). Для инициализации строки можно использовать весь массив или указанный диапазон. Конструктор копирует последовательность символов Юникода, начиная с указанного указателя или из указанного указателя плюс startIndex и продолжая до конца массива или символов length . Если value имеет значение NULL или length равно нулю, конструктор создает строку, значение которой равно String.Empty. Если операция копирования продолжается до конца массива и массив не завершается null, поведение конструктора зависит от системы. Такое условие может привести к нарушению доступа.

Если массив содержит все внедренные символы NULL (U+0000 или \0) и String(Char*, Int32, Int32) вызывает перегрузку, экземпляр строки содержит length символы, включая все внедренные значения NULL. В следующем примере показано, что происходит, когда указатель на массив из 10 элементов, содержащий два нулевых символа, передается в метод String(Char*, Int32, Int32). Так как адрес является началом массива, а все элементы в массиве добавляются в строку, конструктор создает экземпляр строки с десятью символами, включая два внедренных null. С другой стороны, если тот же массив передается String(Char*) конструктору, результатом является четырехзначная строка, которая не включает первый пустой символ.
```
using System;

public class Example2
{
   public unsafe static void Main()
   {
      char[] chars = { 'a', 'b', 'c', 'd', '\0', 'A', 'B', 'C', 'D', '\0' };
      string s = null;
      
      fixed(char* chPtr = chars) {
         s = new string(chPtr, 0, chars.Length);            
      } 

      foreach (var ch in s)
         Console.Write($"{(ushort)ch:X4} ");
      Console.WriteLine();
      
      fixed(char* chPtr = chars) {
         s = new string(chPtr);         
      }
      
      foreach (var ch in s)
         Console.Write($"{(ushort)ch:X4} ");
      Console.WriteLine();    
   }
}
// The example displays the following output:
//       0061 0062 0063 0064 0000 0041 0042 0043 0044 0000
//       0061 0062 0063 0064
```
```
#nowarn "9"
open System

let chars = [| 'a'; 'b'; 'c'; 'd'; '\000'; 'A'; 'B'; 'C'; 'D'; '\000' |]
let s =
    use chPtr = fixed chars
    String(chPtr, 0, chars.Length)

for ch in s do
    printf $"{uint16 ch:X4} "
printfn ""

let s2 = 
    use chPtr = fixed chars
    String chPtr    

for ch in s2 do
    printf $"{uint16 ch:X4} "
printfn ""  
// The example displays the following output:
//       0061 0062 0063 0064 0000 0041 0042 0043 0044 0000
//       0061 0062 0063 0064
```
Массив должен содержать символы Юникода. В C++это означает, что массив символов должен быть определен как управляемый Charтип [] или неуправляемыйwchar_t[] тип.

String(Char*) Если перегрузка вызывается и массив не завершается нулевым символом, или если вызывается String(Char*, Int32, Int32) перегрузка, и startIndex + length-1 охватывает диапазон, находящийся за пределами выделенной памяти для последовательности символов, поведение конструктора зависит от конкретной системы, и может произойти нарушение доступа.
Из указателя на подписанный массив байтов. Для инициализации строки можно использовать весь массив или указанный диапазон. Последовательность байтов может быть интерпретирована с помощью кодировки кодовой страницы по умолчанию, или кодировку можно указать в вызове конструктора. Если конструктор пытается создать экземпляр строки из всего массива, не завершающегося значением NULL, или если диапазон массива от value + startIndexvalue + startIndex + length-1 находится вне памяти, выделенной для массива, поведение этого конструктора зависит от системы, а нарушение доступа может произойти.

Три конструктора, включающие подписанный массив байтов в качестве параметра, предназначены в основном для преобразования массива C++ char в строку, как показано в этом примере:
```
using namespace System;

void main()
{
      char chars[] = { 'a', 'b', 'c', 'd', '\x00' };

      char* charPtr = chars;
      String^ value = gcnew String(charPtr);

      Console::WriteLine(value);
}
// The example displays the following output:
//      abcd
```
Если массив содержит любые символы NULL ('\0') или байты, значение которых равно 0, а String(SByte*, Int32, Int32) перегрузка вызывается, экземпляр строки содержит length символы, включая все внедренные значения NULL. В следующем примере показано, что происходит, когда указатель на массив из 10 элементов, содержащий два нулевых символа, передается в метод String(SByte*, Int32, Int32). Так как адрес является началом массива, а все элементы в массиве добавляются в строку, конструктор создает экземпляр строки с десятью символами, включая два внедренных null. С другой стороны, если тот же массив передается String(SByte*) конструктору, результатом является четырехзначная строка, которая не включает первый пустой символ.
```
using System;

public class Example5
{
   public unsafe static void Main()
   {
      sbyte[] bytes = { 0x61, 0x62, 0x063, 0x064, 0x00, 0x41, 0x42, 0x43, 0x44, 0x00 };
      
      string s = null;
      fixed (sbyte* bytePtr = bytes) {
         s = new string(bytePtr, 0, bytes.Length);
      }
      
      foreach (var ch in s)
         Console.Write($"{(ushort)ch:X4} ");
      
      Console.WriteLine();    

      fixed(sbyte* bytePtr = bytes) {
         s = new string(bytePtr);         
      }
      
      foreach (var ch in s)
         Console.Write($"{(ushort)ch:X4} ");
      Console.WriteLine();    
   }
}
// The example displays the following output:
//       0061 0062 0063 0064 0000 0041 0042 0043 0044 0000
//       0061 0062 0063 0064
```
```
#nowarn "9"
open System

let bytes = 
    [| 0x61y; 0x62y; 0x063y; 0x064y; 0x00y; 0x41y; 0x42y; 0x43y; 0x44y; 0x00y |]

let s =
    use bytePtr = fixed bytes
    String(bytePtr, 0, bytes.Length)

for ch in s do
    printf $"{uint16 ch:X4} "
printfn ""

let s2 =
    use bytePtr = fixed bytes
    String bytePtr         

for ch in s do
    printf $"{uint16 ch:X4} "
printfn ""
// The example displays the following output:
//       0061 0062 0063 0064 0000 0041 0042 0043 0044 0000
//       0061 0062 0063 0064
```
Поскольку конструкторы String(SByte*) и String(SByte*, Int32, Int32) интерпретируют value с использованием кодовой страницы ANSI по умолчанию, вызов этих конструкторов с одинаковыми массивами байтов может приводить к созданию строк с разными значениями на разных системах.

Обработка повторяющихся строк

Приложения, которые анализируют или декодируют потоки текста, часто используют String(Char[], Int32, Int32) конструктор или StringBuilder.Append(Char[], Int32, Int32) метод для преобразования последовательностей символов в строку. Повторное создание новых строк с одинаковым значением вместо создания и повторного использования одной строки приводит к растрате памяти. Если вы, скорее всего, будете многократно создавать одно и то же строковое значение путем вызова конструктора String(Char[], Int32, Int32), даже если вы не знаете заранее, какие это будут одинаковые строки, можно использовать таблицу поиска.

Например, предположим, что вы считываете и анализируете поток символов из файла, содержащего XML-теги и атрибуты. При анализе потока часто возникают определенные маркеры (т. е. последовательности символов с символьным значением). Элементы, эквивалентные строкам "0", "1", "true" и "false", скорее всего, часто встречаются в XML-потоке.

Вместо преобразования каждого токена в новую строку можно создать System.Xml.NameTable объект для хранения часто возникающих строк. Объект NameTable улучшает производительность, так как он извлекает сохраненные строки без выделения временной памяти. При обнаружении маркера используйте NameTable.Get(Char[], Int32, Int32) метод для получения маркера из таблицы. Если токен существует, метод возвращает соответствующую строку. Если маркер не существует, используйте NameTable.Add(Char[], Int32, Int32) метод для вставки маркера в таблицу и получения соответствующей строки.

Пример 1. Использование назначения строк

В следующем примере создается новая строка, назначая ей строковый литерал. Он создает вторую строку, назначив ему значение первой строки. Это два наиболее распространенных способа создания экземпляра нового String объекта.

using System;

public class Example3
{
   public static void Main()
   {
      String value1 = "This is a string.";
      String value2 = value1;
      Console.WriteLine(value1);
      Console.WriteLine(value2);
   }
}
// The example displays the following output:
//    This is a string.
//    This is a string.

let value1 = "This is a string."
let value2 = value1
printfn "%s" value1
printfn "%s" value2
// The example displays the following output:
//    This is a string.
//    This is a string.

Module Example
   Public Sub Main()
      Dim value1 As String = "This is a string."
      Dim value2 As String = value1
      Console.WriteLine(value1)
      Console.WriteLine(value2)
   End Sub
End Module
' The example displays the following output:
'    This is a string.
'    This is a string.

Пример 2. Использование массива символов

В следующем примере показано, как создать объект String из массива символов.

// Unicode Mathematical operators
char [] charArr1 = {'\u2200','\u2202','\u200F','\u2205'};
String szMathSymbols = new String(charArr1);

// Unicode Letterlike Symbols
char [] charArr2 = {'\u2111','\u2118','\u2122','\u2126'};
String szLetterLike = new String (charArr2);

// Compare Strings - the result is false
Console.WriteLine("The Strings are equal? " +
    (String.Compare(szMathSymbols, szLetterLike)==0?"true":"false") );

// Unicode Mathematical operators
let charArr1 = [| '\u2200'; '\u2202'; '\u200F'; '\u2205' |]
let szMathSymbols = String charArr1

// Unicode Letterlike Symbols
let charArr2 = [| '\u2111'; '\u2118'; '\u2122'; '\u2126' |]
let szLetterLike = String charArr2

// Compare Strings - the result is false
printfn $"The Strings are equal? %b{String.Compare(szMathSymbols, szLetterLike) = 0}"

' Unicode Mathematical operators
Dim charArr1() As Char = {ChrW(&H2200), ChrW(&H2202), _
                          ChrW(&H200F), ChrW(&H2205)}
Dim szMathSymbols As New String(charArr1)

' Unicode Letterlike Symbols
Dim charArr2() As Char = {ChrW(&H2111), ChrW(&H2118), _
                          ChrW(&H2122), ChrW(&H2126)}
Dim szLetterLike As New String(charArr2)

' Compare Strings - the result is false
Console.WriteLine("The strings are equal? " & _
        CStr(szMathSymbols.Equals(szLetterLike)))

Пример 3. Использование части массива символов и повторение одного символа

В следующем примере показано, как создать новый String объект из части массива символов и как создать новый String объект, содержащий несколько вхождений одного символа.

// Create a Unicode String with 5 Greek Alpha characters
String szGreekAlpha = new String('\u0391',5);
// Create a Unicode String with a Greek Omega character
String szGreekOmega = new String(new char [] {'\u03A9','\u03A9','\u03A9'},2,1);

String szGreekLetters = String.Concat(szGreekOmega, szGreekAlpha, szGreekOmega.Clone());

// Examine the result
Console.WriteLine(szGreekLetters);

// The first index of Alpha
int ialpha = szGreekLetters.IndexOf('\u0391');
// The last index of Omega
int iomega = szGreekLetters.LastIndexOf('\u03A9');

Console.WriteLine("The Greek letter Alpha first appears at index " + ialpha +
    " and Omega last appears at index " + iomega + " in this String.");

// Create a Unicode String with 5 Greek Alpha characters
let szGreekAlpha = String('\u0391',5)
// Create a Unicode String with a Greek Omega character
let szGreekOmega = String([| '\u03A9'; '\u03A9'; '\u03A9' |],2,1)

let szGreekLetters = String.Concat(szGreekOmega, szGreekAlpha, szGreekOmega.Clone())

// Examine the result
printfn $"{szGreekLetters}"

// The first index of Alpha
let ialpha = szGreekLetters.IndexOf '\u0391'
// The last index of Omega
let iomega = szGreekLetters.LastIndexOf '\u03A9'

printfn $"The Greek letter Alpha first appears at index {ialpha} and Omega last appears at index {iomega} in this String."

' Create a Unicode String with 5 Greek Alpha characters
Dim szGreekAlpha As New String(ChrW(&H0391), 5)
' Create a Unicode String with a Greek Omega character
Dim szGreekOmega As New String(New Char() {ChrW(&H03A9), ChrW(&H03A9), _
                                           ChrW(&H03A9)}, 2, 1)

Dim szGreekLetters As String = String.Concat(szGreekOmega, szGreekAlpha, _
                                             szGreekOmega.Clone())

' Examine the result
Console.WriteLine(szGreekLetters)

' The first index of Alpha
Dim iAlpha As Integer = szGreekLetters.IndexOf(ChrW(&H0391))
' The last index of Omega
Dim iomega As Integer = szGreekLetters.LastIndexOf(ChrW(&H03A9))

Console.WriteLine("The Greek letter Alpha first appears at index {0}.", _ 
                  ialpha)
Console.WriteLIne("The Greek letter Omega last appears at index {0}.", _
                  iomega)

Пример 4. Использование указателя на массив символов

В следующем примере показано, как создать объект String из указателя на массив символов. Пример C# должен быть скомпилирован с помощью переключателя компилятора /unsafe .

using System;

public class Example4
{
   public static unsafe void Main()
   {
      char[] characters = { 'H', 'e', 'l', 'l', 'o', ' ', 
                            'w', 'o', 'r', 'l', 'd', '!', '\u0000' };
      string value;
      
      fixed (char* charPtr = characters) {
         value = new String(charPtr);
      }                            
      Console.WriteLine(value);
   }
}
// The example displays the following output:
//        Hello world!

#nowarn "9"
open System

let characters = 
    [| 'H'; 'e'; 'l'; 'l'; 'o'; ' ' 
       'w'; 'o'; 'r'; 'l'; 'd'; '!'; '\u0000' |]

let value =
    use charPtr = fixed characters
    String charPtr

printfn $"{value}"
// The example displays the following output:
//        Hello world!

Пример 5. Создание экземпляра строки из указателя и диапазона массива

Следующий пример проверяет элементы массива символов на наличие точки или восклицательного знака. Если он найден, он создает экземпляр строки из символов в массиве, предшествующих символам препинания. Если нет, он создает экземпляр строки со всем содержимым массива. Пример C# должен быть скомпилирован с помощью переключателя компилятора /unsafe .

using System;

public class Example1
{
   public static unsafe void Main()
   {
      char[] characters = { 'H', 'e', 'l', 'l', 'o', ' ', 
                            'w', 'o', 'r', 'l', 'd', '!', '\u0000' };
      String value;
      
      fixed (char* charPtr = characters) {
         int length = 0;
         Char* iterator = charPtr;
   
         while (*iterator != '\x0000')
         {
            if (*iterator == '!' || *iterator == '.')
               break;
            iterator++;
            length++;
         }
         value = new String(charPtr, 0, length);
      }
      Console.WriteLine(value);
   }
}
// The example displays the following output:
//      Hello World

#nowarn "9"
open System
open FSharp.NativeInterop

let characters = 
    [| 'H'; 'e'; 'l'; 'l'; 'o'; ' '
       'w'; 'o'; 'r'; 'l'; 'd'; '!'; '\u0000' |]

[<EntryPoint>]
let main _ =
    use charPtr = fixed characters
    let mutable length = 0
    let mutable iterator = charPtr
    let mutable broken = false
    while not broken && NativePtr.read iterator <> '\u0000' do
        if NativePtr.read iterator = '!' || NativePtr.read iterator = '.' then
            broken <- true
        else
            iterator <- NativePtr.add iterator 1
            length <- length + 1
    String(charPtr, 0, length)
    |> printfn "%s"
    0
// The example displays the following output:
//      Hello World

Пример 6. Создание экземпляра строки из указателя на подписанный массив байтов

В следующем примере показано, как создать экземпляр String класса с помощью конструктора String(SByte*) .

unsafe
{
    // Null terminated ASCII characters in an sbyte array
    String szAsciiUpper = null;
    sbyte[] sbArr1 = new sbyte[] { 0x41, 0x42, 0x43, 0x00 };
    // Instruct the Garbage Collector not to move the memory
    fixed(sbyte* pAsciiUpper = sbArr1)
    {
        szAsciiUpper = new String(pAsciiUpper);
    }
    String szAsciiLower = null;
    sbyte[] sbArr2 = { 0x61, 0x62, 0x63, 0x00 };
    // Instruct the Garbage Collector not to move the memory
    fixed(sbyte* pAsciiLower = sbArr2)
    {
        szAsciiLower = new String(pAsciiLower, 0, sbArr2.Length);
    }
    // Prints "ABC abc"
    Console.WriteLine(szAsciiUpper + " " + szAsciiLower);

    // Compare Strings - the result is true
    Console.WriteLine("The Strings are equal when capitalized ? " +
        (String.Compare(szAsciiUpper.ToUpper(), szAsciiLower.ToUpper())==0?"true":"false") );

    // This is the effective equivalent of another Compare method, which ignores case
    Console.WriteLine("The Strings are equal when capitalized ? " +
        (String.Compare(szAsciiUpper, szAsciiLower, true)==0?"true":"false") );
}

// Null terminated ASCII characters in an sbyte array
let szAsciiUpper =
    let sbArr1 = [| 0x41y; 0x42y; 0x43y; 0x00y |]
    // Instruct the Garbage Collector not to move the memory
    use pAsciiUpper = fixed sbArr1
    String pAsciiUpper

let szAsciiLower =
    let sbArr2 = [| 0x61y; 0x62y; 0x63y; 0x00y |]
    // Instruct the Garbage Collector not to move the memory
    use pAsciiLower = fixed sbArr2 
    String(pAsciiLower, 0, sbArr2.Length)

// Prints "ABC abc"
printfn $"{szAsciiUpper} {szAsciiLower}"

// Compare Strings - the result is true
printfn $"The Strings are equal when capitalized ? %b{String.Compare(szAsciiUpper.ToUpper(), szAsciiLower.ToUpper()) = 0}"

// This is the effective equivalent of another Compare method, which ignores case
printfn $"The Strings are equal when capitalized ? %b{String.Compare(szAsciiUpper, szAsciiLower, true) = 0}"

String(Char*)

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: 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*

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

Атрибуты: CLSCompliantAttribute SecurityCriticalAttribute

Исключения

ArgumentOutOfRangeException

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

ArgumentException

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

Применяется к

String(Char[])

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: 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(ReadOnlySpan<Char>)

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: 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

Исходный код:: 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*

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

Атрибуты: CLSCompliantAttribute SecurityCriticalAttribute

Исключения

ArgumentNullException

value равно null.

ArgumentException

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

ArgumentOutOfRangeException

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

AccessViolationException

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

Применяется к

String(Char, Int32)

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: 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 .

Исключения

ArgumentOutOfRangeException

count меньше нуля.

Применяется к

String(Char*, Int32, Int32)

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: 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 .

Атрибуты: CLSCompliantAttribute SecurityCriticalAttribute

Исключения

ArgumentOutOfRangeException

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

ArgumentException

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

Применяется к

String(Char[], Int32, Int32)

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: 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 .

Исключения

ArgumentNullException

value равно null.

ArgumentOutOfRangeException

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

–или–

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

Применяется к

String(SByte*, Int32, Int32)

Исходный код:: String.cs

Исходный код:: String.cs

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

startIndex: Int32

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

length: Int32

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

Атрибуты: CLSCompliantAttribute SecurityCriticalAttribute

Исключения

ArgumentNullException

value равно null.

ArgumentOutOfRangeException

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

–или–

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

–или–

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

ArgumentException

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

–или–

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

AccessViolationException

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

Применяется к

String(SByte*, Int32, Int32, Encoding)

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: String.cs

Исходный код:: String.cs

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

Атрибуты: CLSCompliantAttribute SecurityCriticalAttribute

Исключения

ArgumentNullException

value равно null.

ArgumentOutOfRangeException

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

–или–

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

–или–

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

ArgumentException

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

–или–

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

AccessViolationException

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

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

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

Определение

Перегрузки

Комментарии

Синтаксис перегруженного конструктора

Parameters

Exceptions

Какой метод я должен вызвать?

Создание строк

Обработка повторяющихся строк

Пример 1. Использование назначения строк

Пример 2. Использование массива символов

Пример 3. Использование части массива символов и повторение одного символа

Пример 4. Использование указателя на массив символов

Пример 5. Создание экземпляра строки из указателя и диапазона массива

Пример 6. Создание экземпляра строки из указателя на подписанный массив байтов

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)

Параметры

Исключения

Комментарии

Применяется к

Обратная связь