String Konstruktory

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Inicjuje nowe wystąpienie klasy String.

Przeciążenia

String(Char*)	Inicjuje nowe wystąpienie String klasy do wartości wskazanej przez określony wskaźnik do tablicy znaków Unicode.
String(Char[])	Inicjuje String nowe wystąpienie klasy do znaków Unicode wskazanych w określonej tablicy znaków.
String(ReadOnlySpan<Char>)	Inicjuje String nowe wystąpienie klasy do znaków Unicode wskazanych w określonym zakresie tylko do odczytu.
String(SByte*)	Inicjuje nowe wystąpienie String klasy do wartości wskazanej przez wskaźnik do tablicy 8-bitowych liczb całkowitych ze znakiem.
String(Char, Int32)	Inicjuje nowe wystąpienie String klasy do wartości wskazanej przez określony znak Unicode powtórzony określoną liczbę razy.
String(Char*, Int32, Int32)	Inicjuje nowe wystąpienie String klasy 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 String nowe wystąpienie klasy 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 String klasy 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 String klasy 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 Encoding obiektu.

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla konstruktora ciągów.

String(Char*)

Źródło:

String.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie String klasy 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ścią 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

Uwaga

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

String(Char[])

Źródło:

String.cs

Inicjuje String nowe wystąpienie klasy 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

Uwaga

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

String(ReadOnlySpan<Char>)

Źródło:

String.cs

Inicjuje String nowe wystąpienie klasy 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 String klasy 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 zakończonej wartością null z 8-bitowymi liczbami całkowitymi ze znakiem. Liczby całkowite są interpretowane przy użyciu bieżącego kodowania strony kodowej systemu (czyli kodowania określonego przez Default).

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

value to null.

ArgumentException

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

ArgumentOutOfRangeException

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

AccessViolationException

value określa nieprawidłowy adres.

Uwagi

Uwaga

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

String(Char, Int32)

Źródło:

String.cs

Inicjuje nowe wystąpienie String klasy 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

Parametr count ma wartość niższą niż zero.

Uwagi

Uwaga

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych String przeciążeń konstruktora 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 String klasy 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 obrębie value.

length

Int32

Liczba znaków, których należy value użyć.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentOutOfRangeException

startIndex wartość lub length jest mniejsza niż zero, value + startIndex powoduje 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

Uwaga

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

String(Char[], Int32, Int32)

Źródło:

String.cs

Inicjuje String nowe wystąpienie klasy 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 obrębie value.

length

Int32

Liczba znaków, których należy value użyć.

Wyjątki

ArgumentNullException

value to null.

ArgumentOutOfRangeException

startIndex wartość lub length jest mniejsza niż zero.

-lub-

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

Uwagi

Uwaga

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych String przeciążeń konstruktora 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 String klasy 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 (czyli kodowania określonego przez Default).

startIndex

Int32

Pozycja początkowa w obrębie value.

length

Int32

Liczba znaków, których należy value użyć.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

value to null.

ArgumentOutOfRangeException

startIndex wartość 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 zostało przepełnione.

-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 klasy przy użyciu metody value, przy założeniuString, że value jest zakodowany w ansi.

AccessViolationException

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

Uwagi

Uwaga

Przykłady i kompleksowe informacje o użyciu dotyczące tego i innych String przeciążeń konstruktora 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 String klasy 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 Encoding obiektu.

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 obrębie value.

length

Int32

Liczba znaków, których należy value użyć.

enc

Encoding

Obiekt, który określa, jak tablica przywoływająca przez value jest kodowana. Jeśli enc parametr ma nullwartość , przyjmuje się kodowanie ANSI.

Atrybuty

CLSCompliantAttribute

Wyjątki

ArgumentNullException

value to null.

ArgumentOutOfRangeException

startIndex wartość 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 zostało przepełnione.

-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 klasy przy użyciu metody value, przy założeniuString, że value jest kodowany zgodnie z opisem w encparametrze .

AccessViolationException

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

Uwagi

Uwaga

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