String.Length String.Length String.Length String.Length Property

定義

現在の String オブジェクト内の文字数を取得します。Gets the number of characters in the current String object.

public:
 property int Length { int get(); };
public int Length { get; }
member this.Length : int
Public ReadOnly Property Length As Integer

プロパティ値

現在の文字列の文字数。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は、Unicode 文字のChar数ではなく、このインスタンス内のオブジェクトの数を返します。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使用して、各CharUnicode 文字ではなくを操作します。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

適用対象

こちらもご覧ください