String Konstruktorer

Definition

Namnområde:
System
Sammansättningar:
mscorlib.dll, System.Runtime.dll
Sammansättningar:
netstandard.dll, System.Runtime.dll
Sammansättning:
System.Runtime.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Initierar en ny instans av String klassen.

Överlagringar

Name Description
String(Char*)

Initierar en ny instans av String klassen till det värde som anges av en angiven pekare till en matris med Unicode-tecken.
String(Char[])

Initierar en ny instans av String klassen till de Unicode-tecken som anges i den angivna teckenmatrisen.
String(ReadOnlySpan<Char>)

Initierar en ny instans av String klassen till de Unicode-tecken som anges i det angivna skrivskyddade intervallet.
String(SByte*)

Initierar en ny instans av String klassen till det värde som anges av en pekare till en matris med 8-bitars signerade heltal.
String(Char, Int32)

Initierar en ny instans av String klassen till det värde som anges av ett angivet Unicode-tecken som upprepas ett angivet antal gånger.
String(Char*, Int32, Int32)

Initierar en ny instans av String klassen till det värde som anges av en angiven pekare till en matris med Unicode-tecken, en startteckenposition inom matrisen och en längd.
String(Char[], Int32, Int32)

Initierar en ny instans av klassen till det värde som anges av en matris med Unicode-tecken, en startteckenposition i matrisen String och en längd.
String(SByte*, Int32, Int32)

Initierar en ny instans av String klassen till det värde som anges av en angiven pekare till en matris med 8-bitars signerade heltal, en startposition inom matrisen och en längd.
String(SByte*, Int32, Int32, Encoding)

Initierar en ny instans av String klassen till det värde som anges av en angiven pekare till en matris med 8-bitars signerade heltal, en startposition inom matrisen, en längd och ett Encoding objekt.

Kommentarer

Mer information om det här API:et finns i Kompletterande API-kommentarer för Strängkonstruktor.

String(Char*)

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Viktigt!

Detta API uppfyller inte CLS.

Initierar en ny instans av String klassen till det värde som anges av en angiven pekare till en matris med Unicode-tecken.

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

Parametrar

value
Char*

En pekare till en null-avslutad matris med Unicode-tecken.

Attribut
CLSCompliantAttribute SecurityCriticalAttribute

Undantag

ArgumentOutOfRangeException

Den aktuella processen har inte läsbehörighet till alla adresserade tecken.

ArgumentException

value anger en matris som innehåller ett ogiltigt Unicode-tecken eller value anger en adress som är mindre än 64000.

Kommentarer

Note

Exempel och omfattande användningsinformation om den här och andra String konstruktoröverlagringar finns i konstruktorsammanfattningen String .

Gäller för

String(Char[])

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Initierar en ny instans av String klassen till de Unicode-tecken som anges i den angivna teckenmatrisen.

public:
 String(cli::array <char> ^ value);
public String(char[] value);
public String(char[]? value);
new string : char[] -> string
Public Sub New (value As Char())

Parametrar

value
Char[]

En matris med Unicode-tecken.

Kommentarer

Note

Exempel och omfattande användningsinformation om den här och andra String konstruktoröverlagringar finns i konstruktorsammanfattningen String .

Gäller för

String(ReadOnlySpan<Char>)

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Initierar en ny instans av String klassen till de Unicode-tecken som anges i det angivna skrivskyddade intervallet.

public:
 String(ReadOnlySpan<char> value);
public String(ReadOnlySpan<char> value);
new string : ReadOnlySpan<char> -> string
Public Sub New (value As ReadOnlySpan(Of Char))

Parametrar

value
ReadOnlySpan<Char>

Ett skrivskyddat intervall med Unicode-tecken.

Gäller för

String(SByte*)

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Viktigt!

Detta API uppfyller inte CLS.

Initierar en ny instans av String klassen till det värde som anges av en pekare till en matris med 8-bitars signerade heltal.

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

Parametrar

value
SByte*

En pekare till en null-avslutad matris med 8-bitars signerade heltal. Heltalen tolkas med hjälp av den aktuella systemkodningssidan på Windows (kallas CP_ACP) och UTF-8-kodning på icke-Windows.

Attribut
CLSCompliantAttribute SecurityCriticalAttribute

Undantag

ArgumentNullException

value är null.

ArgumentException

Det gick inte att initiera en ny instans av String med , valueförutsatt att value den är kodad i ANSI.

ArgumentOutOfRangeException

Längden på den nya strängen som ska initieras, vilket bestäms av null-avslutningstecknet valueför , är för stor för att allokera.

AccessViolationException

value anger en ogiltig adress.

Kommentarer

Note

Exempel och omfattande användningsinformation om den här och andra String konstruktoröverlagringar finns i konstruktorsammanfattningen String .

Gäller för

String(Char, Int32)

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Initierar en ny instans av String klassen till det värde som anges av ett angivet Unicode-tecken som upprepas ett angivet antal gånger.

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)

Parametrar

c
Char

Ett Unicode-tecken.

