String Konstruktory

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Inicjuje nowe wystąpienie klasy String.

Przeciążenia

String(Char*)	Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony wskaźnik do tablicy znaków Unicode.
String(Char[])	Inicjuje nowe wystąpienie klasy String do znaków Unicode wskazanych w określonej tablicy znaków.
String(ReadOnlySpan<Char>)	Inicjuje nowe wystąpienie klasy String do znaków Unicode wskazanych w określonym zakresie tylko do odczytu.
String(SByte*)	Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez wskaźnik do tablicy 8-bitowych liczb całkowitych ze znakiem.
String(Char, Int32)	Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony znak Unicode powtórzony określoną liczbę razy.
String(Char*, Int32, Int32)	Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony wskaźnik do tablicy znaków Unicode, pozycji znaku początkowego w tej tablicy i długości.
String(Char[], Int32, Int32)	Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez tablicę znaków Unicode, pozycję znaku początkowego w tej tablicy i długość.
String(SByte*, Int32, Int32)	Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony wskaźnik do tablicy 8-bitowych liczb całkowitych ze znakiem, pozycji początkowej w tej tablicy i długości.
String(SByte*, Int32, Int32, Encoding)	Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony wskaźnik do tablicy 8-bitowych liczb całkowitych ze znakiem, pozycji początkowej w tej tablicy, długości i obiektu Encoding.

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz uwagi dotyczące dodatkowego interfejsu API dla konstruktora ciągu.

String(Char*)

Źródło:

String.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony wskaźnik do tablicy znaków Unicode.

public:
 String(char* value);

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

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

Parametry

value

Char*

Wskaźnik do tablicy znaków Unicode zakończonych wartościami null.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentOutOfRangeException

Bieżący proces nie ma dostępu do odczytu do wszystkich adresowanych znaków.

ArgumentException

value określa tablicę zawierającą nieprawidłowy znak Unicode lub value określa adres mniejszy niż 64000.

Uwagi

Nuta

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych przeciążeń konstruktora String można znaleźć w podsumowaniu konstruktora String.

String(Char[])

Źródło:

String.cs

Inicjuje nowe wystąpienie klasy String do znaków Unicode wskazanych w określonej tablicy znaków.

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

public String (char[]? value);

new string : char[] -> string

Public Sub New (value As Char())

Parametry

value

Char[]

Tablica znaków Unicode.

Uwagi

Nuta

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych przeciążeń konstruktora String można znaleźć w podsumowaniu konstruktora String.

String(ReadOnlySpan<Char>)

Źródło:

String.cs

Inicjuje nowe wystąpienie klasy String do znaków Unicode wskazanych w określonym zakresie tylko do odczytu.

public:
 String(ReadOnlySpan<char> value);

public String (ReadOnlySpan<char> value);

new string : ReadOnlySpan<char> -> string

Public Sub New (value As ReadOnlySpan(Of Char))

Parametry

value

ReadOnlySpan<Char>

Zakres znaków Unicode tylko do odczytu.

String(SByte*)

Źródło:

String.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez wskaźnik do tablicy 8-bitowych liczb całkowitych ze znakiem.

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

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

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

Parametry

value

SByte*

Wskaźnik do tablicy z 8-bitowymi liczbami całkowitymi ze znakiem null. Liczby całkowite są interpretowane przy użyciu bieżącego kodowania strony kodowej systemu w systemie Windows (określanego jako CP_ACP) i kodowania UTF-8 w systemach innych niż Windows.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

value jest null.

ArgumentException

Nie można zainicjować nowego wystąpienia String przy użyciu value, przy założeniu, że value jest zakodowany w ansi.

ArgumentOutOfRangeException

Długość nowego ciągu do zainicjowania, który jest określany przez znak zakończenia wartości null value, jest zbyt duży, aby przydzielić.

AccessViolationException

value określa nieprawidłowy adres.

Uwagi

Nuta

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych przeciążeń konstruktora String można znaleźć w podsumowaniu konstruktora String.

String(Char, Int32)

Źródło:

String.cs

Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony znak Unicode powtórzony określoną liczbę razy.

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)

Parametry

c

Char

Znak Unicode.

count

Int32

Liczba wystąpień c.

Wyjątki

ArgumentOutOfRangeException

count jest mniejsza niż zero.

Uwagi

Nuta

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych przeciążeń konstruktora String można znaleźć w podsumowaniu konstruktora String.

