String.Length プロパティ

public:
 property int Length { int get(); };

public int Length { get; }

member this.Length : int

Public ReadOnly Property Length As Integer

プロパティ値

Int32

現在の文字列の文字数。The number of characters in the current string.

例

Lengthプロパティの例を次に示します。The following example demonstrates the Length property.

// Sample for String::Length
using namespace System;
int main()
{
   String^ str = "abcdefg";
   Console::WriteLine( "1) The length of '{0}' is {1}", str, str->Length );
   Console::WriteLine( "2) The length of '{0}' is {1}", "xyz", ((String^)"xyz")->Length );
   int length = str->Length;
   Console::WriteLine( "1) The length of '{0}' is {1}", str, length );
}

/*
This example displays the following output:
   1) The length of 'abcdefg' is 7
   2) The length of 'xyz' is 3
   3) The length of 'abcdefg' is 7
*/

string str = "abcdefg";
Console.WriteLine("1) The length of '{0}' is {1}", str, str.Length);
Console.WriteLine("2) The length of '{0}' is {1}", "xyz", "xyz".Length);

int length = str.Length;
Console.WriteLine("3) The length of '{0}' is {1}", str, length);

// This example displays the following output:
//    1) The length of 'abcdefg' is 7
//    2) The length of 'xyz' is 3
//    3) The length of 'abcdefg' is 7

Class Sample
   Public Shared Sub Main()
      Dim str As String = "abcdefg"
      Console.WriteLine("1) The length of '{0}' is {1}", str, str.Length)
      Console.WriteLine("2) The length of '{0}' is {1}", "xyz", "xyz".Length)
      Dim length As Integer = str.Length
      Console.WriteLine("1) The length of '{0}' is {1}", str, length)
   End Sub
End Class
'
'This example displays the following output:
'    1) The length of 'abcdefg' is 7
'    2) The length of 'xyz' is 3
'    3) The length of 'abcdefg' is 7

注釈

プロパティは、 Length Char Unicode 文字の数ではなく、このインスタンス内のオブジェクトの数を返します。The Length property returns the number of Char objects in this instance, not the number of Unicode characters. これは、Unicode 文字が複数の文字で表される可能性があるためです Char 。The reason is that a Unicode character might be represented by more than one Char. クラスを使用し System.Globalization.StringInfo て、各 Unicode 文字ではなくを操作し Char ます。Use the System.Globalization.StringInfo class to work with each Unicode character instead of each Char.

C や C++ などの一部の言語では、null 文字は文字列の末尾を示します。In some languages, such as C and C++, a null character indicates the end of a string. .NET では、null 文字を文字列に埋め込むことができます。In .NET, a null character can be embedded in a string. 文字列に1つ以上の null 文字が含まれている場合は、文字列全体の長さに含まれます。When a string includes one or more null characters, they are included in the length of the total string. たとえば、次の文字列では、部分文字列 "abc" と "def" が null 文字で区切られています。For example, in the following string, the substrings "abc" and "def" are separated by a null character. Lengthプロパティは7を返します。これは、6つの英字と null 文字が含まれていることを示します。The Length property returns 7, which indicates that it includes the six alphabetic characters as well as the null character.

using namespace System;
using namespace System::Text;

void main()
{
   String^ characters = "abc" + L'0' + "def";
   Console::WriteLine(characters->Length);        // Displays 7
}

string characters = "abc\u0000def";
Console.WriteLine(characters.Length); // Displays 7

Imports System.Text

Module Example

   Public Sub Main()
      Dim characters As String = "abc" + ChrW(0) + "def"
      Console.WriteLine(characters.Length)       ' Displays 7
   End Sub
End Module

適用対象

こちらもご覧ください

• Int32