count
Int32

Antalet gånger c inträffar.

Undantag

ArgumentOutOfRangeException

count är mindre än noll.

Kommentarer

Note

Exempel och omfattande användningsinformation om den här och andra String konstruktoröverlagringar finns i konstruktorsammanfattningen String .

Gäller för

String(Char*, Int32, Int32)

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Viktigt!

Detta API uppfyller inte CLS.

Initierar en ny instans av String klassen till det värde som anges av en angiven pekare till en matris med Unicode-tecken, en startteckenposition inom matrisen och en längd.

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

Parametrar

value
Char*

En pekare till en matris med Unicode-tecken.

startIndex
Int32

Startpositionen inom value.

length
Int32

Antalet tecken i value som ska användas.

Attribut
CLSCompliantAttribute SecurityCriticalAttribute

Undantag

ArgumentOutOfRangeException

startIndex eller length är mindre än noll, value + startIndex orsakar ett pekarspill eller så har den aktuella processen inte läsåtkomst till alla adresserade tecken.

ArgumentException

value anger en matris som innehåller ett ogiltigt Unicode-tecken eller value + startIndex anger en adress som är mindre än 64000.

Kommentarer

Note

Exempel och omfattande användningsinformation om den här och andra String konstruktoröverlagringar finns i konstruktorsammanfattningen String .

Gäller för

String(Char[], Int32, Int32)

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Initierar en ny instans av klassen till det värde som anges av en matris med Unicode-tecken, en startteckenposition i matrisen String och en längd.

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)

Parametrar

value
Char[]

En matris med Unicode-tecken.

startIndex
Int32

Startpositionen inom value.

length
Int32

Antalet tecken i value som ska användas.

Undantag

ArgumentNullException

value är null.

ArgumentOutOfRangeException

startIndex eller length är mindre än noll.

-eller-

Summan av startIndex och length är större än antalet element i value.

Kommentarer

Note

Exempel och omfattande användningsinformation om den här och andra String konstruktoröverlagringar finns i konstruktorsammanfattningen String .

Gäller för

String(SByte*, Int32, Int32)

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Viktigt!

Detta API uppfyller inte CLS.

Initierar en ny instans av String klassen till det värde som anges av en angiven pekare till en matris med 8-bitars signerade heltal, en startposition inom matrisen och en längd.

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

Parametrar

value
SByte*

En pekare till en matris med 8-bitars signerade heltal. Heltalen tolkas med hjälp av den aktuella systemkodningssidan på Windows (kallas CP_ACP) och UTF-8-kodning på icke-Windows.

startIndex
Int32

Startpositionen inom value.

length
Int32

Antalet sbyte inom value som ska användas.

Attribut
CLSCompliantAttribute SecurityCriticalAttribute

Undantag

ArgumentNullException

value är null.

ArgumentOutOfRangeException

startIndex eller length är mindre än noll.

-eller-

Adressen som anges av value + startIndex är för stor för den aktuella plattformen, dvs. adressberäkningen flödade över.

-eller-

Längden på den nya strängen för att initiera är för stor för att allokera.

ArgumentException

Adressen som anges av value + startIndex är mindre än 64 K.

-eller-

Det gick inte att initiera en ny instans av String med , valueförutsatt att value den är kodad i ANSI.

AccessViolationException

value, startIndexoch length anger tillsammans en ogiltig adress.

Kommentarer

Note

Exempel och omfattande användningsinformation om den här och andra String konstruktoröverlagringar finns i konstruktorsammanfattningen String .

Gäller för

String(SByte*, Int32, Int32, Encoding)

Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs
Källa:
String.cs

Viktigt!

Detta API uppfyller inte CLS.

Initierar en ny instans av String klassen till det värde som anges av en angiven pekare till en matris med 8-bitars signerade heltal, en startposition inom matrisen, en längd och ett 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)]
[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

Parametrar

value
SByte*

En pekare till en matris med 8-bitars signerade heltal.

startIndex
Int32

Startpositionen inom value.

length
Int32

Antalet sbyte inom value som ska användas.

enc
Encoding

Ett objekt som anger hur matrisen som refereras av value kodas. Om enc är nullantas ANSI-kodning.

Attribut
CLSCompliantAttribute SecurityCriticalAttribute

Undantag

ArgumentNullException

value är null.

ArgumentOutOfRangeException

startIndex eller length är mindre än noll.

-eller-

Adressen som anges av value + startIndex är för stor för den aktuella plattformen, dvs. adressberäkningen flödade över.

-eller-

Längden på den nya strängen för att initiera är för stor för att allokera.

ArgumentException

Adressen som anges av value + startIndex är mindre än 64 K.

-eller-

Det gick inte att initiera en ny instans av String med , valueförutsatt att value kodas enligt .enc

AccessViolationException

value, startIndexoch length anger tillsammans en ogiltig adress.

Kommentarer

Note

Exempel och omfattande användningsinformation om den här och andra String konstruktoröverlagringar finns i konstruktorsammanfattningen String .

Gäller för