String(Char*, Int32, Int32)

Źródło:

String.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony wskaźnik do tablicy znaków Unicode, pozycji znaku początkowego w tej tablicy i długości.

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

Parametry

value

Char*

Wskaźnik do tablicy znaków Unicode.

startIndex

Int32

Pozycja początkowa w value.

length

Int32

Liczba znaków w value do użycia.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentOutOfRangeException

startIndex lub length jest mniejsza niż zero, value + startIndex spowodować przepełnienie wskaźnika lub bieżący proces nie ma dostępu do odczytu do wszystkich adresowanych znaków.

ArgumentException

value określa tablicę zawierającą nieprawidłowy znak Unicode lub value + startIndex określa adres mniejszy niż 64000.

Uwagi

Nuta

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych przeciążeń konstruktora String można znaleźć w podsumowaniu konstruktora String.

String(Char[], Int32, Int32)

Źródło:

String.cs

Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez tablicę znaków Unicode, pozycję znaku początkowego w tej tablicy i długość.

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)

Parametry

value

Char[]

Tablica znaków Unicode.

startIndex

Int32

Pozycja początkowa w value.

length

Int32

Liczba znaków w value do użycia.

Wyjątki

ArgumentNullException

value jest null.

ArgumentOutOfRangeException

startIndex lub length jest mniejsza niż zero.

-lub-

Suma startIndex i length jest większa niż liczba elementów w value.

Uwagi

Nuta

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych przeciążeń konstruktora String można znaleźć w podsumowaniu konstruktora String.

String(SByte*, Int32, Int32)

Źródło:

String.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony wskaźnik do tablicy 8-bitowych liczb całkowitych ze znakiem, pozycji początkowej w tej tablicy i długości.

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

Parametry

value

SByte*

Wskaźnik do tablicy 8-bitowych liczb całkowitych ze znakiem. Liczby całkowite są interpretowane przy użyciu bieżącego kodowania strony kodowej systemu w systemie Windows (określanego jako CP_ACP) i kodowania UTF-8 w systemach innych niż Windows.

startIndex

Int32

Pozycja początkowa w value.

length

Int32

Liczba znaków w value do użycia.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

value jest null.

ArgumentOutOfRangeException

startIndex lub length jest mniejsza niż zero.

-lub-

Adres określony przez value + startIndex jest zbyt duży dla bieżącej platformy; oznacza to, że obliczenie adresu przepełniło się.

-lub-

Długość nowego ciągu do zainicjowania jest zbyt duża, aby przydzielić.

ArgumentException

Adres określony przez value + startIndex jest mniejszy niż 64K.

-lub-

Nie można zainicjować nowego wystąpienia String przy użyciu value, przy założeniu, że value jest zakodowany w ansi.

AccessViolationException

value, startIndexi length łącznie określ nieprawidłowy adres.

Uwagi

Nuta

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych przeciążeń konstruktora String można znaleźć w podsumowaniu konstruktora String.

String(SByte*, Int32, Int32, Encoding)

Źródło:

String.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie klasy String do wartości wskazanej przez określony wskaźnik do tablicy 8-bitowych liczb całkowitych ze znakiem, pozycji początkowej w tej tablicy, długości i obiektu 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

Parametry

value

SByte*

Wskaźnik do tablicy 8-bitowych liczb całkowitych ze znakiem.

startIndex

Int32

Pozycja początkowa w value.

length

Int32

Liczba znaków w value do użycia.

enc

Encoding

Obiekt określający sposób kodowania tablicy, do których odwołuje się value. Jeśli enc jest null, przyjmuje się, że przyjmuje się kodowanie ANSI.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

value jest null.

ArgumentOutOfRangeException

startIndex lub length jest mniejsza niż zero.

-lub-

Adres określony przez value + startIndex jest zbyt duży dla bieżącej platformy; oznacza to, że obliczenie adresu przepełniło się.

-lub-

Długość nowego ciągu do zainicjowania jest zbyt duża, aby przydzielić.

ArgumentException

Adres określony przez value + startIndex jest mniejszy niż 64K.

-lub-

Nie można zainicjować nowego wystąpienia String przy użyciu value, zakładając, że value jest kodowany zgodnie z enc.

AccessViolationException

value, startIndexi length łącznie określ nieprawidłowy adres.

Uwagi

Nuta

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych przeciążeń konstruktora String można znaleźć w podsumowaniu konstruktora String.