String コンストラクター

定義

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*)

重要

この 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 で終わる配列へのポインター。

属性

例外

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

value が正しくない Unicode 文字を含む配列を指定しているか、value が 64000 未満のアドレスを指定しています。

注釈

注意

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

適用対象

String(Char[])

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 クラスの新しいインスタンスを、指定した読み取り専用スパンで示された 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*)

重要

この 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*

終端が null の 8 ビット符号付き整数の配列へのポインター。 整数は、現在のシステム コード ページ エンコーディング (つまり、Default が指定したエンコーディング) を使用して解釈されます。

属性

例外

valuenullです。

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

value の Null 終端文字によって決定される初期化する新しい文字列の長さが、大きすぎて割り当てられません。

value に指定されたアドレスが正しくありません。

注釈

注意

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

適用対象

String(Char, Int32)

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 の発生回数。

例外

count が 0 未満です。

注釈

注意

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

適用対象

String(Char*, Int32, Int32)

重要

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

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

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 内の文字数。

属性

例外

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

value が正しくない Unicode 文字を含む配列を指定しているか、value + startIndex が 64000 未満のアドレスを指定しています。

注釈

注意

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

適用対象

String(Char[], Int32, Int32)

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 内の文字数。

例外

valuenull です。

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

または

startIndexlength の合計が、value にある要素の数を超えています。

注釈

注意

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

適用対象

String(SByte*, Int32, Int32)

重要

この 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 ビット符号付き整数の配列へのポインター。 整数は、現在のシステム コード ページ エンコーディング (つまり、Default が指定したエンコーディング) を使用して解釈されます。

startIndex
Int32

value 内の開始位置。

length
Int32

使用する value 内の文字数。

属性

例外

valuenull です。

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

または

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

または

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

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

または

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

valuestartIndexlength 全体で、正しくないアドレスを指定しています。

注釈

注意

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

適用対象

String(SByte*, Int32, Int32, Encoding)

重要

この 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)]
[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 が参照する配列のエンコード方法を指定するオブジェクト。 encnull の場合は、ANSI エンコーディングが指定されていると見なされます。

属性

例外

valuenull です。

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

または

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

または

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

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

または

String の新しいインスタンスを、value を使用して初期化できませんでした。valueenc の指定に従ってエンコードされていると想定しています。

valuestartIndexlength 全体で、正しくないアドレスを指定しています。

注釈

注意

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

適用対象