String 建構函式

定義

命名空間:

System

組件:

System.Runtime.dll

初始化 String 類別的新實例。

多載

String(Char*)	將 String 類別的新實例初始化為 Unicode 字元陣列指定指標所指示的值。
String(Char[])	將 String 類別的新實例初始化為指定字元陣列中所指示的 Unicode 字元。
String(ReadOnlySpan<Char>)	將 String 類別的新實例初始化為指定唯讀範圍中所指示的 Unicode 字元。
String(SByte*)	將 String 類別的新實例初始化為 8 位帶正負號整數陣組指標所表示的值。
String(Char, Int32)	將 String 類別的新實例初始化為重複指定次數的指定 Unicode 字元所指示的值。
String(Char*, Int32, Int32)	將 String 類別的新實例初始化為 Unicode 字元陣列的指定指標、該陣列內的起始字元位置，以及長度所指示的值。
String(Char[], Int32, Int32)	將 String 類別的新實例初始化為 Unicode 字元陣列、該陣列內的起始字元位置，以及長度所指示的值。
String(SByte*, Int32, Int32)	將 String 類別的新實例初始化為 8 位帶正負號整數陣列的指定指標所指示的值、該陣列內的起始位置，以及長度。
String(SByte*, Int32, Int32, Encoding)	將 String 類別的新實例初始化為8位帶正負號整數陣列的指定指標所指示的值、陣列內的起始位置、長度和 Encoding 物件。

備註

如需此 API 的詳細資訊，請參閱 String 建構函式的補充 API 備註。

String(Char*)

來源:

String.cs

重要

此 API 不符合 CLS 規範。

將 String 類別的新實例初始化為 Unicode 字元陣列指定指標所指示的值。

public:
 String(char* value);

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

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

參數

value

Char*

Unicode 字元之 Null 終止數位的指標。

屬性

CLSCompliantAttribute

例外狀況

ArgumentOutOfRangeException

目前進程沒有所有尋址字元的讀取許可權。

ArgumentException

value 指定包含無效 Unicode 字元的陣列，或 value 指定小於 64000 的位址。

備註

注意

如需此建構函式和其他 String 建構函式多載的範例和完整的使用資訊，請參閱 String 建構函式摘要。

String(Char[])

來源:

String.cs

將 String 類別的新實例初始化為指定字元陣列中所指示的 Unicode 字元。

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

public String (char[]? value);

new string : char[] -> string

Public Sub New (value As Char())

參數

value

Char[]

Unicode 字元的陣列。

備註

注意

如需此建構函式和其他 String 建構函式多載的範例和完整的使用資訊，請參閱 String 建構函式摘要。

String(ReadOnlySpan<Char>)

來源:

String.cs

將 String 類別的新實例初始化為指定唯讀範圍中所指示的 Unicode 字元。

public:
 String(ReadOnlySpan<char> value);

public String (ReadOnlySpan<char> value);

new string : ReadOnlySpan<char> -> string

Public Sub New (value As ReadOnlySpan(Of Char))

參數

value

ReadOnlySpan<Char>

Unicode 字元的唯讀範圍。

String(SByte*)

來源:

String.cs

重要

此 API 不符合 CLS 規範。

將 String 類別的新實例初始化為 8 位帶正負號整數陣組指標所表示的值。

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

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

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

參數

value

SByte*

以 Null 結束的 8 位帶正負號整數陣列的指標。 整數會使用 Windows 上目前的系統代碼頁編碼來解譯（稱為CP_ACP），以及非 Windows 上的 UTF-8 編碼。

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

value null。

ArgumentException

String 的新實例無法使用 value初始化，假設 value 是以 ANSI 編碼。

ArgumentOutOfRangeException

要初始化的新字串長度，由 value的 null 終止字元所決定，太大而無法配置。

AccessViolationException

value 指定無效的位址。

備註

注意

如需此建構函式和其他 String 建構函式多載的範例和完整的使用資訊，請參閱 String 建構函式摘要。

String(Char, Int32)

來源:

String.cs

將 String 類別的新實例初始化為重複指定次數的指定 Unicode 字元所指示的值。

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)

參數

c

Char

Unicode 字元。

count

Int32

發生 c 的次數。

