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 na pole znaků Unicode.
String(Char[])	Inicializuje novou instanci String třídy na znaky Unicode uvedené v zadaném znakovém poli.
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é znaménka celých čísel.
String(Char, Int32)	Inicializuje novou instanci String třídy na hodnotu označenou zadaným znakem Unicode se opakuje zadaný početkrát.
String(Char*, Int32, Int32)	Inicializuje novou instanci String třídy na hodnotu označenou zadaným ukazatelem na pole znaků Unicode, počáteční pozici znaku v dané matici 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 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 znaménka celých čísel, počáteční pozici v dané matici a délku.
String(SByte*, Int32, Int32, Encoding)	Inicializuje novou instanci třídy String na hodnotu uvedenou zadaným ukazatelem na pole 8bitových znaménků, počáteční pozici v dané matici, délku a Encoding objektu.

Poznámky

Další informace o tomto rozhraní API naleznete v tématu Doplňkové poznámky rozhraní API pro konstruktor string.

String(Char*)

Zdroj:

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 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 s ukončenou 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 využití tohoto a dalších String přetížení konstruktoru najdete v souhrnu konstruktoru String.

String(Char[])

Zdroj:

String.cs

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

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 využití tohoto a dalších String přetížení konstruktoru najdete v souhrnu konstruktoru String.

String(ReadOnlySpan<Char>)

Zdroj:

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*)

Zdroj:

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é znaménka celých čísel.

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 8bitovým signedtegers zakončeným hodnotou null. Celá čísla se interpretují pomocí aktuálního kódování znakové stránky systému ve Windows (označované jako CP_ACP) a jako kódování UTF-8 v jiných systémech než Windows.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentNullException

value je null.

ArgumentException

Novou instanci String nelze inicializovat pomocí valueza předpokladu, že value je kódován v ANSI.

ArgumentOutOfRangeException

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

AccessViolationException

value určuje neplatnou adresu.

Poznámky

Poznámka

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

String(Char, Int32)

Zdroj:

String.cs

Inicializuje novou instanci String třídy na hodnotu označenou zadaným znakem Unicode se opakuje zadaný početkrát.

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

Počet výskytů c.

Výjimky

ArgumentOutOfRangeException

count je menší než nula.

Poznámky

Poznámka

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

String(Char*, Int32, Int32)

Zdroj:

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 znaků Unicode, počáteční pozici znaku v dané matici 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ů v value, které se mají použít.

Atributy

CLSCompliantAttribute

Výjimky

ArgumentOutOfRangeException

startIndex nebo length je menší než nula, value + startIndex způsobit 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 využití tohoto a dalších String přetížení konstruktoru najdete v souhrnu konstruktoru String.

String(Char[], Int32, Int32)

Zdroj:

String.cs

Inicializuje novou instanci String třídy na hodnotu určenou polem znaků Unicode, počáteční pozici znaku v rámci 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ů v value, které se mají použít.

Výjimky

ArgumentNullException

value je null.

ArgumentOutOfRangeException

startIndex nebo length je menší než nula.

-nebo-

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

Poznámky

Poznámka

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

String(SByte*, Int32, Int32)

Zdroj:

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 znaménka celých čísel, počáteční pozici v dané matici 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 s 8bitovými celými čísly. Celá čísla se interpretují pomocí aktuálního kódování znakové stránky systému ve Windows (označované jako CP_ACP) a jako kódování UTF-8 v jiných systémech než Windows.

startIndex

Int32

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

length

Int32

Počet znaků v 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á value + startIndex je pro aktuální platformu příliš velká; to znamená přetečení adresy.

-nebo-

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

ArgumentException

Adresa zadaná value + startIndex je menší než 64 tisíc.

-nebo-

Novou instanci String nelze inicializovat pomocí valueza předpokladu, že value je kódován v ANSI.

AccessViolationException

value, startIndexa length souhrnně zadejte neplatnou adresu.

Poznámky

Poznámka

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

String(SByte*, Int32, Int32, Encoding)

Zdroj:

String.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci třídy String na hodnotu uvedenou zadaným ukazatelem na pole 8bitových znaménků, počáteční pozici v dané matici, délku a Encoding objektu.

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 s 8bitovými celými čísly.

startIndex

Int32

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

length

Int32

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

enc

Encoding

Objekt, který určuje, jak je pole odkazováno value je kódováno. Pokud je encnull, 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á value + startIndex je pro aktuální platformu příliš velká; to znamená přetečení adresy.

-nebo-

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

ArgumentException

Adresa zadaná value + startIndex je menší než 64 tisíc.

-nebo-

Novou instanci String nelze inicializovat pomocí value, za předpokladu, že value je kódován podle enc.

AccessViolationException

value, startIndexa length souhrnně zadejte neplatnou adresu.

Poznámky

Poznámka

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