Console.Read メソッド

定義

標準入力ストリームから次の文字を読み取ります。

public:
 static int Read();
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static int Read ();
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
public static int Read ();
public static int Read ();
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
static member Read : unit -> int
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("android")>]
static member Read : unit -> int
static member Read : unit -> int
Public Shared Function Read () As Integer

戻り値

Int32

入力ストリームの次の文字。または次の文字がない場合は -1。

属性

例外

I/O エラーが発生しました。

Readメソッドの例を次に示します。

// This example demonstrates the Console.Read() method.
using namespace System;
int main()
{
   String^ m1 = "\nType a string of text then press Enter. "
   "Type '+' anywhere in the text to quit:\n";
   String^ m2 = "Character '{0}' is hexadecimal 0x{1:x4}.";
   String^ m3 = "Character     is hexadecimal 0x{0:x4}.";
   Char ch;
   int x;
   
   //
   Console::WriteLine( m1 );
   do
   {
      x = Console::Read();
      try
      {
         ch = Convert::ToChar( x );
         if ( Char::IsWhiteSpace( ch ) )
         {
            Console::WriteLine( m3, x );
            if ( ch == 0x0a )
                        Console::WriteLine( m1 );
         }
         else
                  Console::WriteLine( m2, ch, x );
      }
      catch ( OverflowException^ e ) 
      {
         Console::WriteLine( "{0} Value read = {1}.", e->Message, x );
         ch = Char::MinValue;
         Console::WriteLine( m1 );
      }

   }
   while ( ch != '+' );
}

/*
This example produces the following results:

Type a string of text then press Enter. Type '+' anywhere in the text to quit:

The quick brown fox.
Character 'T' is hexadecimal 0x0054.
Character 'h' is hexadecimal 0x0068.
Character 'e' is hexadecimal 0x0065.
Character     is hexadecimal 0x0020.
Character 'q' is hexadecimal 0x0071.
Character 'u' is hexadecimal 0x0075.
Character 'i' is hexadecimal 0x0069.
Character 'c' is hexadecimal 0x0063.
Character 'k' is hexadecimal 0x006b.
Character     is hexadecimal 0x0020.
Character 'b' is hexadecimal 0x0062.
Character 'r' is hexadecimal 0x0072.
Character 'o' is hexadecimal 0x006f.
Character 'w' is hexadecimal 0x0077.
Character 'n' is hexadecimal 0x006e.
Character     is hexadecimal 0x0020.
Character 'f' is hexadecimal 0x0066.
Character 'o' is hexadecimal 0x006f.
Character 'x' is hexadecimal 0x0078.
Character '.' is hexadecimal 0x002e.
Character     is hexadecimal 0x000d.
Character     is hexadecimal 0x000a.

Type a string of text then press Enter. Type '+' anywhere in the text to quit:

^Z
Value was either too large or too small for a character. Value read = -1.

Type a string of text then press Enter. Type '+' anywhere in the text to quit:

+
Character '+' is hexadecimal 0x002b.

*/
// This example demonstrates the Console.Read() method.
using System;

