String Konstruktory

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Inicializuje novou instanci String třídy .

Přetížení

String(Char*)	Inicializuje novou instanci String třídy na hodnotu označenou zadaným ukazatelem pole znaků Unicode.
String(Char[])	Inicializuje novou instanci String třídy na znaky Unicode uvedené v zadaném poli znaků.
String(ReadOnlySpan<Char>)	Inicializuje novou instanci String třídy na znaky Unicode uvedené v zadaném rozsahu jen pro čtení.
String(SByte*)	Inicializuje novou instanci String třídy na hodnotu označenou ukazatelem na pole 8bitových celých čísel se znaménkem.
String(Char, Int32)	Inicializuje novou instanci String třídy na hodnotu označenou zadaným znakem Unicode opakovaným zadaným počtem opakování.
String(Char*, Int32, Int32)	Inicializuje novou instanci String třídy na hodnotu určenou zadaným ukazatelem na pole znaků Unicode, počáteční pozici znaku v rámci tohoto pole a délku.
String(Char[], Int32, Int32)	Inicializuje novou instanci String třídy na hodnotu určenou polem znaků Unicode, počáteční pozici znaku v rámci tohoto pole a délku.
String(SByte*, Int32, Int32)	Inicializuje novou instanci String třídy na hodnotu označenou zadaným ukazatelem na pole 8bitových celých čísel se znaménkem, počáteční pozici v rámci tohoto pole a délku.
String(SByte*, Int32, Int32, Encoding)	Inicializuje novou instanci String třídy na hodnotu určenou ukazatelem na pole 8bitových celých čísel se znaménkem, počáteční pozici v rámci tohoto pole, délku a Encoding objekt.

Poznámky

Další informace o tomto rozhraní API najdete v tématu Doplňkové poznámky rozhraní API pro konstruktor řetězce.

String(Char*)

Source:

String.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci String třídy na hodnotu označenou zadaným ukazatelem pole znaků Unicode.

public:
 String(char* value);

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

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

Parametry

value

Char*

Ukazatel na pole znaků Unicode ukončené hodnotou null.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentOutOfRangeException

Aktuální proces nemá přístup ke čtení všech adresovaných znaků.

ArgumentException

value Určuje pole, které obsahuje neplatný znak Unicode, nebo value určuje adresu menší než 64000.

Poznámky

Poznámka

Příklady a komplexní informace o tomto a dalších String přetíženích konstruktoru najdete v souhrnu konstruktoru String .

String(Char[])

Source:

String.cs

Inicializuje novou instanci String třídy na znaky Unicode uvedené v zadaném poli znaků.

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

public String (char[]? value);

new string : char[] -> string

Public Sub New (value As Char())

Parametry

value

Char[]

Pole znaků Unicode.

Poznámky

Poznámka

Příklady a komplexní informace o tomto a dalších String přetíženích konstruktoru najdete v souhrnu konstruktoru String .

String(ReadOnlySpan<Char>)

Source:

String.cs

Inicializuje novou instanci String třídy na znaky Unicode uvedené v zadaném rozsahu jen pro čtení.

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>

Rozsah znaků Unicode jen pro čtení.

String(SByte*)

Source:

String.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci String třídy na hodnotu označenou ukazatelem na pole 8bitových celých čísel se znaménkem.

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

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

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

Parametry

value

SByte*

Ukazatel na pole s ukončenou hodnotou null 8bitových celých čísel se signedýmmimi maticí. Celá čísla jsou interpretována pomocí aktuálního kódování systémové znakové stránky (to znamená kódování určené parametrem Default).

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

value je null.

ArgumentException

Novou instanci objektu String nelze inicializovat pomocí value, za předpokladu, že value je zakódovaná v ANSI.

ArgumentOutOfRangeException

Délka nového řetězce k inicializaci, která je určena znakem ukončení null , valueje příliš velká pro přidělení.

AccessViolationException

value určuje neplatnou adresu.

Poznámky

Poznámka

Příklady a komplexní informace o tomto a dalších String přetíženích konstruktoru najdete v souhrnu konstruktoru String .

String(Char, Int32)

Source:

String.cs

Inicializuje novou instanci String třídy na hodnotu označenou zadaným znakem Unicode opakovaným zadaným počtem opakování.

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 kódování Unicode

count

Int32

Počet výskytů c .

Výjimky

ArgumentOutOfRangeException

Hodnota count je menší než nula.

Poznámky

Poznámka

