String コンストラクター

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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)	Unicode 文字の配列への指定したポインター、その配列内の開始文字位置、および長さによって示される値に対して、String クラスの新しいインスタンスを初期化します。
String(Char[], Int32, Int32)	Unicode 文字の配列、その配列内の開始文字位置、および長さによって示される値に String クラスの新しいインスタンスを初期化します。
String(SByte*, Int32, Int32)	String クラスの新しいインスタンスを、8 ビット符号付き整数の配列、その配列内の開始位置、および長さの指定したポインターによって示される値に初期化します。
String(SByte*, Int32, Int32, Encoding)	8 ビット符号付き整数の配列、その配列内の開始位置、長さ、および Encoding オブジェクトへの指定したポインターによって示される値に対して、String クラスの新しいインスタンスを初期化します。

注釈

この API の詳細については、「文字列コンストラクターのの補足 API 解説参照してください。

String(Char*)

ソース:: String.cs

ソース:: String.cs

ソース:: String.cs

重要

この API は CLS 準拠ではありません。

String クラスの新しいインスタンスを、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

パラメーター

value: Char*

Unicode 文字の null で終わる配列へのポインター。

属性: CLSCompliantAttribute SecurityCriticalAttribute

例外

ArgumentOutOfRangeException

現在のプロセスには、アドレス指定されたすべての文字に対する読み取りアクセス権がありません。

ArgumentException

value は、無効な Unicode 文字を含む配列を指定するか、value 64000 未満のアドレスを指定します。

注釈

注意

このコンストラクターオーバーロードとその他の String コンストラクターオーバーロードの例と包括的な使用方法については、String コンストラクターの概要を参照してください。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(Char[])

ソース:: String.cs

ソース:: String.cs

ソース:: String.cs

String クラスの新しいインスタンスを、指定した文字配列に示されている Unicode 文字に初期化します。

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

public String (char[] value);

public String (char[]? value);

new string : char[] -> string

Public Sub New (value As Char())

パラメーター

value: Char[]

Unicode 文字の配列。

注釈

注意

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(ReadOnlySpan<Char>)

ソース:: String.cs

ソース:: String.cs

ソース:: 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 文字の読み取り専用スパン。

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard	2.1

String(SByte*)

ソース:: String.cs

ソース:: String.cs

ソース:: String.cs

重要

この API は CLS 準拠ではありません。

String クラスの新しいインスタンスを、8 ビット符号付き整数の配列へのポインターによって示される値に初期化します。

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

パラメーター

value: SByte*

8 ビット符号付き整数の null で終わる配列へのポインター。整数は、Windows 上の現在のシステムコードページエンコード (CP_ACP と呼ばれます) と、Windows 以外の場合は UTF-8 エンコードを使用して解釈されます。

属性: CLSCompliantAttribute SecurityCriticalAttribute

例外

ArgumentNullException

value は nullです。

ArgumentException

value が ANSI でエンコードされていると仮定して、String の新しいインスタンスを valueを使用して初期化できませんでした。

ArgumentOutOfRangeException

初期化する新しい文字列の長さは、valueの null 終了文字によって決まりますが、割り当てには大きすぎます。

AccessViolationException

value 無効なアドレスを指定します。

注釈

注意

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

String(Char, Int32)

ソース:: String.cs

ソース:: String.cs

ソース:: 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 は 0 未満です。

注釈

注意

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(Char*, Int32, Int32)

ソース:: String.cs

ソース:: String.cs

ソース:: String.cs

重要

この API は CLS 準拠ではありません。

Unicode 文字の配列への指定したポインター、その配列内の開始文字位置、および長さによって示される値に対して、String クラスの新しいインスタンスを初期化します。

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

パラメーター

value: Char*

Unicode 文字の配列へのポインター。

startIndex: Int32

value内の開始位置。

length: Int32

使用する value 内の文字数。

属性: CLSCompliantAttribute SecurityCriticalAttribute

例外

ArgumentOutOfRangeException

startIndex または length が 0 未満の場合、ポインターオーバーフローが発生 value + startIndex、または現在のプロセスに、アドレス指定されたすべての文字への読み取りアクセス権がありません。

ArgumentException

value は、無効な Unicode 文字を含む配列を指定するか、value + startIndex 64000 未満のアドレスを指定します。

注釈

注意

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(Char[], Int32, Int32)

ソース:: String.cs

ソース:: String.cs

ソース:: String.cs

Unicode 文字の配列、その配列内の開始文字位置、および長さによって示される値に String クラスの新しいインスタンスを初期化します。

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 が 0 未満です。

-又は-

startIndex と length の合計が、value内の要素の数を超えています。

注釈

注意

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

String(SByte*, Int32, Int32)

ソース:: String.cs

ソース:: String.cs

ソース:: 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)]
[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

パラメーター

value: SByte*

8 ビット符号付き整数の配列へのポインター。整数は、Windows 上の現在のシステムコードページエンコード (CP_ACP と呼ばれます) と、Windows 以外の場合は UTF-8 エンコードを使用して解釈されます。

startIndex: Int32

value内の開始位置。

length: Int32

使用する value 内の文字数。

属性: CLSCompliantAttribute SecurityCriticalAttribute

例外

ArgumentNullException

value は nullです。

ArgumentOutOfRangeException

startIndex または length が 0 未満です。

-又は-

value + startIndex で指定されたアドレスが、現在のプラットフォームでは大きすぎます。つまり、アドレス計算がオーバーフローしました。

-又は-

初期化する新しい文字列の長さが大きすぎて割り当てられません。

ArgumentException

value + startIndex で指定されたアドレスが 64K 未満です。

-又は-

value が ANSI でエンコードされていると仮定して、String の新しいインスタンスを valueを使用して初期化できませんでした。

AccessViolationException

value、startIndex、および length は、一括して無効なアドレスを指定します。

注釈

注意

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

String(SByte*, Int32, Int32, Encoding)

ソース:: String.cs

ソース:: String.cs

ソース:: String.cs

重要

この API は CLS 準拠ではありません。

8 ビット符号付き整数の配列、その配列内の開始位置、長さ、および Encoding オブジェクトへの指定したポインターによって示される値に対して、String クラスの新しいインスタンスを初期化します。

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

パラメーター

value: SByte*

8 ビット符号付き整数の配列へのポインター。

startIndex: Int32

value内の開始位置。

length: Int32

使用する value 内の文字数。

enc: Encoding

value によって参照される配列のエンコード方法を指定するオブジェクト。 enc が nullの場合、ANSI エンコードが想定されます。

属性: CLSCompliantAttribute SecurityCriticalAttribute

例外

ArgumentNullException

value は nullです。

ArgumentOutOfRangeException

startIndex または length が 0 未満です。

-又は-

value + startIndex で指定されたアドレスが、現在のプラットフォームでは大きすぎます。つまり、アドレス計算がオーバーフローしました。

-又は-

初期化する新しい文字列の長さが大きすぎて割り当てられません。

ArgumentException

value + startIndex で指定されたアドレスが 64K 未満です。

-又は-

String の新しいインスタンスを valueを使用して初期化できませんでした。value が encで指定されたとおりにエンコードされていると仮定します。

AccessViolationException

value、startIndex、および length は、一括して無効なアドレスを指定します。

注釈

注意

適用対象

.NET 9 およびその他のバージョン

製品	バージョン
.NET	Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

次の方法で共有

String コンストラクター

定義

オーバーロード

注釈

String(Char*)

パラメーター

例外

注釈

適用対象

String(Char[])

パラメーター

注釈

適用対象

String(ReadOnlySpan<Char>)

パラメーター

適用対象

String(SByte*)

パラメーター

例外

注釈

適用対象

String(Char, Int32)

パラメーター

例外

注釈

適用対象

String(Char*, Int32, Int32)

パラメーター

例外

注釈

適用対象

String(Char[], Int32, Int32)

パラメーター

例外

注釈

適用対象

String(SByte*, Int32, Int32)

パラメーター

例外

注釈

適用対象

String(SByte*, Int32, Int32, Encoding)

パラメーター

例外

注釈

適用対象

その他のリソース