class Sample
{
    public static void Main()
    {
    string m1 = "\nType a string of text then press Enter. " +
                "Type '+' anywhere in the text to quit:\n";
    string m2 = "Character '{0}' is hexadecimal 0x{1:x4}.";
    string m3 = "Character     is hexadecimal 0x{0:x4}.";
    char ch;
    int x;
//
    Console.WriteLine(m1);
    do
        {
        x = Console.Read();
        try
            {
            ch = Convert.ToChar(x);
            if (Char.IsWhiteSpace(ch))
               {
               Console.WriteLine(m3, x);
               if (ch == 0x0a)
                   Console.WriteLine(m1);
               }
            else
                {
                    Console.WriteLine(m2, ch, x);
                }
            }
        catch (OverflowException e)
            {
            Console.WriteLine("{0} Value read = {1}.", e.Message, x);
            ch = Char.MinValue;
            Console.WriteLine(m1);
            }
        } while (ch != '+');
    }
}
/*
This example produces the following results:

Type a string of text then press Enter. Type '+' anywhere in the text to quit:

The quick brown fox.
Character 'T' is hexadecimal 0x0054.
Character 'h' is hexadecimal 0x0068.
Character 'e' is hexadecimal 0x0065.
Character     is hexadecimal 0x0020.
Character 'q' is hexadecimal 0x0071.
Character 'u' is hexadecimal 0x0075.
Character 'i' is hexadecimal 0x0069.
Character 'c' is hexadecimal 0x0063.
Character 'k' is hexadecimal 0x006b.
Character     is hexadecimal 0x0020.
Character 'b' is hexadecimal 0x0062.
Character 'r' is hexadecimal 0x0072.
Character 'o' is hexadecimal 0x006f.
Character 'w' is hexadecimal 0x0077.
Character 'n' is hexadecimal 0x006e.
Character     is hexadecimal 0x0020.
Character 'f' is hexadecimal 0x0066.
Character 'o' is hexadecimal 0x006f.
Character 'x' is hexadecimal 0x0078.
Character '.' is hexadecimal 0x002e.
Character     is hexadecimal 0x000d.
Character     is hexadecimal 0x000a.

Type a string of text then press Enter. Type '+' anywhere in the text to quit:

^Z
Value was either too large or too small for a character. Value read = -1.

Type a string of text then press Enter. Type '+' anywhere in the text to quit:

+
Character '+' is hexadecimal 0x002b.

*/
' This example demonstrates the Console.Read() method.
Class Sample
   Public Shared Sub Main()
      Dim m1 As String = _
                vbCrLf & _
                "Type a string of text then press Enter. " & _
                "Type '+' anywhere in the text to quit:" & _
                vbCrLf
      Dim m2 As String = "Character '{0}' is hexadecimal 0x{1:x4}."
      Dim m3 As String = "Character     is hexadecimal 0x{0:x4}."
      Dim ch As Char
      Dim x As Integer
      '
      Console.WriteLine(m1)
      Do
         x = Console.Read()
         Try
            ch = Convert.ToChar(x)
            If Char.IsWhiteSpace(ch) Then
               Console.WriteLine(m3, x)
               If ch = vbLf Then
                  Console.WriteLine(m1)
               End If
            Else
               Console.WriteLine(m2, ch, x)
            End If
         Catch e As OverflowException
            Console.WriteLine("{0} Value read = {1}.", e.Message, x)
            ch = Char.MinValue
            Console.WriteLine(m1)
         End Try
      Loop While ch <> "+"c
   End Sub
End Class
'
'This example produces the following results:
'
'Type a string of text then press Enter. Type '+' anywhere in the text to quit:
'
'The quick brown fox.
'Character 'T' is hexadecimal 0x0054.
'Character 'h' is hexadecimal 0x0068.
'Character 'e' is hexadecimal 0x0065.
'Character     is hexadecimal 0x0020.
'Character 'q' is hexadecimal 0x0071.
'Character 'u' is hexadecimal 0x0075.
'Character 'i' is hexadecimal 0x0069.
'Character 'c' is hexadecimal 0x0063.
'Character 'k' is hexadecimal 0x006b.
'Character     is hexadecimal 0x0020.
'Character 'b' is hexadecimal 0x0062.
'Character 'r' is hexadecimal 0x0072.
'Character 'o' is hexadecimal 0x006f.
'Character 'w' is hexadecimal 0x0077.
'Character 'n' is hexadecimal 0x006e.
'Character     is hexadecimal 0x0020.
'Character 'f' is hexadecimal 0x0066.
'Character 'o' is hexadecimal 0x006f.
'Character 'x' is hexadecimal 0x0078.
'Character '.' is hexadecimal 0x002e.
'Character     is hexadecimal 0x000d.
'Character     is hexadecimal 0x000a.
'
'Type a string of text then press Enter. Type '+' anywhere in the text to quit:
'
'^Z
'Value was either too large or too small for a character. Value read = -1.
'
'Type a string of text then press Enter. Type '+' anywhere in the text to quit:
'
'+
'Character '+' is hexadecimal 0x002b.
'

注釈

メソッド Read は、入力文字を入力するときに戻り値をブロックします。キーを押すと終了 Enter します。 Enter キーを押すと、プラットフォームに依存する行終端シーケンスが入力に追加されます (たとえば、Windows改行シーケンスが追加されます)。 後続の メソッドの呼び Read 出しでは、一度に 1 文字の入力が取得されます。 最後の文字が取得された後、 は戻 Read り値を再度ブロックし、サイクルを繰り返します。

重要

メソッド ReadLine 、または プロパティと KeyAvailable メソッドは、 メソッド ReadKey を使用する方が望 Read ましいです。

次のいずれかのアクションを実行しない限り、 メソッドは -1 を返さ "ない" 点に注意してください。

  • 修飾子キーとコンソール キー (Ctrl + Z) を同時に押すと、ファイルの終わりの Control Z 状態が示されます。

  • ファイルの末尾の条件を示す同等のキーを押します (ファイルの F6 関数キーなどWindows。

  • 入力ストリームを、実際のファイル末尾文字を持つテキスト ファイルなどのソースにリダイレクトします。

適用対象

こちらもご覧ください