String コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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) |
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
- ソース:
- 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 で終わる配列へのポインター。
- 属性
例外
現在のプロセスは、アドレス指定されたすべての文字に対する読み取りアクセス権を持っているわけではありません。
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*
終端が null の 8 ビット符号付き整数の配列へのポインター。 整数は、現在のシステム コード ページ エンコーディング (つまり、Default が指定したエンコーディング) を使用して解釈されます。
- 属性
例外
value
が null
です。
String の新しいインスタンス を、value
を使用して初期化できませんでした。value
が ANSI でエンコードされていると想定しています。
value
の Null 終端文字によって決定される初期化する新しい文字列の長さが、大きすぎて割り当てられません。
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
の発生回数。
例外
count
が 0 未満です。
注釈
注意
このオーバーロードとその他 String
のコンストラクター オーバーロードの例と包括的な使用方法については、コンストラクターの概要に関するページを String 参照してください。
適用対象
String(Char*, Int32, Int32)
- ソース:
- String.cs
- ソース:
- String.cs
- ソース:
- String.cs
重要
この 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.cs
- ソース:
- String.cs
- ソース:
- 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
内の文字数。
例外
value
は null
です。
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 ビット符号付き整数の配列へのポインター。 整数は、現在のシステム コード ページ エンコーディング (つまり、Default が指定したエンコーディング) を使用して解釈されます。
- startIndex
- Int32
value
内の開始位置。
- length
- Int32
使用する value
内の文字数。
- 属性
例外
value
は null
です。
startIndex
または length
が 0 未満です。
または
value
+ startIndex
で指定されたアドレスが現在のプラットフォームにとって大きすぎて、アドレス計算がオーバーフローしました。
または
初期化する新しい文字列の長さが大きすぎて割り当てられません。
value
+ startIndex
で指定されるアドレスは 64 K 未満です。
または
String の新しいインスタンスを、value
を使用して初期化できませんでした (value
が ANSI でエンコードされていると想定)。
value
、startIndex
、length
全体で、正しくないアドレスを指定しています。
注釈
注意
このオーバーロードとその他 String
のコンストラクター オーバーロードの例と包括的な使用方法については、コンストラクターの概要に関するページを String 参照してください。
適用対象
String(SByte*, Int32, Int32, Encoding)
- ソース:
- String.cs
- ソース:
- String.cs
- ソース:
- String.cs
重要
この API は CLS 準拠ではありません。
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 エンコーディングが指定されていると見なされます。
- 属性
例外
value
は null
です。
startIndex
または length
が 0 未満です。
または
value
+ startIndex
で指定されたアドレスが現在のプラットフォームにとって大きすぎて、アドレス計算がオーバーフローしました。
または
初期化する新しい文字列の長さが大きすぎて割り当てられません。
value
+ startIndex
で指定されるアドレスは 64 K 未満です。
または
String の新しいインスタンスを、value
を使用して初期化できませんでした。value
が enc
の指定に従ってエンコードされていると想定しています。
value
、startIndex
、length
全体で、正しくないアドレスを指定しています。
注釈
注意
このオーバーロードとその他 String
のコンストラクター オーバーロードの例と包括的な使用方法については、コンストラクターの概要に関するページを String 参照してください。
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示