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 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*)
- 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 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> -> string
Parametry
- value
- Char*
Ukazatel na pole znaků Unicode ukončené 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 tomto a dalších String
přetíženích 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 poli znaků.
public:
String(cli::array <char> ^ value);
public String (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 .
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> -> string
Public 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ých celých čísel se znaménkem.
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> -> 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
Výjimky
value
je null
.
Novou instanci objektu String nelze inicializovat pomocí value
, za předpokladu, že value
je zakódovaná v ANSI.
Délka nového řetězce k inicializaci, která je určena znakem ukončení null , value
je příliš velká pro přidělení.
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 .
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 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
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 .
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 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)]
[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 -> 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
Výjimky
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ů.
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 .
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 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
value
je null
.
startIndex
nebo length
je menší než nula.
-nebo-
Součet startIndex
hodnot a length
je větší než počet prvků v value
souboru .
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 .
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 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)]
[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 -> 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
Výjimky
value
je null
.
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í.
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.
value
, startIndex
a 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 .
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 -> 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
Výjimky
value
je null
.
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í.
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
.
value
, startIndex
a 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 .
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro