String コンストラクター

  • リファレンス

定義

名前空間:
System
アセンブリ:
System.Runtime.dll
アセンブリ:
mscorlib.dll
アセンブリ:
netstandard.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)

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 コンストラクターの概要を参照してください。

適用対象

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 文字の配列。

注釈

手記

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

適用対象

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

適用対象

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 無効なアドレスを指定します。

注釈

手記

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

適用対象

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

注釈

手記

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

適用対象

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 未満のアドレスを指定します。

注釈

手記

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

適用対象

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内の要素の数を超えています。

注釈

手記

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

適用対象

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 は、一括して無効なアドレスを指定します。

注釈

手記

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

適用対象

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 は、一括して無効なアドレスを指定します。

注釈

手記

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

適用対象