String Konstruktory
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
- Zdroj:
- String.cs
- 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)]
[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> -> stringParametry
- value
- Char*
Ukazatel na pole znaků Unicode s ukončenou hodnotou null.
- Atributy
Výjimky
Aktuální proces nemá přístup ke čtení všech adresovaných znaků.
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.
Platí pro
String(Char[])
- Zdroj:
- String.cs
- Zdroj:
- String.cs
- 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);public String (char[]? value);new string : char[] -> stringPublic 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.
Platí pro
String(ReadOnlySpan<Char>)
- Zdroj:
- String.cs
- Zdroj:
- String.cs
- 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> -> stringPublic Sub New (value As ReadOnlySpan(Of Char))Parametry
- value
- ReadOnlySpan<Char>
Rozsah znaků Unicode jen pro čtení.
Platí pro
String(SByte*)
- Zdroj:
- String.cs
- Zdroj:
- String.cs
- 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)]
[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> -> stringParametry
- 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
Výjimky
value je null.
Novou instanci String nelze inicializovat pomocí valueza předpokladu, že value je kódován v ANSI.
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í.
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.
Platí pro
String(Char, Int32)
- Zdroj:
- String.cs
- Zdroj:
- String.cs
- 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 -> stringPublic Sub New (c As Char, count As Integer)Parametry
- c
- Char
Znak Unicode.
- count
- Int32
Počet výskytů c.
Výjimky
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.
Platí pro
String(Char*, Int32, Int32)
- Zdroj:
- String.cs
- Zdroj:
- String.cs
- 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)]
[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 -> stringParametry
- 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
Výjimky
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ů.
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.
Platí pro
String(Char[], Int32, Int32)
- Zdroj:
- String.cs
- Zdroj:
- String.cs
- 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 -> stringPublic 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
value je null.
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.
Platí pro
String(SByte*, Int32, Int32)
- Zdroj:
- String.cs
- Zdroj:
- String.cs
- 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)]
[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 -> stringParametry
- 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
Výjimky
value je null.
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á.
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.
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.
Platí pro
String(SByte*, Int32, Int32, Encoding)
- Zdroj:
- String.cs
- Zdroj:
- String.cs
- Zdroj:
- String.cs
Důležité
Toto rozhraní API neodpovídá specifikaci CLS.
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 -> stringParametry
- 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
Výjimky
value je null.
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á.
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.
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.
