String.Chars プロパティ

このインスタンス内の指定した文字位置の文字を取得します。

[C#] C# では、このプロパティは String クラスのインデクサになります。

Public Default ReadOnly Property Chars( _
   ByVal index As Integer _) As Char
[C#]
public char this[intindex] {get;}
[C++]
public: __property __wchar_t get_Chars(intindex);
[JScript]
returnValue = StringObject.Chars(index);またはreturnValue = StringObject(index);

[JScript] JScript では、この型で定義されている既定のインデックス プロパティを使用することができます。しかし、独自のインデックス プロパティを明示的に定義することはできません。ただし、このクラスの expando 属性を指定すると、既定のインデックス プロパティが提供されます。提供されるインデックス プロパティの型は Object 型であり、インデックス型は String になります。

引数 [JScript]

• index
  このインスタンス内の文字位置。

パラメータ [Visual Basic, C#, C++]

• index
  このインスタンス内の文字位置。

プロパティ値

Unicode 文字。

例外

例外の種類	条件
IndexOutOfRangeException	index が、このオブジェクトの長さ以上であるか、または 0 未満です。

解説

index パラメータは、インデックス番号が 0 から始まります。

このプロパティは、 index パラメータで指定された位置の Char を返します。ただし、1 つの Unicode 文字が 1 つ以上の Char で表されることがあります。おのおのの Char ではなくおのおのの Unicode 文字を対象に処理を行うには、 System.Globalization.StringInfo クラスを使用します。

使用例

[Visual Basic, C#, C++] 文字列を検証するルーチンでこのインデクサを使用する方法については、次のコード例を参照してください。

 
Console.Write("Type a string : ")
Dim myString As String = Console.ReadLine()
Dim i As Integer
For i = 0 To myString.Length - 1
   If Uri.IsHexDigit(myString.Chars(i)) Then
      Console.WriteLine("{0} is a hexadecimal digit.", myString.Chars(i))
   Else
      Console.WriteLine("{0} is not a hexadecimal digit.", myString.Chars(i))
   End If 

[C#] 
Console.Write("Type a string : ");
string myString = Console.ReadLine();
for (int i = 0; i < myString.Length; i ++)
if(Uri.IsHexDigit(myString[i]))
       Console.WriteLine("{0} is a hexadecimal digit.", myString[i]); 
else
   Console.WriteLine("{0} is not a hexadecimal digit.", myString[i]); 

[C++] 
Console::Write(S"Type a string : ");
String* myString = Console::ReadLine();
for (int i = 0; i < myString->Length; i ++)
    if(Uri::IsHexDigit(myString->Chars[i]))
        Console::WriteLine(S"{0} is a hexadecimal digit.", __box(myString->Chars[i])); 
    else
        Console::WriteLine(S"{0} is not a hexadecimal digit.", __box(myString->Chars[i])); 

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, Common Language Infrastructure (CLI) Standard

参照

String クラス | String メンバ | System 名前空間 | Char | GetEnumerator | Int32