Příklady a komplexní informace o tomto a dalších String přetíženích konstruktoru najdete v souhrnu konstruktoru String .

String(Char*, Int32, Int32)

Source:

String.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci String třídy na hodnotu určenou zadaným ukazatelem na pole znaků Unicode, počáteční pozici znaku v rámci tohoto pole a délku.

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*

Ukazatel na pole znaků Unicode.

startIndex

Int32

Počáteční pozice v rámci value.

length

Int32

Počet znaků, value které se mají použít.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentOutOfRangeException

startIndex nebo length je menší než nula, value + startIndex způsobí přetečení ukazatele nebo aktuální proces nemá přístup ke čtení všech adresovaných znaků.

ArgumentException

value Určuje pole, které obsahuje neplatný znak Unicode, nebo value + startIndex určuje adresu menší než 64000.

Poznámky

Poznámka

Příklady a komplexní informace o tomto a dalších String přetíženích konstruktoru najdete v souhrnu konstruktoru String .

String(Char[], Int32, Int32)

Source:

String.cs

Inicializuje novou instanci String třídy na hodnotu určenou polem znaků Unicode, počáteční pozici znaku v rámci tohoto pole a délku.

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[]

Pole znaků Unicode.

startIndex

Int32

Počáteční pozice v rámci value.

length

Int32

Počet znaků, value které se mají použít.

Výjimky

ArgumentNullException

value je null.

ArgumentOutOfRangeException

startIndex nebo length je menší než nula.

-nebo-

Součet startIndex hodnot a length je větší než počet prvků v valuesouboru .

Poznámky

Poznámka

Příklady a komplexní informace o tomto a dalších String přetíženích konstruktoru najdete v souhrnu konstruktoru String .

String(SByte*, Int32, Int32)

Source:

String.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci String třídy na hodnotu označenou zadaným ukazatelem na pole 8bitových celých čísel se znaménkem, počáteční pozici v rámci tohoto pole a délku.

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*

Ukazatel na pole 8bitových celých čísel se signedýmmi sadou. Celá čísla jsou interpretována pomocí aktuálního kódování systémové znakové stránky (to znamená kódování určené parametrem Default).

startIndex

Int32

Počáteční pozice v rámci value.

length

Int32

Počet znaků, value které se mají použít.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

value je null.

ArgumentOutOfRangeException

startIndex nebo length je menší než nula.

-nebo-

Adresa zadaná parametrem value + startIndex je pro aktuální platformu příliš velká, tj. přetečení výpočtu adresy.

-nebo-

Délka nového řetězce, který se má inicializovat, je příliš velká pro přidělení.

ArgumentException

Adresa zadaná parametrem value + startIndex je menší než 64 kB.

-nebo-

Novou instanci objektu String nelze inicializovat pomocí value, za předpokladu, že value je zakódovaná v ANSI.

AccessViolationException

value, startIndexa length společně určují neplatnou adresu.

Poznámky

Poznámka

Příklady a komplexní informace o tomto a dalších String přetíženích konstruktoru najdete v souhrnu konstruktoru String .

String(SByte*, Int32, Int32, Encoding)

Source:

String.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci String třídy na hodnotu určenou ukazatelem na pole 8bitových celých čísel se znaménkem, počáteční pozici v rámci tohoto pole, délku a Encoding objekt.

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*

Ukazatel na pole 8bitových celých čísel se signedýmmi sadou.

startIndex

Int32

Počáteční pozice v rámci value.

length

Int32

Počet znaků, value které se mají použít.

enc

Encoding

Objekt, který určuje, jak je kódován pole odkazované objektem value . Pokud enc je null, předpokládá se kódování ANSI.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

value je null.

ArgumentOutOfRangeException

startIndex nebo length je menší než nula.

-nebo-

Adresa zadaná parametrem value + startIndex je pro aktuální platformu příliš velká, tj. přetečení výpočtu adresy.

-nebo-

Délka nového řetězce, který se má inicializovat, je příliš velká pro přidělení.

ArgumentException

Adresa zadaná parametrem value + startIndex je menší než 64 kB.

-nebo-

Novou instanci objektu String nelze inicializovat pomocí value, za předpokladu, že value je zakódovaná tak, jak ji specifikuje enc.

AccessViolationException

value, startIndexa length společně určují neplatnou adresu.

Poznámky

Poznámka

Příklady a komplexní informace o tomto a dalších String přetíženích konstruktoru najdete v souhrnu konstruktoru String .