例外狀況

ArgumentOutOfRangeException

count 小於零。

備註

注意

如需此建構函式和其他 String 建構函式多載的範例和完整的使用資訊，請參閱 String 建構函式摘要。

String(Char*, Int32, Int32)

來源:

String.cs

重要

此 API 不符合 CLS 規範。

將 String 類別的新實例初始化為 Unicode 字元陣列的指定指標、該陣列內的起始字元位置，以及長度所指示的值。

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

參數

value

Char*

Unicode 字元陣列的指標。

startIndex

Int32

value內的起始位置。

length

Int32

要使用的 value 字元數。

屬性

CLSCompliantAttribute

例外狀況

ArgumentOutOfRangeException

startIndex 或 length 小於零、value + startIndex 造成指標溢位，或目前進程沒有所有尋址字元的讀取許可權。

ArgumentException

value 指定包含無效 Unicode 字元的陣列，或 value + startIndex 指定小於 64000 的位址。

備註

注意

如需此建構函式和其他 String 建構函式多載的範例和完整的使用資訊，請參閱 String 建構函式摘要。

String(Char[], Int32, Int32)

來源:

String.cs

將 String 類別的新實例初始化為 Unicode 字元陣列、該陣列內的起始字元位置，以及長度所指示的值。

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)

參數

value

Char[]

Unicode 字元的陣列。

startIndex

Int32

value內的起始位置。

length

Int32

要使用的 value 字元數。

例外狀況

ArgumentNullException

value null。

ArgumentOutOfRangeException

startIndex 或 length 小於零。

-或-

startIndex 和 length 的總和大於 value中的項目數目。

備註

注意

如需此建構函式和其他 String 建構函式多載的範例和完整的使用資訊，請參閱 String 建構函式摘要。

String(SByte*, Int32, Int32)

來源:

String.cs

重要

此 API 不符合 CLS 規範。

將 String 類別的新實例初始化為 8 位帶正負號整數陣列的指定指標所指示的值、該陣列內的起始位置，以及長度。

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

參數

value

SByte*

8 位帶正負號整數數位的指標。 整數會使用 Windows 上目前的系統代碼頁編碼來解譯（稱為CP_ACP），以及非 Windows 上的 UTF-8 編碼。

startIndex

Int32

value內的起始位置。

length

Int32

要使用的 value 字元數。

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

value null。

ArgumentOutOfRangeException

startIndex 或 length 小於零。

-或-

value + startIndex 指定的位址對目前平臺而言太大;也就是地址計算溢位。

-或-

要初始化的新字串長度太大而無法配置。

ArgumentException

value + startIndex 指定的位址小於 64K。

-或-

String 的新實例無法使用 value初始化，假設 value 是以 ANSI 編碼。

AccessViolationException

value、startIndex和 length 會共同指定無效的位址。

備註

注意

如需此建構函式和其他 String 建構函式多載的範例和完整的使用資訊，請參閱 String 建構函式摘要。

String(SByte*, Int32, Int32, Encoding)

來源:

String.cs

重要

此 API 不符合 CLS 規範。

將 String 類別的新實例初始化為8位帶正負號整數陣列的指定指標所指示的值、陣列內的起始位置、長度和 Encoding 物件。

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

參數

value

SByte*

8 位帶正負號整數數位的指標。

startIndex

Int32

value內的起始位置。

length

Int32

要使用的 value 字元數。

enc

Encoding

物件，指定如何編碼 value 所參考的陣列。 如果 encnull，則會假設 ANSI 編碼方式。

屬性

CLSCompliantAttribute

例外狀況

ArgumentNullException

value null。

ArgumentOutOfRangeException

startIndex 或 length 小於零。

-或-

value + startIndex 指定的位址對目前平臺而言太大;也就是地址計算溢位。

-或-

要初始化的新字串長度太大而無法配置。

ArgumentException

value + startIndex 指定的位址小於 64K。

-或-

使用 value無法初始化 String 的新實例，假設 value 編碼為 enc所指定。

AccessViolationException

value、startIndex和 length 會共同指定無效的位址。

備註

注意

如需此建構函式和其他 String 建構函式多載的範例和完整的使用資訊，請參閱 String 建構函式摘要。