String クラスの新しいインスタンスを初期化し、Unicode 文字の配列を指す指定のポインタ、配列内の開始文字位置、および長さにより示される値に設定します。
このコンストラクタは、CLS に準拠していません。
名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文
'宣言
Visual Basic は、安全でない型を使用したり戻したりする API をサポートしません。
'使用
Visual Basic は、安全でない型を使用したり戻したりする API をサポートしません。
[CLSCompliantAttribute(false)]
public String (
char* value,
int startIndex,
int length
)
[CLSCompliantAttribute(false)]
public:
String (
wchar_t* value,
int startIndex,
int length
)
J# は、安全でない型を使用したり戻したりする API をサポートしません。
JScript は、安全でない型を使用したり戻したりする API をサポートしません。
パラメータ
- value
Unicode 文字の配列を指すポインタ。
- startIndex
value 内の開始位置。
- length
使用する value 内の文字数。
例外
| 例外の種類 | 条件 |
|---|---|
startIndex または length が 0 より小さいか、value + startIndex によってポインタ オーバーフローが発生するか、または現在のプロセスがアドレス指定する文字すべてのアクセス権を持っていません。 |
|
value が null 参照 (Visual Basic では Nothing) です。 |
|
value が 無効な Unicode 文字を含む配列を指定しているか、 value + startIndex が 64000 よりも小さいアドレスを指定しています。 |
解説
length が 0 の場合は、Empty インスタンスが初期化されます。
このコンストラクタは value の startIndex から (startIndex + length - 1) までの Unicode 文字をコピーします。
指定した範囲が、この一連の文字に割り当てられたメモリの外部にある場合、このコンストラクタの動作はシステムに依存します。たとえば、このような状況は、アクセス違反の原因となる可能性があります。
C# では、このコンストラクタはアンセーフ コードのコンテキストだけで定義されます。
プラットフォーム
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0