使用英语阅读

通过

Console.CursorTop 属性

  • 参考

定义

命名空间:
System
程序集:
System.Console.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll
Source:
Console.cs
Source:
Console.cs
Source:
Console.cs

获取或设置光标在缓冲区中的行位置。

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public static int CursorTop { get; set; }
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static int CursorTop { get; set; }
public static int CursorTop { get; set; }

属性值

Int32

光标的当前位置，以行为单位。

属性
UnsupportedOSPlatformAttribute

例外

ArgumentOutOfRangeException

集运算中的值小于零。

- 或 -

集运算中的值大于或等于 BufferHeight。

SecurityException

用户没有执行此操作的权限。

IOException

出现 I/O 错误。

示例

此示例演示 和 CursorLeftCursorTop 属性以及 SetCursorPosition 和 Clear 方法。 该示例定位光标（确定下一次写入的位置），以使用“+”、“|”和“-”字符串的组合绘制一个 5 字符乘以 5 个字符的矩形。 请注意，可以使用其他字符串的组合以更少的步骤绘制矩形。

// This example demonstrates the
//     Console.CursorLeft and
//     Console.CursorTop properties, and the
//     Console.SetCursorPosition and
//     Console.Clear methods.
using System;

class Sample
{
    protected static int origRow;
    protected static int origCol;

    protected static void WriteAt(string s, int x, int y)
    {
    try
        {
        Console.SetCursorPosition(origCol+x, origRow+y);
        Console.Write(s);
        }
    catch (ArgumentOutOfRangeException e)
        {
        Console.Clear();
        Console.WriteLine(e.Message);
        }
    }

    public static void Main()
    {
// Clear the screen, then save the top and left coordinates.
    Console.Clear();
    origRow = Console.CursorTop;
    origCol = Console.CursorLeft;

// Draw the left side of a 5x5 rectangle, from top to bottom.
    WriteAt("+", 0, 0);
    WriteAt("|", 0, 1);
    WriteAt("|", 0, 2);
    WriteAt("|", 0, 3);
    WriteAt("+", 0, 4);

// Draw the bottom side, from left to right.
    WriteAt("-", 1, 4); // shortcut: WriteAt("---", 1, 4)
    WriteAt("-", 2, 4); // ...
    WriteAt("-", 3, 4); // ...
    WriteAt("+", 4, 4);

// Draw the right side, from bottom to top.
    WriteAt("|", 4, 3);
    WriteAt("|", 4, 2);
    WriteAt("|", 4, 1);
    WriteAt("+", 4, 0);

// Draw the top side, from right to left.
    WriteAt("-", 3, 0); // shortcut: WriteAt("---", 1, 0)
    WriteAt("-", 2, 0); // ...
    WriteAt("-", 1, 0); // ...
//
    WriteAt("All done!", 0, 6);
    Console.WriteLine();
    }
}
/*
This example produces the following results:

+---+
|   |
|   |
|   |
+---+

All done!

*/

适用于

产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1